X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=udev.xml;h=4896c2bb27e8a8abf8399a850eff457f085b4f75;hb=aa9a49b4b39bfaa465ae9d0f6ac4621cd519b719;hp=e0542a6be199048f024550dd784835bb17a47a6a;hpb=9de98988130c5565e6d75f444f591141ad33e95e;p=elogind.git

diff --git a/udev.xml b/udev.xml
index e0542a6be..4896c2bb2 100644
--- a/udev.xml
+++ b/udev.xml
@@ -3,19 +3,6 @@
   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
 
 <article>
-  <articleinfo>
-    <title>xmlto</title>
-    <author>
-      <firstname>Kay</firstname>
-      <surname>Sievers</surname>
-      <email>kay.sievers@vrfy.org</email>
-    </author>
-    <copyright>
-      <year>2005</year>
-      <holder>Kay Sievers</holder>
-    </copyright>
-  </articleinfo>
-
   <section>
     <title>udev</title>
     <refentry>
@@ -28,6 +15,7 @@
       <refmeta>
         <refentrytitle>udev</refentrytitle>
         <manvolnum>7</manvolnum>
+        <refmiscinfo class="version"></refmiscinfo>
       </refmeta>
 
       <refnamediv>
@@ -122,7 +110,7 @@
             <varlistentry>
               <term><option>=</option></term>
               <listitem>
-                <para>Asign a value to a key. Keys that represent a list, are reset
+                <para>Assign a value to a key. Keys that represent a list, are reset
                 and only this single value is assigned.</para>
               </listitem>
             </varlistentry>
@@ -301,7 +289,10 @@
               <term><option>RUN</option></term>
               <listitem>
                 <para>Add a program to the list of programs to be executed for a specific
-                device.</para>
+                device. This can only be used for very short running tasks. Running an
+                event process for a long period of time may block all further events for
+                this or a dependent device. Long running tasks need to be immediately
+                detached from the event process itself.</para>
               </listitem>
             </varlistentry>
 
@@ -315,7 +306,7 @@
             <varlistentry>
               <term><option>GOTO</option></term>
               <listitem>
-                <para>Jumps to the next LABEL with a matching gname</para>
+                <para>Jumps to the next LABEL with a matching name</para>
               </listitem>
             </varlistentry>
 
@@ -346,8 +337,9 @@
                 <option>ignore_device</option> will ignore this event completely.
                 <option>ignore_remove</option> will ignore  any  later  remove  event  for  this
                 device. This may be useful as a workaround for broken device drivers.
-                <option>all_partitions</option> will create device nodes for all available partitions of
-                a block device. This may be useful for removable media.</para>
+                <option>all_partitions</option> will create the device nodes for all available
+                partitions of a block device. This may be useful for removable media devices where
+                media changes are not detected.</para>
               </listitem>
             </varlistentry>
           </variablelist>
@@ -472,39 +464,6 @@
         </refsect2>
       </refsect1>
 
-      <refsect1><title>ENVIRONMENT</title>
-        <variablelist>
-          <varlistentry>
-            <term><option>ACTION</option></term>
-            <listitem>
-              <para><replaceable>add</replaceable> or <replaceable>remove</replaceable> signifies
-              the addition or the removal of a device.</para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><option>DEVPATH</option></term>
-            <listitem>
-              <para>The sysfs devpath without the mountpoint but a leading slash.</para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><option>SUBSYSTEM</option></term>
-            <listitem>
-              <para>The kernel subsystem the device belongs to.</para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><option>UDEV_LOG</option></term>
-            <listitem>
-              <para>Overrides the syslog priority specified in the config file.</para>
-            </listitem>
-          </varlistentry>
-        </variablelist>
-     </refsect1>
-
       <refsect1><title>AUTHOR</title>
         <para>Written by Greg Kroah-Hartman <email>greg@kroah.com</email> and
         Kay Sievers <email>kay.sievers@vrfy.org</email>. With much help from