anatoly techtonik <techto...@gmail.com> added the comment: > Documenting utcoffset() as "Return timedelta equal to local UTC > offset." is almost circular. It does not explain whether it has to be > added or subtracted from UTC to arrive at local time.
Ok. Sold. >> I believe the correct convention is "Return timedelta...". > > This is handled inconsistently in the documentation; I'm hoping the > current maintainers reinforce the "Returns ..." structure. The > documentation is descriptive, not an external specification. http://www.python.org/dev/peps/pep-0257/#one-line-docstrings I've took the convention from here. I thought docs are generated from docstrings. ---------- _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue9305> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
