man/udevadm: rebreak and reindent lines

diff --git a/man/udevadm.xml b/man/udevadm.xml
index 5104eee12b7f4e8847a2315f0a4dcd3f807205ce..c7097e88ccc9996c2d920ec594bac531a059e56c 100644 (file)
--- a/man/udevadm.xml
+++ b/man/udevadm.xml
@@ -23,9 +23,9 @@
   <refsynopsisdiv>
     <cmdsynopsis>
       <command>udevadm</command>
-        <arg><option>--debug</option></arg>
-        <arg><option>--version</option></arg>
-        <arg><option>--help</option></arg>
+      <arg><option>--debug</option></arg>
+      <arg><option>--version</option></arg>
+      <arg><option>--help</option></arg>
     </cmdsynopsis>
     <cmdsynopsis>
       <command>udevadm info <optional>options</optional> <optional>devpath</optional></command>
@@ -66,7 +66,8 @@
     </cmdsynopsis>
   </refsynopsisdiv>
 
-  <refsect1><title>Description</title>
+  <refsect1>
+    <title>Description</title>
     <para><command>udevadm</command> expects a command and command
     specific options.  It controls the runtime behavior of
     <command>systemd-udevd</command>, requests kernel events, manages
@@ -95,10 +96,11 @@
       <xi:include href="standard-options.xml" xpointer="help" />
     </variablelist>
 
-    <refsect2><title>udevadm info
+    <refsect2>
+      <title>udevadm info
       <optional><replaceable>options</replaceable></optional>
       <optional><replaceable>devpath</replaceable>|<replaceable>file</replaceable>|<replaceable>unit</replaceable></optional>
-    </title>
+      </title>
 
       <para>Query the udev database for device information.</para>
 
@@ -130,7 +132,7 @@
             be a comma-separated list of property names. If not specified, all known properties
             are shown.</para>
 
-          <xi:include href="version-info.xml" xpointer="v250"/>
+            <xi:include href="version-info.xml" xpointer="v250"/>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -244,7 +246,7 @@
             <para>Wait for device to be initialized. If argument <replaceable>SECONDS</replaceable>
             is not specified, the default is to wait forever.</para>
 
-          <xi:include href="version-info.xml" xpointer="v243"/>
+            <xi:include href="version-info.xml" xpointer="v243"/>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -254,7 +256,7 @@
             <para>When used with <option>--export-db</option>, only show devices of or not of the given
             subsystem respectively.</para>
 
-          <xi:include href="version-info.xml" xpointer="v255"/>
+            <xi:include href="version-info.xml" xpointer="v255"/>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -264,7 +266,7 @@
             <para>When used with <option>--export-db</option>, only show devices matching or not matching the
             given attribute respectively.</para>
 
-          <xi:include href="version-info.xml" xpointer="v255"/>
+            <xi:include href="version-info.xml" xpointer="v255"/>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -273,7 +275,7 @@
             <para>When used with <option>--export-db</option>, only show devices matching the given property
             and value.</para>
 
-          <xi:include href="version-info.xml" xpointer="v255"/>
+            <xi:include href="version-info.xml" xpointer="v255"/>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -281,7 +283,7 @@
           <listitem>
             <para>When used with <option>--export-db</option>, only show devices with the given tag.</para>
 
-          <xi:include href="version-info.xml" xpointer="v255"/>
+            <xi:include href="version-info.xml" xpointer="v255"/>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -290,7 +292,7 @@
             <para>When used with <option>--export-db</option>, only show devices with the given
             <literal>/sys</literal> path.</para>
 
-          <xi:include href="version-info.xml" xpointer="v255"/>
+            <xi:include href="version-info.xml" xpointer="v255"/>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -299,7 +301,7 @@
             <para>When used with <option>--export-db</option>, only show devices with the given name in
             <literal>/dev</literal>.</para>
 
-          <xi:include href="version-info.xml" xpointer="v255"/>
+            <xi:include href="version-info.xml" xpointer="v255"/>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -308,7 +310,7 @@
             <para>When used with <option>--export-db</option>, only show devices with the given parent
             device.</para>
 
-          <xi:include href="version-info.xml" xpointer="v255"/>
+            <xi:include href="version-info.xml" xpointer="v255"/>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -406,10 +408,12 @@
       </table>
     </refsect2>
 
