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

[Corinna Vinschen]

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.


Corinna