X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Flocaltime.xml;h=1cbdf6827464bc25ca3e30ee614e1e3096a007cd;hp=09df161baa42dc45bb91f6a4cbfe274e5e2edb3d;hb=48aae6d6a051acd9c0630fab1e79b82c847e538b;hpb=608da9e9b56be83ac394ea7a19cbdacab94f6642

diff --git a/man/localtime.xml b/man/localtime.xml
index 09df161ba..1cbdf6827 100644
--- a/man/localtime.xml
+++ b/man/localtime.xml
@@ -25,7 +25,7 @@
 
 <refentry id="localtime">
         <refentryinfo>
-                <title>/etc/localtime</title>
+                <title>localtime</title>
                 <productname>systemd</productname>
 
                 <authorgroup>
@@ -51,42 +51,56 @@
 
         <refnamediv>
                 <refname>localtime</refname>
-                <refpurpose>Local time zone configuration file</refpurpose>
+                <refpurpose>Local timezone configuration file</refpurpose>
         </refnamediv>
 
         <refsynopsisdiv>
-                <para><filename>/etc/localtime</filename> -> <filename>/usr/share/zoneinfo/…</filename></para>
+                <para><filename>/etc/localtime</filename> -&gt; <filename>../usr/share/zoneinfo/…</filename></para>
         </refsynopsisdiv>
 
         <refsect1>
                 <title>Description</title>
 
                 <para>The <filename>/etc/localtime</filename> file
-                configures the system-wide time zone of the local
+                configures the system-wide timezone of the local
                 system that is used by applications for presentation
-                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
+                to the user. It should be an absolute or relative
+                symbolic link pointing to
+                <filename>/usr/share/zoneinfo/</filename>, followed by
+                a timezone identifier such as
+                <literal>Europe/Berlin</literal> or
+                <literal>Etc/UTC</literal>.  The resulting link should
+                lead to the corresponding binary
+                <citerefentry project='man-pages'><refentrytitle>tzfile</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+                timezone data for the configured timezone.</para>
+
+                <para>Because the timezone identifier is extracted from
+                the symlink target name of
+                <filename>/etc/localtime</filename>, this file may not
+                be a normal file or hardlink.</para>
+
+                <para>The timezone may be overridden for individual
                 programs by using the TZ environment variable. See
-                <citerefentry><refentrytitle>environ</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
+                <citerefentry project='man-pages'><refentrytitle>environ</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
+
+                <para>You may use
+                <citerefentry><refentrytitle>timedatectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+                to change the settings of this file from the command
+                line during runtime. Use
+                <citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+                to initialize the time zone on mounted (but not
+                booted) system images.</para>
         </refsect1>
 
         <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>
+                          <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+                          <citerefentry project='man-pages'><refentrytitle>tzset</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
+                          <citerefentry><refentrytitle>localtime</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
+                          <citerefentry><refentrytitle>timedatectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+                          <citerefentry><refentrytitle>systemd-timedated.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
+                          <citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
                   </para>
         </refsect1>