homepage

This issue tracker has been migrated to GitHub , and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author rhettinger
Recipients Albert White, Jacktose, Martin.d'Anjou, Oliver.Smith, benschmaus, bethard, docs@python, eric.araujo, eric.smith, kkarbowiak, maggyero, markgrandi, martin.panter, mburger, paul.j3, r.david.murray, rhartkopf, rhettinger, shaharg, terry.reedy, tonygaetani, tshepang
Date 2020年12月19日.20:08:57
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1608408537.8.0.721378977862.issue9694@roundup.psfhosted.org>
In-reply-to
Content
Based on the attached survey of practices, I propose a minimal edit to the help display. Instead of "optional arguments:", we say "the options are as follows:".
The use of the word "option" is dominant is in the CLI world, followed by "action" and "switch". The noun form "option" doesn't seem to cause the same confusion that arises in the adjective form "optional arguments" which strongly implies "not required".
For the documentation, I suggest adding a sentence or two in the introduction to explain the terminology used throughout the rest of the argparse docs.
History
Date User Action Args
2020年12月19日 20:08:57rhettingersetrecipients: + rhettinger, terry.reedy, bethard, eric.smith, eric.araujo, r.david.murray, docs@python, benschmaus, tshepang, martin.panter, paul.j3, markgrandi, mburger, Martin.d'Anjou, Oliver.Smith, rhartkopf, Albert White, tonygaetani, shaharg, maggyero, Jacktose, kkarbowiak
2020年12月19日 20:08:57rhettingersetmessageid: <1608408537.8.0.721378977862.issue9694@roundup.psfhosted.org>
2020年12月19日 20:08:57rhettingerlinkissue9694 messages
2020年12月19日 20:08:57rhettingercreate

AltStyle によって変換されたページ (->オリジナル) /