At present, if a number (e.g. 2) of optional positional arguments
are defined (e.g. arg1 and arg2) argparse formats them as follows:
usage: program [arg1] [arg2]
in the usage message. I would like to suggest that a better format would be:
usage: program [arg1 [arg2]]
as this more accurately reflects the way argparse treats them during parsing of the command line.
This formatting would be consistent with the way argparse currently formats a single optional positional argument with nargs='*', namely:
usage: program [arg [arg ...]] |