Document `argparse.ArgumentParser.parse_args` order guarantee

[pdgendt]

Feature or enhancement

Proposal:

See the linked discourse discussion for full details, TLDR:

The parse_args doc says " args - List of strings to parse. …" The proposal is to add something like ‘, in normal order’ to the end of the sentence.

Has this already been discussed elsewhere?

I have already discussed this feature proposal on Discourse

Links to previous discussion of this feature:

https://discuss.python.org/t/argparse-multiple-arguments-with-the-same-destination-left-to-right-order-guarantee/105685/13

Linked PRs

• gh-143860: Clarify argparse.parse_args argument order #143862
• gh-143860: Clarify argparse.parse_args argument order #143863

[hugovk]

"in normal order" doesn't say much to me, can you propose alternative wording?