Terry J. Reedy <tjre...@udel.edu> added the comment:

I can see how the current phrasing gives one pause, and might seem incomplete, 
but it is not incorrect.  The sense of

Additionally, users can run one of  ::
   <yourscript> -h
   <yourscript> --help
and optparse will ...

is "Additionally, users can run one of ``<yourscript> -h`` or ``<yourscript> 
--help`` and optparse will ...".  I personally prefer this running text form 
with in-line code markup to the block form.  What do you think?

If we keep the block form, I slightly prefer 'one of the following' to 'one of 
the next lines' but cannot say why.

----------
nosy: +terry.reedy

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

Reply via email to