Raymond Hettinger <raymond.hettin...@gmail.com> added the comment:

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.

----------
versions:  -Python 3.10, Python 3.6, Python 3.7, Python 3.8, Python 3.9

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue45110>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to