This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author flox
Recipients englabenny, flox, georg.brandl, pitrou
Date 2009-12-02.14:37:27
SpamBayes Score 8.897571e-09
Marked as misclassified No
Message-id <1259764653.34.0.568646344512.issue7417@psf.upfronthosting.co.za>
In-reply-to
Content
Ulrik,

I agree that most builtins have the signature on first lines.
I will not apply this part of the PEP257.

But it seems that the "[...]" syntax is not enforced for all builtins.
See "help(print)", "help(sorted)" and "help(__import__)" examples:

>>> print(print.__doc__)
print(value, ..., sep=' ', end='\n', file=sys.stdout)

Prints the values to a stream, or to sys.stdout by default.
Optional keyword arguments:
file: a file-like object (stream); defaults to the current sys.stdout.
sep:  string inserted between values, default a space.
end:  string appended after the last value, default a newline.

>>> print(sorted.__doc__)
sorted(iterable, key=None, reverse=False) --> new sorted list

>>> print(__import__.__doc__)
__import__(name, globals={}, locals={}, fromlist=[], level=-1) -> module

Import a module.  The globals are only used to determine the context;
they are not modified...



Patch is updated.
History
Date User Action Args
2009-12-02 14:37:33floxsetrecipients: + flox, georg.brandl, pitrou, englabenny
2009-12-02 14:37:33floxsetmessageid: <1259764653.34.0.568646344512.issue7417@psf.upfronthosting.co.za>
2009-12-02 14:37:28floxlinkissue7417 messages
2009-12-02 14:37:27floxcreate