Re: [Python-Dev] subprocess docs patch

2010-02-01 Thread Martin v. Löwis
 Any help you could provide would be appreciated.

Please use unified diffs in the future.

I'm -0 on this patch; it still has the negative, cautionary-patronizing
tone (Do not, can be tricky, be mindful), as if readers are unable
to grasp the description that they just read (and indeed, in the patch,
you claim that readers *are* unable to understand how command lines
work). I know that Raymond Hettinger is very much opposed to this style
of documentation. So I, whose native language is not English, cannot
approve/apply this patch. Try convincing Raymond.

Regards,
Martin
___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] subprocess docs patch

2010-02-01 Thread Chris Rebert
On Mon, Feb 1, 2010 at 12:14 AM, Martin v. Löwis mar...@v.loewis.de wrote:
 Any help you could provide would be appreciated.

 Please use unified diffs in the future.

Duly noted.

 I'm -0 on this patch; it still has the negative, cautionary-patronizing
 tone (Do not, can be tricky, be mindful),

Thanks to yours and other feedback, I've tried to address this in a
newer version of the patch.

 as if readers are unable
 to grasp the description that they just read (and indeed, in the patch,
 you claim that readers *are* unable to understand how command lines
 work).

I don't think I made any statement quite that blunt; however, as the
c.l.p threads that drove me to write this patch show, there are indeed
some people who don't (correctly) understand the details of command
line tokenization.

Thanks for responding!

Cheers,
Chris
___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


[Python-Dev] subprocess docs patch

2010-01-31 Thread Chris Rebert
Hello mighty Python developers,

I was wondering if someone could take a gander at, and hopefully act
upon, a patch I submitted a while ago for the subprocess module's
docs.
It's been languishing in the bug tracker:

http://bugs.python.org/issue6760

Any help you could provide would be appreciated.

Cheers,
Chris
--
If life seems jolly rotten. There's something you've forgotten.
And that's to laugh and smile and dance and sing.
___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com