From: J William Piggott <elseifthen-KK0ffGbhmjU@public.gmane.org>
To: Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
Cc: linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
Subject: [PATCH 2/3] tzset.3: There are only two TZ formats
Date: Sun, 01 Feb 2015 08:16:26 -0500 [thread overview]
Message-ID: <54CE272A.1090003@gmx.com> (raw)
In-Reply-To: <54CE2689.7000704-KK0ffGbhmjU@public.gmane.org>
tzset(3) currently states that there are three TZ formats. The
first two it lists are actually variations of the POSIX-style
TZ format, of which there are at least five variations.
This patch corrects this to match the POSIX specification of
TZ having only two formats.
http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap08.html
Signed-off-by: J William Piggott <elseifthen-KK0ffGbhmjU@public.gmane.org>
---
man3/tzset.3 | 21 ++++++---------------
1 file changed, 6 insertions(+), 15 deletions(-)
diff --git a/man3/tzset.3 b/man3/tzset.3
index ed7f406..8002ee5 100644
--- a/man3/tzset.3
+++ b/man3/tzset.3
@@ -90,12 +90,12 @@ below, Coordinated Universal Time (UTC) is used.
.PP
The value of
.B TZ
-can be one of three formats.
-The first format is used
-when there is no daylight saving time in the local timezone:
+can be one of two formats.
+The first format is a string of characters that directly represent the
+timezone to be used:
.sp
.RS
-.I std offset
+.RI stdoffset[ dst [ offset ][, start [ /time ], end [ /time ]]]
.RE
.sp
There are no spaces in the specification.
@@ -110,15 +110,6 @@ east.
The hour must be between 0 and 24, and the minutes and seconds
0 and 59.
.PP
-The second format is used when there is daylight saving time:
-.sp
-.RS
-.RI stdoffset[ dst [ offset ][, start [ /time ], end [ /time ]]]
-.RE
-.sp
-There are no spaces in the specification.
-The initial \fIstd\fP and
-\fIoffset\fP specify the standard timezone, as described above.
The \fIdst\fP string and \fIoffset\fP specify the name and offset for the
corresponding daylight saving timezone.
If the offset is omitted,
@@ -161,7 +152,7 @@ and the changeovers happen at the default time of 02:00:00:
TZ="NZST-12:00:00NZDT-13:00:00,M10.1.0,M3.3.0"
.fi
.PP
-The third format specifies that the timezone information should be read
+The second format specifies that the timezone information should be read
from a file:
.sp
.RS
@@ -175,7 +166,7 @@ If \fIfilespec\fP is given, it specifies another
file to read the timezone information from.
If \fIfilespec\fP does not begin with a \(aq/\(aq, the file specification is
relative to the system timezone directory. If the colon is omitted each
-of the above three \fBTZ\fP formats will be tried in order.
+of the above \fBTZ\fP formats will be tried.
.PP
Here's an example, once more for New Zealand:
.nf
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
next prev parent reply other threads:[~2015-02-01 13:16 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-02-01 13:13 [PATCH 1/3] tzset.3: Incorrect TZ string representation J William Piggott
[not found] ` <54CE2689.7000704-KK0ffGbhmjU@public.gmane.org>
2015-02-01 13:16 ` J William Piggott [this message]
[not found] ` <54CE272A.1090003-KK0ffGbhmjU@public.gmane.org>
2015-02-01 15:31 ` [PATCH 2/3] tzset.3: There are only two TZ formats Michael Kerrisk (man-pages)
2015-02-01 13:18 ` [PATCH 3/3] tzset.3: typos and version bump J William Piggott
[not found] ` <54CE278A.9000604-KK0ffGbhmjU@public.gmane.org>
2015-02-01 15:32 ` Michael Kerrisk (man-pages)
2015-02-01 15:31 ` [PATCH 1/3] tzset.3: Incorrect TZ string representation Michael Kerrisk (man-pages)
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=54CE272A.1090003@gmx.com \
--to=elseifthen-kk0ffgbhmju@public.gmane.org \
--cc=linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
--cc=mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.