-    <refsect2><title>udevadm trigger
+    <refsect2>
+      <title>udevadm trigger
       <optional><replaceable>options</replaceable></optional>
       <optional><replaceable>devpath</replaceable>|<replaceable>file</replaceable>|<replaceable>unit</replaceable></optional>
       </title>
+
       <para>Request device events from the kernel. Primarily used to replay events at system coldplug time.</para>
 
       <para>Takes device specifications as positional arguments. See the description of <command>info</command>
@@ -436,7 +440,7 @@
           <listitem>
             <para>Suppress error logging in triggering events.</para>
 
-          <xi:include href="version-info.xml" xpointer="v248"/>
+            <xi:include href="version-info.xml" xpointer="v248"/>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -642,10 +646,13 @@
       respectively.</para>
     </refsect2>
 
-    <refsect2><title>udevadm settle
+    <refsect2>
+      <title>udevadm settle
       <optional><replaceable>options</replaceable></optional>
-    </title>
+      </title>
+
       <para>Watches the udev event queue, and exits if all current events are handled.</para>
+
       <variablelist>
         <varlistentry>
           <term><option>-t</option></term>
@@ -673,8 +680,11 @@
       for more information.</para>
     </refsect2>
 
-    <refsect2><title>udevadm control <replaceable>option</replaceable></title>
+    <refsect2>
+      <title>udevadm control <replaceable>option</replaceable></title>
+
       <para>Modify the internal state of the running udev daemon.</para>
+
       <variablelist>
         <varlistentry>
           <term><option>-e</option></term>
@@ -807,18 +817,19 @@
             <xi:include href="version-info.xml" xpointer="v256"/>
           </listitem>
         </varlistentry>
-
-        <xi:include href="standard-options.xml" xpointer="help" />
       </variablelist>
     </refsect2>
 
-    <refsect2><title>udevadm monitor
+    <refsect2>
+      <title>udevadm monitor
       <optional><replaceable>options</replaceable></optional>
-    </title>
+      </title>
+
       <para>Listens to the kernel uevents and events sent out by a udev rule
       and prints the devpath of the event to the console. It can be used to analyze the
       event timing, by comparing the timestamps of the kernel uevent and the udev event.
       </para>
+
       <variablelist>
         <varlistentry>
           <term><option>-k</option></term>
@@ -862,11 +873,14 @@
       </variablelist>
     </refsect2>
 
-    <refsect2><title>udevadm test
+    <refsect2>
+      <title>udevadm test
       <optional><replaceable>options</replaceable></optional>
       <optional><replaceable>devpath</replaceable>|<replaceable>file</replaceable>|<replaceable>unit</replaceable></optional>
-    </title>
+      </title>
+
       <para>Simulate a udev event run for the given device, and print debug output.</para>
+
       <variablelist>
         <varlistentry>
           <term><option>-a</option></term>
@@ -918,19 +932,20 @@
             <xi:include href="version-info.xml" xpointer="v258"/>
           </listitem>
         </varlistentry>
-
-        <xi:include href="standard-options.xml" xpointer="help" />
       </variablelist>
     </refsect2>
 
-    <refsect2><title>udevadm test-builtin
+    <refsect2>
+      <title>udevadm test-builtin
       <optional><replaceable>options</replaceable></optional>
       <replaceable>command</replaceable>
       <optional><replaceable>devpath</replaceable>|<replaceable>file</replaceable>|<replaceable>unit</replaceable></optional>
-    </title>
+      </title>
+
       <para>Run a built-in command <replaceable>COMMAND</replaceable>
       for device <replaceable>DEVPATH</replaceable>, and print debug
       output.</para>
+
       <variablelist>
         <varlistentry>
           <term><option>-a</option></term>
@@ -942,7 +957,7 @@
             and <literal>unbind</literal>. Also, the special value <literal>help</literal> can be used
             to list the possible actions. The default value is <literal>add</literal>.</para>
 
-          <xi:include href="version-info.xml" xpointer="v250"/>
+            <xi:include href="version-info.xml" xpointer="v250"/>
           </listitem>
         </varlistentry>
       </variablelist>
@@ -1004,7 +1019,7 @@
           <listitem>
             <para>Do not show summary.</para>
 
-          <xi:include href="version-info.xml" xpointer="v254"/>
+            <xi:include href="version-info.xml" xpointer="v254"/>
           </listitem>
         </varlistentry>
 
@@ -1113,7 +1128,7 @@
             there is no udev rules for the specified devices, as the devices will never be considered
             as initialized in that case. See Initialized Devices section below for more details.</para>
 
