[Python-checkins] r69777 - in python/trunk/Doc:howto/doanddont.rst howto/webservers.rstincludes/sqlite3/adapter_datetime.py library/asyncore.rstlibrary/cgi.rst library/configparser.rstlibrary/cookielib.rst library/crypt.rst library/csv.rst li

[Georg Brandl]

Jeroen Ruigrok van der Werven schrieb:
> -On [20090220 06:17], Guido van Rossum (guido at python.org) wrote:
>>I guess we don't, though maybe you can ask him (as a regular
>>contributor) to subscribe. In any case, I've CC'ed Jeroen on this
>>message!
> 
> I am not actually subscribed to it. Should be fixed shortly.
> 
>>>>> On Thu, Feb 19, 2009 at 12:05 PM, A.M. Kuchling <amk at amk.ca> wrote:
>>>>>>
>>>>>> I disagree with this change because it makes examples longer,
>>>>>> but the extra length is not contributing anything interesting.
>>>>>> For example, look at the example in the difflib docs:
> 
> Prior to checking it in I discussed it with Georg for what it is worth. My
> commit was merely trying to get some consistency into the diverse examples,
> which in my experience tends to make things easier for people using the
> documentation. But it is not like I will defend said change with tooth and
> nail. So what will it be?

Well, you heard the authorities :)

I had the feeling that following PEP 8 in our examples would be good; but I
can see that brevity is also a virtue here.

Georg

-- 
Thus spake the Lord: Thou shalt indent with four spaces. No more, no less.
Four shall be the number of spaces thou shalt indent, and the number of thy
indenting shall be four. Eight shalt thou not indent, nor either indent thou
two, excepting that thou then proceed to four. Tabs are right out.