Would you be able to submit a patch to address the docstring issues? --Guido (mobile) On Dec 21, 2015 2:09 PM, "Chris Barker" <chris.bar...@noaa.gov> wrote:
> On Sun, Dec 20, 2015 at 2:28 PM, Chris Angelico <ros...@gmail.com> wrote: > >> >> Would there be value in changing the repr to use keyword arguments? >> > > this thread got long, but it sounds like that won't be worth the backwards > compatibility... > > >> Worse, help(datetime.timedelta) in 3.6 doesn't document the >> constructor at all. There's no mention of __init__ at all, __new__ has >> this useless information: >> > > but this seems to have gotten lost in the shuffle. > > and aside from there being three data descriptors, there's nothing to >> suggest that you construct these things with timedelta(days, seconds, >> microseconds). Definitely no indication that you can use other keyword >> args. >> >> Is this something worth fixing, or is it acceptable to drive people to >> fuller documentation than help()? >> > > Absolutlye worht fixing! maybe it' sjsut my weird workflow, but I find it > very, very useful to use iPython's ? : > > In [10]: datetime.timedelta? > Docstring: Difference between two datetime values.File: > ~/miniconda2/lib/python2.7/lib-dynload/datetime.so > Type: type > > and there are a LOT of next-to worthless docstrings in the stdlib -- it > would be nice to clean them all up. > > Is there any reason not to, other than someone having to do the work? > > -Chris > > > > -- > > Christopher Barker, Ph.D. > Oceanographer > > Emergency Response Division > NOAA/NOS/OR&R (206) 526-6959 voice > 7600 Sand Point Way NE (206) 526-6329 fax > Seattle, WA 98115 (206) 526-6317 main reception > > chris.bar...@noaa.gov > > _______________________________________________ > Python-Dev mailing list > Python-Dev@python.org > https://mail.python.org/mailman/listinfo/python-dev > Unsubscribe: > https://mail.python.org/mailman/options/python-dev/guido%40python.org > >
_______________________________________________ Python-Dev mailing list Python-Dev@python.org https://mail.python.org/mailman/listinfo/python-dev Unsubscribe: https://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com