summaryrefslogtreecommitdiffstats
path: root/man/homectl.xml
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2020-09-29 09:30:42 +0200
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2020-09-30 10:30:03 +0200
commit7fd897c51ceaa3ff5760025598387ad1208498cf (patch)
tree277d38589b8814cd0c6266db942eb526dce3045a /man/homectl.xml
parentman: adjustments in file-hierarchy(7) (diff)
downloadsystemd-7fd897c51ceaa3ff5760025598387ad1208498cf.tar.xz
systemd-7fd897c51ceaa3ff5760025598387ad1208498cf.zip
man: explain why TZ=: is used
Also, reword the description a bit. "As a string" is meaningless in the context of commandline arguments, where evyrything is a string. This is not a strongly-typed programming language where 5 is a number but "5" is something completely different. Here both 5 and "5" are indistinguishable. The original text was trying to say that a location name should be given and not a number, so say "time zone location name". For #17177.
Diffstat (limited to 'man/homectl.xml')
-rw-r--r--man/homectl.xml12
1 files changed, 7 insertions, 5 deletions
diff --git a/man/homectl.xml b/man/homectl.xml
index dd16e47beb..732b7511ad 100644
--- a/man/homectl.xml
+++ b/man/homectl.xml
@@ -299,11 +299,13 @@
<varlistentry>
<term><option>--timezone=</option><replaceable>TIMEZONE</replaceable></term>
- <listitem><para>Takes a timezone specification as string that sets the timezone for the specified
- user. Expects a `tzdata` location string. When the user logs in the <varname>$TZ</varname>
- environment variable is initialized from this setting. Example:
- <option>--timezone=Europe/Amsterdam</option> will result in the environment variable
- <literal>TZ=:Europe/Amsterdam</literal>.</para></listitem>
+ <listitem><para>Takes a time zone location name that sets the timezone for the specified user. When
+ the user logs in the <varname>$TZ</varname> environment variable is initialized from this
+ setting. Example: <option>--timezone=Europe/Amsterdam</option> will result in the environment
+ variable <literal>TZ=:Europe/Amsterdam</literal>. (<literal>:</literal> is used intentionally as part
+ of the timezone specification, see
+ <citerefentry><refentrytitle>tzset</refentrytitle><manvolnum>3</manvolnum></citerefentry>.)
+ </para></listitem>
</varlistentry>
<varlistentry>