homepage

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 dlam
Recipients dlam, docs@python, eli.bendersky, ezio.melotti, serhiy.storchaka, tshepang
Date 2013年01月24日.19:39:26
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1359056367.32.0.437945018876.issue16954@psf.upfronthosting.co.za>
In-reply-to
Content
I had an innocent question about the format to use when listing function arguments in docstrings. In the PEP 257 doc, there's a single example:
 def complex(real=0.0, imag=0.0):
 """Form a complex number.
 Keyword arguments:
 real -- the real part (default 0.0)
 imag -- the imaginary part (default 0.0)
I went digging through Lib/ for a good example to follow, but felt a little unsure because the exact format seemed to differ ever so slightly sometimes.
Like in ipaddress.py, a colon is used instead of two hyphens, and it's indented:
 def ip_address(address):
 """Take an IP string/int and return an object of the correct type.
 Args:
 address: A string or integer, the IP address. Either IPv4 or
 IPv6 addresses may be supplied; integers less than 2**32 will
 be considered to be IPv4 by default.
Is there an "ideal" example in the source to try to copy? 
(or maybe this is just a use-your-common-sense thing)
History
Date User Action Args
2013年01月24日 19:39:27dlamsetrecipients: + dlam, ezio.melotti, eli.bendersky, docs@python, tshepang, serhiy.storchaka
2013年01月24日 19:39:27dlamsetmessageid: <1359056367.32.0.437945018876.issue16954@psf.upfronthosting.co.za>
2013年01月24日 19:39:27dlamlinkissue16954 messages
2013年01月24日 19:39:26dlamcreate

AltStyle によって変換されたページ (->オリジナル) /