[issue22738] improve 'python -h' documentation for '-c'

[Irit Katriel]

Irit Katriel  added the comment:

Closing as the discussion stalled about 7 years ago and was then leaning 
towards rejecting the suggestion.

--
nosy: +iritkatriel
resolution:  -> rejected
stage: needs patch -> resolved
status: open -> closed

___
Python tracker 

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

[issue22738] improve 'python -h' documentation for '-c'

[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 'python -h' documentation for '-c'

[Terry J. Reedy]

Terry J. Reedy added the comment:

On Win7, current Firefox, '-c' looks the same (definitely lowercase) for 2.7,8, 
3.4.2, and 3.5.0a0,

I agree both that the sys.argv entry should be left as is and that 'interpret' 
is better than 'feed' or the current verbiage.  I think 'cmd' should be left as 
is because it is more descriptive than the generic 'str' and because the latter 
implies to me that cmd must always (as opposed to often) be quoted, which is 
not true.  The result would be
  -c cmd : interpret cmd as a program (terminates option list)

For 3.5, the current line is repository\Modules\main.c: 55.  If we agree on the 
above, I am willing to make the patch and push it.

--
nosy: +terry.reedy
stage:  - needs patch
versions: +Python 3.4

___
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 'python -h' documentation for '-c'

[R. David Murray]

R. David Murray added the comment:

I am hard pressed to come up with anything useful you can do with the argument 
to -c without quoting it.

--

___
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 'python -h' documentation for '-c'

[Terry J. Reedy]

Terry J. Reedy added the comment:

Semi-useful: print a numeric expression without spaces
C:\Users\Terrypython -c print(2**50)
1125899906842624

Less useful: print a string expression without spaces or double quotes
C:\Users\Terrypython -c print('*'*50)
**

--

___
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 'python -h' documentation for '-c'

[R. David Murray]

R. David Murray added the comment:

Ah, I see.  Those don't work in my shell, since the '*' gets interpreted as a 
globbing character.  I didn't know it worked on Windows.

--

___
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 'python -h' documentation for '-c'

[R. David Murray]

R. David Murray added the comment:

Well, again, your suggested change for sys.argv is less optimal English.  The 
text as is seems fine to me.

'feed' is a term generally used when there is a source separate from the 
command (for example, we speak about a unix pipe feeding data from one command 
to the next).  A command line argument is not generally spoken about as being 
fed into the command.  And the relevance of pickle in this context completely 
escapes me.  Interpret programs is what Python does (Python is, after all, one 
of the class of programs referred to as an interpreter).

I thank you for your desire to improve the python documentation, but so far 
your suggestions have not been improvements.  It would probably be most helpful 
if you stick to pointing out places where you found the documentation 
confusing, explain your confusion as much as you can, and leave the writing of 
the improvements to the native English speakers.

--
title: improve sys.argv, 'python -h' documentation - improve  'python -h' 
documentation for '-c'

___
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 'python -h' documentation for '-c'

[Van Ly]

Van Ly added the comment:

I don't know what you mean by optimal English. As is, the English is of the 
native English speaker's comfy couch guides speaking to guides kind rather than 
guides speaking to audience wanting to be guided by. 

The suggestion I offered is imperfect and can be improved or rejected. As 
communication, it is shorter than the original and applies the dry principle, 
don't repeat yourself. Command occurs twice and the native English speaker may 
feel they are different in their senses. As sequence was in another suggestion 
for enhancement (and not a bug). 

You have your point of view which is from the internal technical guts of this 
language. I am approaching the language from the fun of Monty Python and 
imagery of a python pickled in a jar. I have done a few tutorials and read code 
with this reference guide as I would use a dictionary to explain words in a 
passage. I expect in a final stage of approval an editor ensures correctness of 
English to whatever the standard is.

--

___
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 'python -h' documentation for '-c'

[Van Ly]

Van Ly added the comment:

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

+1 (feed is shorter)

--

___
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