chiark / gitweb /
NEWS: mention set-log-level, --user, --system
[elogind.git] / man / localtime.xml
index 09df161baa42dc45bb91f6a4cbfe274e5e2edb3d..b7fd1ba15d980a1372b85ec71fc43d881576c6e8 100644 (file)
@@ -25,7 +25,7 @@
 
 <refentry id="localtime">
         <refentryinfo>
-                <title>/etc/localtime</title>
+                <title>localtime</title>
                 <productname>systemd</productname>
 
                 <authorgroup>
 
         <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> -> <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
+                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><refentrytitle>tzfile</refentrytitle><manvolnum>5</manvolnum></citerefentry>
-                time zone data for the configured time zone.</para>
+                timezone data for the configured timezone.</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>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 time zone may be overridden for individual
+                <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>
+
+                <para>You may use
+                <citerefentry><refentrytitle>timedatectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+                to change the settings of this file from the command
+                line.</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><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>
                   </para>
         </refsect1>