[PATCH 14/14] Better documentation of TZ variable
From: Bastien Roucariès <rouca@debian.org>
Signed-off-by: Bastien Roucariès <rouca@debian.org>
---
man7/environ.7 | 34 +++++++++++++++++++++-------------
1 file changed, 21 insertions(+), 13 deletions(-)
diff --git a/man7/environ.7 b/man7/environ.7
index 79f34a302..173c7a1d9 100644
--- a/man7/environ.7
+++ b/man7/environ.7
@@ -217,6 +217,22 @@ Influences the path prefix of names created by
and other routines, and the temporary directory used by
.BR sort (1)
and other programs.
+.TP
+.B TZ
+The
+.B TZ
+variable along the
+.B TZDIR
+variable
+give timezone information used by
+.BR tzset (3)
+and through that by functions like
+.BR ctime (3),
+.BR localtime (3),
+.BR mktime (3),
+.BR strftime (3).
+See also
+.BR tzselect (8).
.SH INTERNATIONALIZATION ENVIRONMENT VARIABLES
.TP
.B LANG
@@ -247,7 +263,7 @@ the applications used by user.
.B COLUMNS
This variable is a positive or zero decimal integer used to indicate the user's preferred width
in column positions for the terminal screen or window.
-If this variable is unset or set to zero, the applications determines
+If this variable is unset, set to zero or empty, the applications determines
the number of columns, appropriate for the terminal or window.
When
.B COLUMNS
@@ -267,7 +283,7 @@ such as to display data in an area arbitrarily smaller than the terminal or wind
.B LINES
This variable is a positive or zero decimal integer used to indicate the user's preferred number
of lines for the terminal screen or window.
-If this variable is unset or set to zero, the applications determines
+If this variable is unset, set to zero or empty, the applications determines
the number of lines, appropriate for the terminal or window.
When
.B LINES
@@ -338,17 +354,6 @@ to be used with
The name of the logged-in user (used by some BSD-derived programs).
Set a login time, see section NOTES below.
.IP *
-.BR TZ " and " TZDIR
-give timezone information used by
-.BR tzset (3)
-and through that by functions like
-.BR ctime (3),
-.BR localtime (3),
-.BR mktime (3),
-.BR strftime (3).
-See also
-.BR tzselect (8).
-.IP *
.B TERMCAP
gives information on how to address a given terminal
(or gives the name of a file containing such information).
@@ -370,6 +375,9 @@ and should be reasonably portable.
.PP
.B PATH
behavior is specified by POSIX.1-2017.
+.PP
+.B TZ
+behavior is specified by POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.
.SH NOTES
The
.BR prctl (2)
--
2.29.2
Reply to: