[system-administrators-guide] Markup and language improvements en-US/Network_Interfaces.xml

stephenw stephenw at fedoraproject.org
Thu Dec 12 20:00:00 UTC 2013


commit bda4f223e71fa6211dc2992a9154ec2fb21511ea
Author: Stephen Wadeley <swadeley at redhat.com>
Date:   Wed Nov 20 13:15:21 2013 +0100

    Markup and language improvements
    en-US/Network_Interfaces.xml

 en-US/Network_Interfaces.xml |   30 +++++++++++++++---------------
 1 files changed, 15 insertions(+), 15 deletions(-)
---
diff --git a/en-US/Network_Interfaces.xml b/en-US/Network_Interfaces.xml
index 39d2f02..6f7bf21 100644
--- a/en-US/Network_Interfaces.xml
+++ b/en-US/Network_Interfaces.xml
@@ -208,12 +208,12 @@ ONBOOT=yes</programlisting>
               </listitem>
               <listitem>
                 <para>
-                  <literal>bootp</literal> — The BOOTP protocol should be used.
+                  <literal>bootp</literal> — The <systemitem class="protocol">BOOTP</systemitem> protocol should be used.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <literal>dhcp</literal> — The DHCP protocol should be used.
+                  <literal>dhcp</literal> — The <systemitem class="protocol">DHCP</systemitem> protocol should be used.
                 </para>
               </listitem>
             </itemizedlist>
@@ -233,7 +233,7 @@ ONBOOT=yes</programlisting>
           </term>
           <listitem>
             <para>
-              where <replaceable>name</replaceable> is the name of the physical device (except for dynamically-allocated PPP devices where it is the <emphasis>logical name</emphasis>).
+              where <replaceable>name</replaceable> is the name of the physical device (except for dynamically-allocated <systemitem class="protocol">PPP</systemitem> devices where it is the <emphasis>logical name</emphasis>).
             </para>
           </listitem>
         </varlistentry>
@@ -241,7 +241,7 @@ ONBOOT=yes</programlisting>
           <term><option>DHCP_HOSTNAME</option>=<replaceable>name</replaceable></term>
           <listitem>
             <para>
-              where <replaceable>name</replaceable> is a short hostname to be sent to the DHCP server. Use this option only if the DHCP server requires the client to specify a hostname before receiving an IP address.
+              where <replaceable>name</replaceable> is a short host name to be sent to the <systemitem class="protocol">DHCP</systemitem> server. Use this option only if the <systemitem class="protocol">DHCP</systemitem> server requires the client to specify a host name before receiving an IP address.
             </para>
           </listitem>
         </varlistentry>
@@ -254,12 +254,12 @@ ONBOOT=yes</programlisting>
             <itemizedlist>
               <listitem>
                 <para>
-                  <literal>yes</literal> — Use DHCP to obtain an <systemitem class="protocol">IPv6</systemitem> address for this interface.
+                  <literal>yes</literal> — Use <systemitem class="protocol">DHCP</systemitem> to obtain an <systemitem class="protocol">IPv6</systemitem> address for this interface.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <literal>no</literal> — Do not use DHCP to obtain an <systemitem class="protocol">IPv6</systemitem> address for this interface. This is the default value.
+                  <literal>no</literal> — Do not use <systemitem class="protocol">DHCP</systemitem> to obtain an <systemitem class="protocol">IPv6</systemitem> address for this interface. This is the default value.
                 </para>
                 </listitem>
                 </itemizedlist>
@@ -280,23 +280,23 @@ ONBOOT=yes</programlisting>
                 </listitem>
                 <listitem>
                 <para>
-                  <option>-S</option> — Use DHCP to obtain stateless configuration only, not addresses, for this interface.
+                  <option>-S</option> — Use <systemitem class="protocol">DHCP</systemitem> to obtain stateless configuration only, not addresses, for this interface.
                 </para>
                 </listitem>
                 <listitem>
                 <para>
-                  <option>-N</option> — Restore normal operation after using the -T or -P options.
+                  <option>-N</option> — Restore normal operation after using the <option>-T</option> or <option>-P</option> options.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <option>-T</option> — Use DHCP to obtain a temporary <systemitem class="protocol">IPv6</systemitem> address for this interface.
+                  <option>-T</option> — Use <systemitem class="protocol">DHCP</systemitem> to obtain a temporary <systemitem class="protocol">IPv6</systemitem> address for this interface.
                 </para>
                 </listitem>
                 
                 <listitem>
                 <para>
-                  <option>-D</option> — Override the default when selecting the type of DHCP Unique Identifier (DUID) to use.
+                  <option>-D</option> — Override the default when selecting the type of <firstterm>DHCP Unique Identifier</firstterm> (<acronym>DUID</acronym>) to use.
 
                 </para>
                  
@@ -524,12 +524,12 @@ ONBOOT=yes</programlisting>
             <itemizedlist>
               <listitem>
                 <para>
-                  <literal>yes</literal> — NetworkManager is permitted to configure this device.This is the default behavior and can be omitted.
+                  <literal>yes</literal> — <application>NetworkManager</application> is permitted to configure this device. This is the default behavior and can be omitted.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <literal>no</literal> — NetworkManager is not permitted to configure this device.
+                  <literal>no</literal> — <application>NetworkManager</application> is not permitted to configure this device.
                 </para>
                 </listitem>
              </itemizedlist>
@@ -659,7 +659,7 @@ ONBOOT=yes</programlisting>
       <para><application>Ethtool</application> is a utility for configuration of <firstterm>Network Interface Cards</firstterm> (<acronym>NICs</acronym>). This utility allows querying and changing settings such as speed, port, auto-negotiation, PCI locations and checksum offload on many network devices, especially Ethernet devices. 
 </para>
 
-<para>We present here a short selection of often used <application>ethtool</application> commands together with some useful commands that are not well known. For a full list of commands type <command>ethtool -h</command> or refer to the man page, <filename>ethtool(8)</filename>, for a more verbose list and explanation. The first two examples are information queries and show the use of the different formats of the command.</para> <para>But first, the command structure:</para>
+<para>We present here a short selection of often used <application>ethtool</application> commands together with some useful commands that are not well known. For a full list of commands type <command>ethtool -h</command> or refer to the man page, <filename>ethtool(8)</filename>, for a more comprehensive list and explanation. The first two examples are information queries and show the use of the different formats of the command.</para><para>But first, the command structure:</para>
 
 <variablelist>
 
@@ -696,7 +696,7 @@ ONBOOT=yes</programlisting>
 
 </variablelist>
          <para>
- Some values can only be obtained when the command is run as root. Here is an example of the output when the command is run as root:
+ Some values can only be obtained when the command is run as <systemitem class="username">root</systemitem>. Here is an example of the output when the command is run as <systemitem class="username">root</systemitem>:
  </para>
  <screen>
 ~]# <command>ethtool em1</command>
@@ -1725,7 +1725,7 @@ Interface being brought down
           </row>
            <row>
             <entry>
-                           rx_status 
+                           rx_status
             </entry>
             <entry>
                      0x0800


More information about the docs-commits mailing list