X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.preset.xml;h=55cb4de174015638d8d21a3c19660f6f873120dc;hp=238cb383e2e4b62d1a91a632d2be1393eb29c94f;hb=d86dd07d462fb8502b1c7b4a9a4df4fba8318bdd;hpb=305f376cec18d276dd4519bbacda013c033c569d

diff --git a/man/systemd.preset.xml b/man/systemd.preset.xml
index 238cb383e..55cb4de17 100644
--- a/man/systemd.preset.xml
+++ b/man/systemd.preset.xml
@@ -72,6 +72,11 @@
                 set of units to be enabled/disabled even before
                 installing the actual package.</para>
 
+                <para>For more information on the preset logic please
+                have a look at the <ulink
+                url="http://freedesktop.org/wiki/Software/systemd/Preset">Presets</ulink>
+                document.</para>
+
                 <para>It is not recommended to ship preset files
                 within the respective software packages implementing
                 the units, but rather centralize them in a
@@ -81,7 +86,7 @@
                 <para>If no preset files exist, <command>systemctl
                 preset</command> will enable all units that are
                 installed by default. If this is not desired and all
-                units shall rather be disabled it is necessary to ship
+                units shall rather be disabled, it is necessary to ship
                 a preset file with a single, catchall
                 "<filename>disable *</filename>" line. (See example 1,
                 below.)</para>
@@ -104,7 +109,7 @@
                 by default, <literal>disable</literal> to disable
                 units by default.</para>
 
-                <para>If multiple lines apply to a unit name the
+                <para>If multiple lines apply to a unit name, the
                 first matching one takes precedence over all
                 others.</para>
 
@@ -120,20 +125,19 @@
                 <filename>/etc/</filename> are reserved for the local
                 administrator, who may use this logic to override the
                 preset files installed by vendor packages. All preset
-                files are sorted by their filename in alphabetical
-                order, regardless in which of the directories they
-                reside, to guarantee that a specific preset file takes
-                precedence over another file with an alphabetically
-                earlier name, if both files contain lines that apply
-                to the same unit names. It is recommended to prefix
-                all file names with two-digit number, to simplify
-                ordering.</para>
+                files are sorted by their filename in lexicographic
+                order, regardless of which of the directories they
+                reside in. If multiple files specify the same unit name,
+                the entry in the file with the lexicographically earliest
+                name will be applied. It is recommended to prefix all
+                filenames with a two-digit number and a dash, to simplify
+                the ordering of the files.</para>
 
                 <para>If the administrator wants to disable a preset
-                file supplied by the vendor the recommended way is to
+                file supplied by the vendor, the recommended way is to
                 place a symlink to <filename>/dev/null</filename> in
                 <filename>/etc/systemd/system-preset/</filename>
-                bearing the same file name.</para>
+                bearing the same filename.</para>
         </refsect1>
 
         <refsect1>
@@ -145,8 +149,8 @@
                         <programlisting>disable *</programlisting>
                 </example>
 
-                <para>This disables all units. Due to the file name
-                prefix <literal>99-</literal> it will be read last and
+                <para>This disables all units. Due to the filename
+                prefix <literal>99-</literal>, it will be read last and
                 hence can easily be overridden by spin or
                 administrator preset policy or suchlike.</para>
 
@@ -182,7 +186,7 @@ disable *</programlisting>
                 <para>This enables three specific services and
                 disables all others. This is useful for administrators
                 to specifically select the units to enable, and
-                disable all others. Due to the file name prefix
+                disable all others. Due to the filename prefix
                 <literal>00-</literal> it will be read early and hence
                 overrides all other preset policy files.</para>
         </refsect1>