man: share description of $SYSTEMD_COLORS in other tools
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Fri, 15 Nov 2019 10:59:34 +0000 (11:59 +0100)
committerAdrian Bunk <bunk@debian.org>
Thu, 30 Mar 2023 19:32:31 +0000 (20:32 +0100)
It was only described in systemd(1), making it hard to discover.
Fixes #13561.

The same for $SYSTEMD_URLIFY.

I think all the tools whose man pages include less-variables.xml support
those variables.

Gbp-Pq: Name 0001-man-share-description-of-SYSTEMD_COLORS-in-other-too.patch

man/less-variables.xml
man/systemd.xml

index eb332b56b0b46a071998e4eaeda1417e7da0620d..334eb198715fdf1056e7bc2f56772be311defaf5 100644 (file)
       the invoking terminal is determined to be UTF-8 compatible).</para></listitem>
     </varlistentry>
 
-    </variablelist>
+    <varlistentry id='colors'>
+      <term><varname>$SYSTEMD_COLORS</varname></term>
+
+      <listitem><para>The value must be a boolean. Controls whether colorized output should be
+      generated. This can be specified to override the decision that <command>systemd</command> makes based
+      on <varname>$TERM</varname> and what the console is connected to.</para>
+      </listitem>
+    </varlistentry>
+
+    <varlistentry id='urlify'>
+      <term><varname>$SYSTEMD_URLIFY</varname></term>
+
+      <listitem><para>The value must be a boolean. Controls whether clickable links should be generated in
+      the output for terminal emulators supporting this. This can be specified to override the decision that
+      <command>systemd</command> makes based on <varname>$TERM</varname> and other conditions.</para>
+      </listitem>
+    </varlistentry>
+
+  </variablelist>
 </refsect1>
index 5287bdaba89a47a4c1af0f5f88b80cace01d52b3..1ff1f34dbeb7fb619ebb5ce4d3fb7246c02b2a11 100644 (file)
         script runlevel link farms.</para></listitem>
       </varlistentry>
 
-      <varlistentry>
-        <term><varname>$SYSTEMD_COLORS</varname></term>
-
-        <listitem><para>The value must be a boolean. Controls whether colorized output should be
-        generated. This can be specified to override the decision that <command>systemd</command>
-        makes based on <varname>$TERM</varname> and what the console is connected to.</para>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry>
-        <term><varname>$SYSTEMD_URLIFY</varname></term>
-
-        <listitem><para>The value must be a boolean. Controls whether clickable links should be generated in the output
-        for terminal emulators supporting this. This can be specified to override the decision that
-        <command>systemd</command> makes based on <varname>$TERM</varname> and other conditions.</para>
-        </listitem>
-      </varlistentry>
+      <xi:include href="less-variables.xml" xpointer="colors" />
+      <xi:include href="less-variables.xml" xpointer="urlify" />
 
       <varlistentry>
         <term><varname>$LISTEN_PID</varname></term>