[issue22738] improve sys.argv, 'python -h' documentation

2014-10-27 Thread Ethan Furman

Changes by Ethan Furman et...@stoneleaf.us:


--
nosy: +ethan.furman

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue22738
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue22738] improve sys.argv, 'python -h' documentation

2014-10-27 Thread R. David Murray

R. David Murray added the comment:

I don't understand how your suggested change would affect the font size issue 
(nor do I really understand it as a sentence).

For your second suggestion (which is unrelated), how about instead:

 -c str   : interpret str as a program (terminates option list)

That would make the phrasing more consistent with the text for the other 
options.

--
nosy: +r.david.murray

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue22738
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue22738] improve sys.argv, 'python -h' documentation

2014-10-27 Thread Van Ly

Van Ly added the comment:

The font choice is a matter of style beyond me. I commented on it as I saw it. 
The second rendering looks in Capital relative to the first rendering. The 
problem wasn't there in v.2.7.5. In saying that, perhaps the information would 
be picked up by someone knowledgeable about the style sheet.

The focus of the suggestion is in the head line about the wording. I chose 
'feed' because it would align with the theme of python and pickling. 
'interpret' isn't as nice a picture word.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue22738
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue22738] improve sys.argv, 'python -h' documentation

2014-10-26 Thread Van Ly

New submission from Van Ly:

I was looking at sys.argv from the reference guide. 

The font mix and change from v.2.7.5 to v.3.5.0a0 for sentence two of sys.argv 
(library/sys.html#module-sys) has made the second rendering of -c look capital 
when in fact it isn't.

--quote: from v.3.5.0a0 at library/sys.html#module-sys
If the command was executed using the -c command line option to the 
interpreter, argv[0] is set to the string '-c'.
--quote--

--suggest: improve second sentence of sys.argv (v.2.7.5, v.3.5.0a0)
Call the Python interpreter with the option, -c str, and the value of argv[0] 
is '-c'.
--suggest--

--suggest: improve 'python -h' output
-c str : feed in a string as program (terminates option list)
--suggest--

--
assignee: docs@python
components: Documentation
messages: 230059
nosy: docs@python, vy0123
priority: normal
severity: normal
status: open
title: improve sys.argv, 'python -h' documentation
type: enhancement
versions: Python 2.7, Python 3.5

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue22738
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com