[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