summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorSavannah Ostrowski <savannahostrowski@gmail.com>2024-11-24 15:20:37 (GMT)
committerGitHub <noreply@github.com>2024-11-24 15:20:37 (GMT)
commit2104bde572aa60f547274fd529312c5708599001 (patch)
treeb2b9b780f16cf1bfe394ba59f5afcdc647b6c434 /Doc/library
parentf7bb658124aba74be4c13f498bf46cfded710ef9 (diff)
downloadcpython-2104bde572aa60f547274fd529312c5708599001.zip
cpython-2104bde572aa60f547274fd529312c5708599001.tar.gz
cpython-2104bde572aa60f547274fd529312c5708599001.tar.bz2
GH-127133: Remove ability to nest argument groups & mutually exclusive groups (#127186)
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/argparse.rst19
1 files changed, 9 insertions, 10 deletions
diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index 410b6e1..da4071d 100644
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -1926,11 +1926,10 @@ Argument groups
Note that any arguments not in your user-defined groups will end up back
in the usual "positional arguments" and "optional arguments" sections.
- .. versionchanged:: 3.11
- Calling :meth:`add_argument_group` on an argument group is deprecated.
- This feature was never supported and does not always work correctly.
- The function exists on the API by accident through inheritance and
- will be removed in the future.
+ .. deprecated-removed:: 3.11 3.14
+ Calling :meth:`add_argument_group` on an argument group now raises an
+ exception. This nesting was never supported, often failed to work
+ correctly, and was unintentionally exposed through inheritance.
.. deprecated:: 3.14
Passing prefix_chars_ to :meth:`add_argument_group`
@@ -1993,11 +1992,11 @@ Mutual exclusion
--foo FOO foo help
--bar BAR bar help
- .. versionchanged:: 3.11
- Calling :meth:`add_argument_group` or :meth:`add_mutually_exclusive_group`
- on a mutually exclusive group is deprecated. These features were never
- supported and do not always work correctly. The functions exist on the
- API by accident through inheritance and will be removed in the future.
+ .. deprecated-removed:: 3.11 3.14
+ Calling :meth:`add_argument_group` or :meth:`add_mutually_exclusive_group`
+ on a mutually exclusive group now raises an exception. This nesting was
+ never supported, often failed to work correctly, and was unintentionally
+ exposed through inheritance.
Parser defaults