From 0d3ba825e224ddf8ea5838cd6c7be9ff9892a4ea Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= <zbyszek@in.waw.pl>
Date: Fri, 20 May 2022 17:35:17 +0200
Subject: [PATCH] man/systemd.automount: move the main description up and
 clarify deps

(cherry picked from commit 93dbc22a9533ab4fbf8a4b6c176b95f8cef7a9a6)
---
 man/systemd.automount.xml | 24 ++++++++++--------------
 1 file changed, 10 insertions(+), 14 deletions(-)

diff --git a/man/systemd.automount.xml b/man/systemd.automount.xml
index da35a7d26b..628a6615e6 100644
--- a/man/systemd.automount.xml
+++ b/man/systemd.automount.xml
@@ -26,10 +26,9 @@
   <refsect1>
     <title>Description</title>
 
-    <para>A unit configuration file whose name ends in
-    <literal>.automount</literal> encodes information about a file
-    system automount point controlled and supervised by
-    systemd.</para>
+    <para>A unit configuration file whose name ends in <literal>.automount</literal> encodes information
+    about a file system automount point controlled and supervised by systemd. Automount units may be used to
+    implement on-demand mounting as well as parallelized mounting of file systems.</para>
 
     <para>This man page lists the configuration options specific to
     this unit type. See
@@ -55,9 +54,6 @@
     accesses <filename>/home/lennart</filename> the mount unit
     <filename>home-lennart.mount</filename> will be activated.</para>
 
-    <para>Automount units may be used to implement on-demand mounting
-    as well as parallelized mounting of file systems.</para>
-
     <para>Note that automount units are separate from the mount itself, so you
     should not set <varname>After=</varname> or <varname>Requires=</varname>
     for mount dependencies here. For example, you should not set
@@ -65,8 +61,8 @@
     filesystems. Doing so may result in an ordering cycle.</para>
 
     <para>Note that automount support on Linux is privileged, automount units are hence only available in the
-    system service manager (and root's user service manager), but not in unprivileged user's service
-    manager.</para>
+    system service manager (and root's user service manager), but not in unprivileged users' service
+    managers.</para>
   </refsect1>
 
   <refsect1>
@@ -78,12 +74,12 @@
       <para>The following dependencies are implicitly added:</para>
 
       <itemizedlist>
-        <listitem><para>If an automount unit is beneath another mount unit in the
-        file system hierarchy, both a requirement and an ordering
-        dependency between both units are created automatically.</para></listitem>
+        <listitem><para>If an automount unit is beneath another mount unit in the file system hierarchy, a
+        requirement and ordering dependencies are created to the on the unit higher in the hierarchy.
+        </para></listitem>
 
-        <listitem><para>An implicit <varname>Before=</varname> dependency is created
-        between an automount unit and the mount unit it activates.</para></listitem>
+        <listitem><para>An implicit <varname>Before=</varname> dependency is created between an automount
+        unit and the mount unit it activates.</para></listitem>
       </itemizedlist>
     </refsect2>