Message 231955 - Python tracker

➜

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	belopolsky
Recipients	akira, belopolsky, cvrebert, docs@python
Date	2014-12-01.21:32:52
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1417469572.79.0.885593324312.issue22356@psf.upfronthosting.co.za>
In-reply-to

Content
I don't like the proposed note. 1. It is not the job of the time module documentation to warn about "many functions in the stdlib." What are these functions, BTW? 2. What is "calendar time in POSIX encoding"? This sounds like what time.asctime() returns. I think an improvement would be to spell Epoch with a capital E and define it as "The time zero hours, zero minutes, zero seconds, on January 1, 1970 Coordinated Universal Time (UTC)." See <http://pubs.opengroup.org/onlinepubs/9699919799>.

I don't like the proposed note.

1. It is not the job of the time module documentation to warn about "many functions in the stdlib."  What are these functions, BTW?

2. What is "calendar time in POSIX encoding"? This sounds like what time.asctime() returns.

I think an improvement would be to spell Epoch with a capital E and define it as "The time zero hours, zero minutes, zero seconds, on January 1, 1970 Coordinated Universal Time (UTC)."  See <http://pubs.opengroup.org/onlinepubs/9699919799>.

History
Date	User	Action	Args
2014-12-01 21:32:52	belopolsky	set	recipients: + belopolsky, cvrebert, docs@python, akira
2014-12-01 21:32:52	belopolsky	set	messageid: <1417469572.79.0.885593324312.issue22356@psf.upfronthosting.co.za>
2014-12-01 21:32:52	belopolsky	link	issue22356 messages
2014-12-01 21:32:52	belopolsky	create