From 4ec2149708c7c06ebeccc27e28e2bbc51c4abeca Mon Sep 17 00:00:00 2001
From: "Miss Islington (bot)"
 <31488909+miss-islington@users.noreply.github.com>
Date: Tue, 22 Dec 2020 10:19:24 -0800
Subject: bpo-29030: Document interaction between *choices* and *metavar*.
 (GH-23884) (GH-23894)

---
 Doc/library/argparse.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index 1a298cd..4542961 100644
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -1152,6 +1152,11 @@ Any container can be passed as the *choices* value, so :class:`list` objects,
 Use of :class:`enum.Enum` is not recommended because it is difficult to
 control its appearance in usage, help, and error messages.
 
+Formatted choices overrides the default *metavar* which is normally derived
+from *dest*.  This is usually what you want because the user never sees the
+*dest* parameter.  If this display isn't desirable (perhaps because there are
+many choices), just specify an explicit metavar_.
+
 
 required
 ^^^^^^^^
-- 
cgit v0.12