chiark / gitweb /
Docs: udev.xml: Clean up description of NAME assignment key
authorMichael Witten <mfwitten@gmail.com>
Fri, 8 Apr 2011 23:17:39 +0000 (23:17 +0000)
committerMichael Witten <mfwitten@gmail.com>
Mon, 11 Apr 2011 05:49:37 +0000 (05:49 +0000)
Signed-off-by: Michael Witten <mfwitten@gmail.com>
udev/udev.xml

index 77053b7700d77ed1f18fa1771e136db6eb4433af..225ad5ce3f099426bb6e225e62d07e88468ceffb 100644 (file)
         <varlistentry>
           <term><option>NAME</option></term>
           <listitem>
-            <para>The name, a network interface should be renamed to. Or as
-            a temporary workaround, the name a device node should be named.
-            Usually the kernel provides the defined node name, or even creates
+            <para>What a network interface should be named.</para>
+            <para>Also, as a temporary workaround, this is what a device node
+            should be named; usually the kernel provides the defined node name or creates
             and removes the node before udev even receives any event. Changing
             the node name from the kernel's default creates inconsistencies
             and is not supported. If the kernel and NAME specify different names,
-            an error is logged. Udev is only expected to handle device node
+            an error is logged. udev is only expected to handle device node
             permissions and to create additional symlinks, not to change
             kernel-provided device node names. Instead of renaming a device node,
-            SYMLINK should be used. Symlink names must never conflict with
-            device node names, it results in unpredictable behavior.</para>
+            SYMLINK should be used. However, symlink names must never conflict with
+            device node names, as that would result in unpredictable behavior.</para>
           </listitem>
         </varlistentry>