--- man/man3/tzset.3 | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/man/man3/tzset.3 b/man/man3/tzset.3 index 0b813c568..f3e6c8748 100644 --- a/man/man3/tzset.3 +++ b/man/man3/tzset.3 @@ -86,7 +86,8 @@ below, then Coordinated Universal Time (UTC) is used. .P A nonempty value of .B TZ -can be one of two formats. +can be one of two formats, +either of which can be preceded by a colon which is ignored. The first format is a string of characters that directly represent the timezone to be used: .P @@ -168,19 +169,21 @@ from a file: .P .in +4n .EX -:[filespec] +filespec .EE .in .P -If the file specification \fIfilespec\fP is omitted, or its value cannot -be interpreted, then Coordinated Universal Time (UTC) is used. -If \fIfilespec\fP is given, it specifies another +The \fIfilespec\fP specifies a .BR tzfile (5)-format 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 \fBTZ\fP formats will be tried. +If the specified file cannot be read or interpreted, +Coordinated Universal Time (UTC) is used; +however, applications should not depend on random \fIfilespec\fP values +standing for UTC, as +.B TZ +formats may be extended in the future. .P Here's an example, once more for New Zealand: .P -- 2.45.2