[PATCH v2 3/3] winsup/doc/faq-api.xml(faq.api.timezone): explain time zone updates

Brian Inglis Brian.Inglis@SystematicSw.ab.ca
Thu Aug 27 07:33:44 GMT 2020

On 2020-08-26 02:16, Corinna Vinschen wrote:
> On Aug 25 06:57, Brian Inglis wrote:
>> based on material from tz@IANA.org mailing list sources
>> ---
>>  winsup/doc/faq-api.xml | 29 +++++++++++++++++++++++++----
>>  1 file changed, 25 insertions(+), 4 deletions(-)
>> diff --git a/winsup/doc/faq-api.xml b/winsup/doc/faq-api.xml
>> index 829e4d7febd8..365e301555a5 100644
>> --- a/winsup/doc/faq-api.xml
>> +++ b/winsup/doc/faq-api.xml
>> @@ -385,13 +385,34 @@ Cygwin version number details, check out the
>>  </answer></qandaentry>
>>  <qandaentry id="faq.api.timezone">
>> -<question><para>Why isn't timezone set correctly?</para></question>
>> +<question><para>Why isn't time zone set correctly?</para></question>
>>  <answer>
>> -<para><emphasis role='bold'>(Please note: This section has not yet been updated for the latest net release.)</emphasis>
>> -</para>
>> -<para>Did you explicitly call tzset() before checking the value of timezone?
>> +<para>Did you explicitly call tzset() before checking the value of time zone?
>>  If not, you must do so.
>> +Time zone settings are updated by changes to the tzdata package included in all
>> +Cygwin installations.
> Shouldn't a new paragraph start at this point?
> Actually, maybe this could be changed a bit more.  The question might be
> better called "Why isn't my (or the) time zone set correctly?" and the
> order inside the FAQ seems a bit upside down now.  Starting with a reply
> only affecting developers with self-written applications is rather weird
> given the general discussion only follows afterwards.
> The discussion on how time zones are updated in real life might be the
> better start, then how to rectify local settings by running Setup, and
> only then implications for developers.
> Make sense?
> Thanks, I pushed the other two patches in the meantime.

Thanks, changed as suggested: have a look and feel free to tweak minor nits or
bounce back if more issues.

Getting better with git due to this intense pressure! ;^>
Still easier to hack patches and reapply than figure out how to mess around with
them using git.

Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

This email may be disturbing to some readers as it contains
too much technical detail. Reader discretion is advised.
[Data in IEC units and prefixes, physical quantities in SI.]

More information about the Cygwin-patches mailing list