]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man: use readable names for entities
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Sun, 16 May 2021 16:54:04 +0000 (18:54 +0200)
committerYu Watanabe <watanabe.yu+github@gmail.com>
Wed, 19 May 2021 01:25:26 +0000 (10:25 +0900)
Let's use the same names as in the jinja2 substitutions.

man/custom-entities.ent.in
man/systemd-environment-d-generator.xml
man/systemd.environment-generator.xml
man/systemd.generator.xml

index d8612b226eb8ae9507455d4e6e1794df8b0259e5..1659ac34d55f4198e579bd56a2be5995997df85c 100644 (file)
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <!ENTITY MOUNT_PATH "{{MOUNT_PATH}}">
 <!ENTITY UMOUNT_PATH "{{UMOUNT_PATH}}">
-<!ENTITY systemgeneratordir "{{SYSTEM_GENERATOR_DIR}}">
-<!ENTITY usergeneratordir "{{USER_GENERATOR_DIR}}">
-<!ENTITY systemenvgeneratordir "{{SYSTEM_ENV_GENERATOR_DIR}}">
-<!ENTITY userenvgeneratordir "{{USER_ENV_GENERATOR_DIR}}">
+<!ENTITY SYSTEM_GENERATOR_DIR "{{SYSTEM_GENERATOR_DIR}}">
+<!ENTITY USER_GENERATOR_DIR "{{USER_GENERATOR_DIR}}">
+<!ENTITY SYSTEM_ENV_GENERATOR_DIR "{{SYSTEM_ENV_GENERATOR_DIR}}">
+<!ENTITY USER_ENV_GENERATOR_DIR "{{USER_ENV_GENERATOR_DIR}}">
 <!ENTITY CERTIFICATE_ROOT "{{CERTIFICATE_ROOT}}">
 <!ENTITY FALLBACK_HOSTNAME "{{FALLBACK_HOSTNAME}}">
 <!ENTITY MEMORY_ACCOUNTING_DEFAULT "{{ 'yes' if MEMORY_ACCOUNTING_DEFAULT else 'no' }}">
index a9b6b987dea922977d65b836b673738e6a521cf8..a85ef494285bc6aec633e432719d7e4d1febdda0 100644 (file)
@@ -25,7 +25,7 @@
   </refnamediv>
 
   <refsynopsisdiv>
-    <para><filename>&userenvgeneratordir;/30-systemd-environment-d-generator</filename></para>
+    <para><filename>&USER_ENV_GENERATOR_DIR;/30-systemd-environment-d-generator</filename></para>
   </refsynopsisdiv>
 
   <refsect1>
index 663d7dcddf944cb54ea8c16edf14f43cd53a224c..856f6a641b1d4a9356be77c9adb3889d55d48db3 100644 (file)
 
   <refsynopsisdiv>
     <cmdsynopsis>
-      <command>&systemenvgeneratordir;/some-generator</command>
+      <command>&SYSTEM_ENV_GENERATOR_DIR;/some-generator</command>
     </cmdsynopsis>
     <cmdsynopsis>
-      <command>&userenvgeneratordir;/some-generator</command>
+      <command>&USER_ENV_GENERATOR_DIR;/some-generator</command>
     </cmdsynopsis>
 
     <para>
       <literallayout><filename>/run/systemd/system-environment-generators/*</filename>
 <filename>/etc/systemd/system-environment-generators/*</filename>
 <filename>/usr/local/lib/systemd/system-environment-generators/*</filename>
-<filename>&systemenvgeneratordir;/*</filename></literallayout>
+<filename>&SYSTEM_ENV_GENERATOR_DIR;/*</filename></literallayout>
     </para>
 
     <para>
       <literallayout><filename>/run/systemd/user-environment-generators/*</filename>
 <filename>/etc/systemd/user-environment-generators/*</filename>
 <filename>/usr/local/lib/systemd/user-environment-generators/*</filename>
-<filename>&userenvgeneratordir;/*</filename></literallayout>
+<filename>&USER_ENV_GENERATOR_DIR;/*</filename></literallayout>
     </para>
   </refsynopsisdiv>
 
   <refsect1>
     <title>Description</title>
     <para>Generators are small executables that live in
-    <filename>&systemenvgeneratordir;/</filename> and other directories listed above.
+    <filename>&SYSTEM_ENV_GENERATOR_DIR;/</filename> and other directories listed above.
     <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry> will
     execute those binaries very early at the startup of each manager and at configuration
     reload time, before running the generators described in
       <title>Debugging a generator</title>
 
       <programlisting>SYSTEMD_LOG_LEVEL=debug VAR_A=something VAR_B="something else" \
-&systemenvgeneratordir;/path-to-generator
+&SYSTEM_ENV_GENERATOR_DIR;/path-to-generator
 </programlisting>
     </example>
   </refsect1>
index 9c622ed44cc6672b61d6353c632cb7d7da93d3d9..fb521726e35cde2086f1ce0080fc926ff76906b6 100644 (file)
       <literallayout><filename>/run/systemd/system-generators/*</filename>
 <filename>/etc/systemd/system-generators/*</filename>
 <filename>/usr/local/lib/systemd/system-generators/*</filename>
-<filename>&systemgeneratordir;/*</filename></literallayout>
+<filename>&SYSTEM_GENERATOR_DIR;/*</filename></literallayout>
     </para>
 
     <para>
       <literallayout><filename>/run/systemd/user-generators/*</filename>
 <filename>/etc/systemd/user-generators/*</filename>
 <filename>/usr/local/lib/systemd/user-generators/*</filename>
-<filename>&usergeneratordir;/*</filename></literallayout>
+<filename>&USER_GENERATOR_DIR;/*</filename></literallayout>
     </para>
   </refsynopsisdiv>
 
   <refsect1>
     <title>Description</title>
-    <para>Generators are small executables placed in <filename>&systemgeneratordir;/</filename> and other
+    <para>Generators are small executables placed in <filename>&SYSTEM_GENERATOR_DIR;/</filename> and other
     directories listed above.
     <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry> will execute
     these binaries very early at bootup and at configuration reload time — before unit files are
       <title>Debugging a generator</title>
 
       <programlisting>dir=$(mktemp -d)
-SYSTEMD_LOG_LEVEL=debug &systemgeneratordir;/systemd-fstab-generator \
+SYSTEMD_LOG_LEVEL=debug &SYSTEM_GENERATOR_DIR;/systemd-fstab-generator \
         "$dir" "$dir" "$dir"
 find $dir</programlisting>
     </example>