-          <xi:include href="version-info.xml" xpointer="v251"/>
+            <xi:include href="version-info.xml" xpointer="v251"/>
           </listitem>
         </varlistentry>
 
@@ -1168,61 +1183,69 @@
           <term><option>--device=<replaceable>DEVICE</replaceable></option></term>
           <term><option>-d <replaceable>DEVICE</replaceable></option></term>
 
-          <listitem><para>Takes a path to a device node of the device to lock. This switch may be used
-          multiple times (and in combination with <option>--backing=</option>) in order to lock multiple
-          devices. If a partition block device node is specified the containing "whole" block device is
-          automatically determined and used for the lock, as per the specification. If multiple devices are
-          specified, they are deduplicated, sorted by the major/minor of their device nodes and then locked
-          in order.</para>
+          <listitem>
+            <para>Takes a path to a device node of the device to lock. This switch may be used
+            multiple times (and in combination with <option>--backing=</option>) in order to lock multiple
+            devices. If a partition block device node is specified the containing "whole" block device is
+            automatically determined and used for the lock, as per the specification. If multiple devices are
+            specified, they are deduplicated, sorted by the major/minor of their device nodes and then locked
+            in order.</para>
 
-          <para>This switch must be used at least once, to specify at least one device to
-          lock. (Alternatively, use <option>--backing=</option>, see below.)</para>
+            <para>This switch must be used at least once, to specify at least one device to
+            lock. (Alternatively, use <option>--backing=</option>, see below.)</para>
 
-          <xi:include href="version-info.xml" xpointer="v251"/></listitem>
+            <xi:include href="version-info.xml" xpointer="v251"/>
+          </listitem>
         </varlistentry>
 
         <varlistentry>
           <term><option>--backing=<replaceable>PATH</replaceable></option></term>
           <term><option>-b <replaceable>PATH</replaceable></option></term>
 
-          <listitem><para>If a path to a device node is specified, identical to
-          <option>--device=</option>. However, this switch alternatively accepts a path to a regular file or
-          directory, in which case the block device of the file system the file/directory resides on is
-          automatically determined and used as if it was specified with
-          <option>--device=</option>.</para>
+          <listitem>
+            <para>If a path to a device node is specified, identical to
+            <option>--device=</option>. However, this switch alternatively accepts a path to a regular file or
+            directory, in which case the block device of the file system the file/directory resides on is
+            automatically determined and used as if it was specified with
+            <option>--device=</option>.</para>
 
-          <xi:include href="version-info.xml" xpointer="v251"/></listitem>
+            <xi:include href="version-info.xml" xpointer="v251"/>
+          </listitem>
         </varlistentry>
 
         <varlistentry>
           <term><option>--timeout=<replaceable>SECS</replaceable></option></term>
           <term><option>-t <replaceable>SECS</replaceable></option></term>
 
-          <listitem><para>Specifies how long to wait at most until all locks can be taken. Takes a value in
-          seconds, or in the usual supported time units, see
-          <citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry>. If
-          specified as zero the lock is attempted and if not successful the invocation will immediately
-          fail. If passed as <literal>infinity</literal> (the default) the invocation will wait indefinitely
-          until the lock can be acquired. If the lock cannot be taken in the specified time the specified
-          command will not be executed and the invocation will fail.</para>
+          <listitem>
+            <para>Specifies how long to wait at most until all locks can be taken. Takes a value in
+            seconds, or in the usual supported time units, see
+            <citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry>. If
+            specified as zero the lock is attempted and if not successful the invocation will immediately
+            fail. If passed as <literal>infinity</literal> (the default) the invocation will wait indefinitely
+            until the lock can be acquired. If the lock cannot be taken in the specified time the specified
+            command will not be executed and the invocation will fail.</para>
 
-          <xi:include href="version-info.xml" xpointer="v251"/></listitem>
+            <xi:include href="version-info.xml" xpointer="v251"/>
+          </listitem>
         </varlistentry>
 
         <varlistentry>
           <term><option>--print</option></term>
           <term><option>-p</option></term>
 
