Re: [PATCH V4 1/1] tzset.3: Add Environment section

["Michael Kerrisk (man-pages)" <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>]

On 01/29/2015 05:27 PM, J William Piggott wrote:
> FILES section was overly verbose and included
> environment variables.  Added ENVIRONMENT section,
> removing ENV VARS from the FILES section.
> 
> As stated in commit 2c7f200
> /usr/share/zoneinfo/localtime
> is not used, nor recommended by glibc.

Thanks, William! Applied.

Cheers,

Michael


> Signed-off-by: J William Piggott <elseifthen-KK0ffGbhmjU@public.gmane.org>
> ---
>  man3/tzset.3 | 41 ++++++++++++++++++++---------------------
>  1 file changed, 20 insertions(+), 21 deletions(-)
> 
> diff --git a/man3/tzset.3 b/man3/tzset.3
> index 81fbabe..a9b088d 100644
> --- a/man3/tzset.3
> +++ b/man3/tzset.3
> @@ -182,28 +182,27 @@ Here's an example, once more for New Zealand:
>  
>      TZ=":Pacific/Auckland"
>  .fi
> +.SH ENVIRONMENT
> +.TP
> +.B TZ
> +If this variable is set its value takes precedence over the system
> +configured timezone.
> +.TP
> +.B TZDIR
> +If this variable is set its value takes precedence over the system
> +configured timezone database directory path.
>  .SH FILES
> -Under glibc,
> -the system timezone directory is determined using the
> -.BR TZDIR
> -the environment variable.
> -If
> -.BR TZDIR
> -is not set, the default depends on the system setup, but is normally
> -.IR /usr/share/zoneinfo .
> -.LP
> -This timezone directory contains the files
> -
> -.nf
> -    localtime      local timezone file
> -    posixrules     rules for POSIX-style TZ's
> -.fi
> -.LP
> -Often,
> -.I /etc/localtime
> -is a symbolic link to the file
> -.I localtime
> -or to the correct timezone file in the system timezone directory.
> +.TP
> +.B /etc/localtime
> +The system timezone file.
> +.TP
> +.B /usr/share/zoneinfo/
> +The system timezone database directory.
> +.TP
> +.B /usr/share/zoneinfo/posixrules
> +.PP
> +Above are the current standard file locations, but they are
> +configurable when glibc is compiled.
>  .SH CONFORMING TO
>  SVr4, POSIX.1-2001, 4.3BSD.
>  .SH NOTES
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
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