From: Eli Zaretskii <eliz@gnu.org>
Date: Wed, 10 Apr 2024 13:52:21 +0000 (+0300)
Subject: ; Improve documentation of 'world-clock'
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=41ef1d49500e0b0f9e8e70922011ef49e71d3abe;p=emacs.git

; Improve documentation of 'world-clock'

* lisp/time.el (zoneinfo-style-world-list)
(legacy-style-world-list): Doc fixes.

(cherry picked from commit db7b571aaaf4aa16fc6a88a53a8740c3a102ce60)
---

diff --git a/lisp/time.el b/lisp/time.el
index a8d3ab9c813..b6f8de8fc4a 100644
--- a/lisp/time.el
+++ b/lisp/time.el
@@ -459,7 +459,11 @@ Each element has the form (TIMEZONE LABEL).
 TIMEZONE should be a string of the form AREA/LOCATION, where AREA is
 the name of a region -- a continent or ocean, and LOCATION is the name
 of a specific location, e.g., a city, within that region.
-LABEL is a string to display as the label of that TIMEZONE's time."
+LABEL is a string to display as the label of that TIMEZONE's time.
+
+This option has effect only on systems that support Posix-style
+zoneinfo files specified as CONTINENT/CITY.  In particular,
+MS-Windows doesn't support that; use `legacy-style-world-list' instead."
   :type '(repeat (list string string))
   :version "23.1")
 
@@ -478,7 +482,10 @@ TIMEZONE should be a string of the form:
 
 See the documentation of the TZ environment variable on your system,
 for more details about the format of TIMEZONE.
-LABEL is a string to display as the label of that TIMEZONE's time."
+LABEL is a string to display as the label of that TIMEZONE's time
+
+This is the only option that has effect on MS-Windows, where you also
+cannot specify the [offset][,date[/time],date[/time]] part."
   :type '(repeat (list string string))
   :version "23.1")