-          <listitem><para>Instead of locking the specified devices and executing a command, just print the
-          device paths that would be locked, and execute no command. This command is useful to determine
-          the "whole" block device in case a partition block device is specified. The devices will be sorted
-          by their device node major number as primary ordering key and the minor number as secondary
-          ordering key (i.e. they are shown in the order they'd be locked). Note that the number of lines
-          printed here can be less than the number of <option>--device=</option> and
-          <option>--backing=</option> switches specified in case these resolve to the same "whole"
-          devices.</para>
+          <listitem>
+            <para>Instead of locking the specified devices and executing a command, just print the
+            device paths that would be locked, and execute no command. This command is useful to determine
+            the "whole" block device in case a partition block device is specified. The devices will be sorted
+            by their device node major number as primary ordering key and the minor number as secondary
+            ordering key (i.e. they are shown in the order they'd be locked). Note that the number of lines
+            printed here can be less than the number of <option>--device=</option> and
+            <option>--backing=</option> switches specified in case these resolve to the same "whole"
+            devices.</para>
 
-          <xi:include href="version-info.xml" xpointer="v251"/></listitem>
+            <xi:include href="version-info.xml" xpointer="v251"/>
+          </listitem>
         </varlistentry>
       </variablelist>
     </refsect2>

diff --git a/tools/command_ignorelist b/tools/command_ignorelist
index f68577e937501cec753cb74d88149899c131ef8b..d868c55b15e9c44c84fdefa2ff2ee70d6ea6329a 100644 (file)
--- a/tools/command_ignorelist
+++ b/tools/command_ignorelist
@@ -486,16 +486,16 @@ udev.xml /refsect1[title="Rules Files"]/refsect2[title="Keys"]/variablelist[4]/v
 udev.xml /refsect1[title="Rules Files"]/refsect2[title="Keys"]/variablelist[4]/varlistentry[term="$$"]
 udevadm.xml /refsect1[title="Options"]/variablelist/varlistentry[term="-d"]
 udevadm.xml /refsect1[title="Options"]/variablelist/varlistentry[term="-V"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n    "]/variablelist/varlistentry[term="-q"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n    "]/variablelist/varlistentry[term="-p"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n    "]/variablelist/varlistentry[term="-n"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n    "]/variablelist/varlistentry[term="-r"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n    "]/variablelist/varlistentry[term="-a"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n    "]/variablelist/varlistentry[term="-x"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n    "]/variablelist/varlistentry[term="-P"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n    "]/variablelist/varlistentry[term="-d"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n    "]/variablelist/varlistentry[term="-e"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n    "]/variablelist/varlistentry[term="-c"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-q"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-p"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-n"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-r"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-a"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-x"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-P"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-d"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-e"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-c"]
 udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-v"]
 udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-n"]
 udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-t"]
@@ -508,8 +508,8 @@ udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n      op
 udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-g"]
 udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-y"]
 udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-b"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm settle\n      options\n    "]/variablelist/varlistentry[term="-t"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm settle\n      options\n    "]/variablelist/varlistentry[term="-E"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm settle\n      options\n      "]/variablelist/varlistentry[term="-t"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm settle\n      options\n      "]/variablelist/varlistentry[term="-E"]
 udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/variablelist/varlistentry[term="-e"]
 udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/variablelist/varlistentry[term="-l"]
 udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/variablelist/varlistentry[term="-s"]
@@ -518,12 +518,12 @@ udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/
 udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/variablelist/varlistentry[term="-p"]
 udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/variablelist/varlistentry[term="-m"]
 udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/variablelist/varlistentry[term="-t"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n      options\n    "]/variablelist/varlistentry[term="-k"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n      options\n    "]/variablelist/varlistentry[term="-u"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n      options\n    "]/variablelist/varlistentry[term="-p"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n      options\n    "]/variablelist/varlistentry[term="-s"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n      options\n    "]/variablelist/varlistentry[term="-t"]
-udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm test\n      options\n      devpath|file|unit\n    "]/variablelist/varlistentry[term="-a"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n      options\n      "]/variablelist/varlistentry[term="-k"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n      options\n      "]/variablelist/varlistentry[term="-u"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n      options\n      "]/variablelist/varlistentry[term="-p"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n      options\n      "]/variablelist/varlistentry[term="-s"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n      options\n      "]/variablelist/varlistentry[term="-t"]
+udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm test\n      options\n      devpath|file|unit\n      "]/variablelist/varlistentry[term="-a"]
 vconsole.conf.xml /refsect1[title="Options"]/variablelist/varlistentry[term="KEYMAP="]
 vconsole.conf.xml /refsect1[title="Options"]/variablelist/varlistentry[term="FONT="]
 file-hierarchy.xml /refsect1[title="General Structure"]/variablelist/varlistentry[term="/"]