<div dir="ltr">Over on python-ideas, someone is/was proposing literals for timedeltas.<div><br></div><div>I don't expect that will come to anything, but it did make me take a look at the docstring for <font face="monospace, monospace">datetime.timedelta</font>. I use iPython's ? a lot for a quick overview of how to use a class/function. </div><div><br></div><div>This is what I get:</div><div><br></div><font face="monospace, monospace">In [8]: timedelta?<br>Init signature: timedelta(self, /, *args, **kwargs)<br>Docstring:      Difference between two datetime values.<br>File:           ~/miniconda2/envs/py3/lib/python3.6/datetime.py<br>Type:           type<br><br><br></font>That is, well, not so useful. I'd like to see at least the signature:<div><br></div><div><font face="monospace, monospace">datetime.timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0</font><br><div><font face="monospace, monospace"><br></font></div><div>And ideally much of the text in the docs.</div><div><br></div><div>I've noticed similarly minimal docstrings on a number of builtin functions and methods.</div><div><br></div><div>If I wanted to contribute a PR to enhance these docstrings, where would they go?  I've seen mention of "argument clinic", but really don't know quite what that is, or how it works, but it appears to be related.</div><div><br></div><div>Anyway -- more comprehensive docstrings on buildins could really help Python's usability for command line usage.</div><div><br></div><div>Thanks,</div><div>-  Chris</div><div><br></div><div><br><div><br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><br>Christopher Barker, Ph.D.<br>Oceanographer<br><br>Emergency Response Division<br>NOAA/NOS/OR&R            (206) 526-6959   voice<br>7600 Sand Point Way NE   (206) 526-6329   fax<br>Seattle, WA  98115       (206) 526-6317   main reception<br><br><a href="mailto:Chris.Barker@noaa.gov" target="_blank">Chris.Barker@noaa.gov</a></div>
</div></div></div></div>