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 forest, paul.j3, rhettinger
Date 2021-09-06.03:11:16
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1630897876.57.0.16019160412.issue45110@roundup.psfhosted.org>
In-reply-to
Content
I don't agree this should be changed.  The repetition helps improve understanding because not everyone would assume that a METAVAR shown once would automatically also apply to its long form.   

Also, showing the METAVAR more than one is a norm.  For example, see this excerpt from "man grep":

     -B num, --before-context=num
             Print num lines of leading context before each match.  See also the -A and -C options.

     -b, --byte-offset
             The offset in bytes of a matched pattern is displayed in front of the respective matched line.

     -C[num, --context=num]
             Print num lines of leading and trailing context surrounding each match.  The default is 2 and is equivalent to
             -A 2 -B 2.  Note: no whitespace may be given between the option and its argument.

     -c, --count
             Only a count of selected lines is written to standard output.

     --colour=[when, --color=[when]]
             Mark up the matching text with the expression stored in GREP_COLOR environment variable.  The possible values of
             when can be `never', `always' or `auto'.

     -D action, --devices=action
             Specify the demanded action for devices, FIFOs and sockets.  The default action is `read', which means, that
             they are read as if they were normal files.  If the action is set to `skip', devices will be silently skipped.

     -d action, --directories=action
             Specify the demanded action for directories.  It is `read' by default, which means that the directories are read
             in the same manner as normal files.  Other possible values are `skip' to silently ignore the directories, and
             `recurse' to read them recursively, which has the same effect as the -R and -r option.
History
Date User Action Args
2021-09-06 03:11:16rhettingersetrecipients: + rhettinger, forest, paul.j3
2021-09-06 03:11:16rhettingersetmessageid: <1630897876.57.0.16019160412.issue45110@roundup.psfhosted.org>
2021-09-06 03:11:16rhettingerlinkissue45110 messages
2021-09-06 03:11:16rhettingercreate