[Python-Dev] [Python-checkins] cpython (2.7): Fix a few hyphens in argparse.rst.

Éric Araujo merwok at netwok.org
Tue Apr 19 17:48:33 CEST 2011


 Hi,

> summary:
>   Fix a few hyphens in argparse.rst.

> -   :synopsis: Command-line option and argument parsing library.
> +   :synopsis: Command-line option and argument-parsing library.

 I believe that change should be reverted.  “argument parsing library” 
 is
 a noun determined (qualified) by another noun itself determined by a
 noun, not by an adjective.

> -  followed by zero or one command-line args.  When parsing the 
> command-line, if
> +  followed by zero or one command-line args.  When parsing the 
> command line, if

 You changed “arg” to “argument” in one place but not throughout.  I
 think it’s best to use only full words in the docs (and for names in
 code, as recommended by PEP 8 :).

 Regards


More information about the Python-Dev mailing list