[Python-Dev] Style guide for FAQs?

2011-12-03 Thread Antoine Pitrou
Hello, I notice that some FAQs are not only outdated but seem to favour a writing style that's quite lengthy and full of anecdotal details. It seems to me that there is value in giving terse answers in FAQs (we have - or should have - reference documentation where things are explained in more det

Re: [Python-Dev] Style guide for FAQs?

2011-12-03 Thread Antoine Pitrou
On Sat, 3 Dec 2011 21:39:03 +0100 Antoine Pitrou wrote: > > One primary example is the performance question: > file:///home/antoine/cpython/32/Doc/build/html/faq/programming.html#my-program-is-too-slow-how-do-i-speed-it-up Woohoo. This should of course be: http://docs.python.org/dev/faq/programm

Re: [Python-Dev] Style guide for FAQs?

2011-12-03 Thread Terry Reedy
On 12/3/2011 3:58 PM, Antoine Pitrou wrote: On Sat, 3 Dec 2011 21:39:03 +0100 Antoine Pitrou wrote: One primary example is the performance question: file:///home/antoine/cpython/32/Doc/build/html/faq/programming.html#my-program-is-too-slow-how-do-i-speed-it-up Woohoo. This should of course b

Re: [Python-Dev] [Python-checkins] cpython (3.2): Issue #13211: Add .reason attribute to HTTPError to implement parent class

2011-12-03 Thread Nick Coghlan
On Sun, Dec 4, 2011 at 12:46 AM, jason.coombs wrote: > +def test_HTTPError_interface(): > +    """ > +    Issue 13211 reveals that HTTPError didn't implement the URLError > +    interface even though HTTPError is a subclass of URLError. > + > +    >>> err = urllib.error.HTTPError(msg='something ba