Mailing List Archive: Python: Dev

subprocess docs patch

Index | Next | Previous | View Threaded

clp2 at rebertia

Jan 31, 2010, 9:53 PM

Post #1 of 3 (581 views)
Permalink

subprocess docs patch

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 [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com

martin at v

Feb 1, 2010, 12:14 AM

Post #2 of 3 (534 views)
Permalink

Re: subprocess docs patch [In reply to]

> 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 [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com

clp2 at rebertia

Feb 1, 2010, 10:06 PM

Post #3 of 3 (517 views)
Permalink

Re: subprocess docs patch [In reply to]

On Mon, Feb 1, 2010 at 12:14 AM, "Martin v. Löwis" <martin [at] v> 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 [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com

Index | Next | Previous | View Threaded

Interested in having your list archived? Contact Gossamer Threads