From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp-out-no.shaw.ca (smtp-out-no.shaw.ca [64.59.134.12]) by sourceware.org (Postfix) with ESMTPS id 365BE3857815 for ; Tue, 25 Aug 2020 12:57:24 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 365BE3857815 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=SystematicSW.ab.ca Authentication-Results: sourceware.org; spf=none smtp.mailfrom=brian.inglis@systematicsw.ab.ca Received: from BWINGLISD.cg.shawcable.net ([24.64.172.44]) by shaw.ca with ESMTP id AYVtkhGx8ng7KAYVvky6TA; Tue, 25 Aug 2020 06:57:23 -0600 X-Authority-Analysis: v=2.3 cv=ecemg4MH c=1 sm=1 tr=0 a=kiZT5GMN3KAWqtYcXc+/4Q==:117 a=kiZT5GMN3KAWqtYcXc+/4Q==:17 a=I0CVDw5ZAAAA:8 a=2vgJobJ0UVLQsd_972UA:9 a=YdXdGVBxRxTCRzIkH2Jn:22 From: Brian Inglis To: cygwin-patches@cygwin.com Subject: [PATCH v2 3/3] winsup/doc/faq-api.xml(faq.api.timezone): explain time zone updates Date: Tue, 25 Aug 2020 06:57:15 -0600 Message-Id: <20200825125715.48238-4-Brian.Inglis@SystematicSW.ab.ca> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20200825125715.48238-1-Brian.Inglis@SystematicSW.ab.ca> References: <20200825125715.48238-1-Brian.Inglis@SystematicSW.ab.ca> MIME-Version: 1.0 Reply-To: cygwin-patches@cygwin.com Content-Transfer-Encoding: 8bit X-CMAE-Envelope: MS4wfHMzJDzRlUiWiq3xgQb+WeF/jIvK8qxWRGRB2hbQctnY+qzHHxUzkyhRtRmdJmBt3IZtRMLVuumsIXo9KPWzHDfPBgx8aGxQmmdwWb0G9ublJ2iB7BtG KDVfWA05u9UvepQmKjyf28Rymd39BJ59LJ4cazYM0MoWIlc4ZECCOxfiYUoM9lESxvVA5LRcTCyR3ojzA1XMjqsYznk82n2LiaIU1TcKN3RxT55ciAxSJX18 yr62Z+x+hxTfa3s5xBoSKQ== X-Spam-Status: No, score=-12.3 required=5.0 tests=BAYES_00, GIT_PATCH_0, KAM_DMARC_STATUS, KAM_LAZY_DOMAIN_SECURITY, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: cygwin-patches@cygwin.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Cygwin core component patch submission and discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 25 Aug 2020 12:57:25 -0000 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 -Why isn't timezone set correctly? +Why isn't time zone set correctly? -(Please note: This section has not yet been updated for the latest net release.) - -Did you explicitly call tzset() before checking the value of timezone? +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. +Have you run the Cygwin Setup program recently to update at least the +tzdata +package to include the latest current daylight saving (summer time) rules +for dates of changes, hour offsets from UTC of time zones, and the +geographic regions to which those rules and offsets apply. + +These changes are decided on by politicians, and announced +by government officials, sometimes with short or no notice, so +tzdata +package updates are released at least a few, and sometimes several, +times a year. +As details of changes are not known until they are announced publicly by +officials, often in foreign languages, and those details then have to be +noticed, possibly translated, passed to, and picked up by the official +tzdata +source package maintainers, subsequently released in an update to the +tzdata +source package, and then those changes have to be picked up on and applied +to the Cygwin +tzdata +package, which has to be updated, built, tested, and released publicly. -- 2.28.0