[Python-checkins] r57353 - python/trunk/Lib/ntpath.py python/trunk/Lib/posixpath.py

[Georg Brandl]

Fred Drake schrieb:
> On Aug 23, 2007, at 5:27 PM, georg.brandl wrote:
>> Author: georg.brandl
>> Date: Thu Aug 23 23:27:57 2007
>> New Revision: 57353
> ...
>> Modified: python/trunk/Lib/ntpath.py
>> ====================================================================== 
>> ========
>> --- python/trunk/Lib/ntpath.py	(original)
>> +++ python/trunk/Lib/ntpath.py	Thu Aug 23 23:27:57 2007
> ...
>> -    """Join two or more pathname components, inserting "\\" as  
>> needed"""
>> +    """Join two or more pathname components, inserting "\\" as  
>> needed.
>> +    If any component is an absolute path, all previous path  
>> components
>> +    will be discarded."""
> 
> Shouldn't there be a blank line between the first and subsequent  
> lines of the docstring?

Not really, if you look at various other docstrings in the posixpath
module.

I'd only leave a blank line if the following text was a finer explanation
of what the first sentence said, IMO that's not the case 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.