man: remove timezone(5) and add localtime(5)

diff --git a/Makefile.am b/Makefile.am
index 5674f1019a333d178f3e6ae5df7ae6c9b5f7f821..12c2d2e93b57ae70f87f7c5c955880a0b06ad2e1 100644 (file)
--- a/Makefile.am
+++ b/Makefile.am
@@ -471,7 +471,7 @@ MANPAGES = \
        man/systemd.conf.5 \
        man/tmpfiles.d.5 \
        man/hostname.5 \
        man/systemd.conf.5 \
        man/tmpfiles.d.5 \
        man/hostname.5 \

-       man/timezone.5 \
+       man/localtime.5 \

        man/machine-id.5 \
        man/locale.conf.5 \
        man/os-release.5 \
        man/machine-id.5 \
        man/locale.conf.5 \
        man/os-release.5 \

diff --git a/man/timezone.xml b/man/localtime.xml
similarity index 59%
rename from man/timezone.xml
rename to man/localtime.xml
index dedb7d90ffbbfa75812f6346a8a0cb98651cc3d0..09df161baa42dc45bb91f6a4cbfe274e5e2edb3d 100644 (file)
--- a/man/timezone.xml
+++ b/man/localtime.xml
@@ -7,6 +7,7 @@
   This file is part of systemd.
 
   Copyright 2010 Lennart Poettering
   This file is part of systemd.
 
   Copyright 2010 Lennart Poettering

+  Copyright 2012 Shawn Landden

 
   systemd is free software; you can redistribute it and/or modify it
   under the terms of the GNU Lesser General Public License as published by
 
   systemd is free software; you can redistribute it and/or modify it
   under the terms of the GNU Lesser General Public License as published by


@@ -22,9 +23,9 @@
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 

-<refentry id="timezone">
+<refentry id="localtime">

         <refentryinfo>
         <refentryinfo>

-                <title>/etc/timezone</title>
+                <title>/etc/localtime</title>

                 <productname>systemd</productname>
 
                 <authorgroup>
                 <productname>systemd</productname>
 
                 <authorgroup>


@@ -34,55 +35,57 @@
                                 <surname>Poettering</surname>
                                 <email>lennart@poettering.net</email>
                         </author>
                                 <surname>Poettering</surname>
                                 <email>lennart@poettering.net</email>
                         </author>

+                        <author>
+                                <contrib>Developer</contrib>
+                                <firstname>Shawn</firstname>
+                                <surname>Landden</surname>
+                                <email>shawnlandden@gmail.com</email>
+                        </author>

                 </authorgroup>
         </refentryinfo>
 
         <refmeta>
                 </authorgroup>
         </refentryinfo>
 
         <refmeta>

-                <refentrytitle>timezone</refentrytitle>
+                <refentrytitle>localtime</refentrytitle>

                 <manvolnum>5</manvolnum>
         </refmeta>
 
         <refnamediv>
                 <manvolnum>5</manvolnum>
         </refmeta>
 
         <refnamediv>

-                <refname>timezone</refname>
+                <refname>localtime</refname>

                 <refpurpose>Local time zone configuration file</refpurpose>
         </refnamediv>
 
         <refsynopsisdiv>
                 <refpurpose>Local time zone configuration file</refpurpose>
         </refnamediv>
 
         <refsynopsisdiv>

-                <para><filename>/etc/timezone</filename></para>
+                <para><filename>/etc/localtime</filename> -> <filename>/usr/share/zoneinfo/…</filename></para>

         </refsynopsisdiv>
 
         <refsect1>
                 <title>Description</title>
 
         </refsynopsisdiv>
 
         <refsect1>
                 <title>Description</title>
 

-                <para>The <filename>/etc/timezone</filename> file
+                <para>The <filename>/etc/localtime</filename> file

                 configures the system-wide time zone of the local
                 system that is used by applications for presentation
                 configures the system-wide time zone of the local
                 system that is used by applications for presentation

-                to the user. It should contain a single
-                newline-terminated line consisting of a time zone
-                identifier such as
-                <literal>Europe/Berlin</literal>. The file
-                <filename>/etc/localtime</filename> corresponds with
-                <filename>/etc/timezone</filename> and contains the
-                binary time zone data for the time zone. These files
-                should always be changed simultaneously and kept in
-                sync.</para>
+                to the user. It should be an absolute symbolic link
+                with a destination of <filename>/usr/share/zoneinfo/</filename>,
+                fallowed by a time zone identifier such as
+                <literal>Europe/Berlin</literal> or <literal>Etc/UTC</literal>.
+                The resulting link should point to the corresponding binary
+                <citerefentry><refentrytitle>tzfile</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+                time zone data for the configured time zone.</para>
+
+                <para>As the time zone identifier is extracted from the name of
+                the target of <filename>/etc/localtime</filename> this file may
+                not be a normal file or hardlink.</para>

 
                 <para>The time zone may be overridden for individual
                 programs by using the TZ environment variable. See
                 <citerefentry><refentrytitle>environ</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
         </refsect1>
 
 
                 <para>The time zone may be overridden for individual
                 programs by using the TZ environment variable. See
                 <citerefentry><refentrytitle>environ</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
         </refsect1>
 

-        <refsect1>
-                <title>History</title>
-
-                <para>The simple configuration file format of
-                <filename>/etc/timezone</filename> originates from
-                Debian GNU/Linux.</para>
-        </refsect1>
-

         <refsect1>
                   <title>See Also</title>
                   <para>
         <refsect1>
                   <title>See Also</title>
                   <para>

+                          <citerefentry><refentrytitle>tzset</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+                          <citerefentry><refentrytitle>localtime</refentrytitle><manvolnum>3</manvolnum></citerefentry>

                           <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
                   </para>
         </refsect1>
                           <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
                   </para>
         </refsect1>

diff --git a/units/systemd-timedated.service.in b/units/systemd-timedated.service.in
index 1944a71cb7fb2823a331f616394e9c38b6282b9b..dd3eb1b337e573ea86aac6cd35532c56f9492211 100644 (file)
--- a/units/systemd-timedated.service.in
+++ b/units/systemd-timedated.service.in
@@ -7,7 +7,7 @@
 
 [Unit]
 Description=Time & Date Service
 
 [Unit]
 Description=Time & Date Service

-Documentation=man:systemd-timedated.service(8) man:timezone(5)
+Documentation=man:systemd-timedated.service(8) man:localtime(5)

 Documentation=http://www.freedesktop.org/wiki/Software/systemd/timedated
 
 [Service]
 Documentation=http://www.freedesktop.org/wiki/Software/systemd/timedated
 
 [Service]