[issue7229] Manual entry for time.daylight can be misleading
Tomas Kubes mr_na...@centrum.cz added the comment: I am sorry, but as an original initiator of the the issue I find the argumentation of Alexander Belopolsky vastly ridiculous. Are you really seriously convinced that an average person responsible for Python application development and maintenance would be aware of a necessity to look for an ANSI C documentation to find a description and definitions of time functions? You sound like Marie Antoinette who replied to peasants complaining the they do not have any bread to eat that they should eat brioches instead. Maybe in the context of the “royal programmers family” documentation to ANSI C is wildly known and even memorized, but I do insist that Python documentation should be accessible and understandable even to ordinary peasants of the computer kingdom. And I keep my case that the current description might trick programmers to think that it holds information whether the summer time currently applies rather than just plain information about current time zone being able to use summer time. Regards Tomas -- status: pending - open ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue7229 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue7229] Manual entry for time.daylight can be misleading
Tomas Kubes mr_na...@centrum.cz added the comment: Hello, I find this version very clear. Thanks Tomas -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue7229 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue7229] Manual entry for time.daylight can be misleading
Tomas Kubes mr_na...@centrum.cz added the comment: why do you think someone reading about time.daylight actually wants to check if DST is currently active? If you are not familiar with the cryptic names of POSIX but live in normal world, time.daylight sounds like a quite probable place where to check if the daylight savings are active. That's why I think the help text should explicitely note it has other meaning. You should try to think like a person that does not have any background knowledge of underlying libraries but just looks through the time library trying to solve the question - how can I check if my machine uses daylight savings now. Regards Tomas -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue7229 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue7229] Manual entry for time.daylight can be misleading
Tomas Kubes mr_na...@centrum.cz added the comment: I think you are confusing the purposes of a reference manual with that of a tutorial or an FAQ collection. There is a fine line between them. Even though reference manual should not be a substitute for a tutorial, I still believe it should try to clarify potential confusions - after all it is the less experienced users who will most likely spend their time with it looking for something. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue7229 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue7229] Manual entry for time.daylight can be misleading
New submission from Tomas Kubes mr_na...@centrum.cz: Hello, it is not obvious that the time.daylight data item reports nonzero values even when DST is currently not being used (ie. in winter) but the active timezone has DST defined for some other parts of the year. Current manual entry can be misleadingly interpreted that time.daylight acts as a current DST idicator (which it does not). Suggested FIX: Add a sentence: This value does not idicate that DST is currently active, but rather describes that current timezone can have DST. Use localtime() dst flag to determine if DST applies to the given time. Tomas -- assignee: georg.brandl components: Documentation messages: 94621 nosy: georg.brandl, napik severity: normal status: open title: Manual entry for time.daylight can be misleading type: feature request versions: Python 2.4, Python 2.5, Python 2.6, Python 2.7, Python 3.0, Python 3.1, Python 3.2 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue7229 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com