Issue #9343: Document that argparse parent parsers must be configured before their children.

2011-03-26 21:49:00 +01:00 · 2011-03-26 21:49:00 +01:00 · d186f99d00
parent d8ad68f34c
commit d186f99d00
2 changed files with 8 additions and 0 deletions
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@ -351,6 +351,11 @@ Note that most parent parsers will specify ``add_help=False``.  Otherwise, the
 :class:`ArgumentParser` will see two ``-h/--help`` options (one in the parent
 and one in the child) and raise an error.

+.. note::
+   You must fully initialize the parsers before passing them via ``parents=``.
+   If you change the parent parsers after the child parser, those changes will
+   not be reflected in the child.
+

 formatter_class
 ^^^^^^^^^^^^^^^
--- a/Misc/NEWS
+++ b/Misc/NEWS
@ -162,6 +162,9 @@ Library

 - Issue #8982: Improve the documentation for the argparse Namespace object.

+- Issue #9343: Document that argparse parent parsers must be configured before
+  their children.
+
 Build
 -----