Changeset f07d91ba for chapter08

Timestamp:

12/11/2022 10:29:49 PM (17 months ago)

Author:

David Bryant <davidbryant@…>

Branches:

11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, bdubbs/gcc13, multilib, renodr/libudev-from-systemd, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/update-glibc

Children:

75aef88

Parents:

2fe0fd1

Message:

Corrected idiom in section about "arpd". Corrected spelling of "front
end" -- it's twp words, not one. Changed square brackets to parentheses;
square brackets should only be used to delimit editorial remarks. Removed
one definite article referring to the plural; "the" implies a single
object. Changed "amount" to "number". In English, an amount refers to
a continuous quantity, while a number refers to discrete objects (like
networking packetts). Added a qualifier in the description of "ip":
the list of commands is not exhaustive. Modified a few program
descriptons to improve consistency of style. Changed QOS and COS
to QoS and CoS after researching these abbreviations on the internet.
"Quality of Service" and "Class of Service" appear, to me, to be the
most common way of writing these phrases.

File:

• chapter08/iproute2.xml (modified) (10 diffs)

chapter08/iproute2.xml

@@ -43 +43 @@
 
     <para>The <command>arpd</command> program included in this package will not
-    be built since it is dependent on Berkeley DB, which is not installed in
-    LFS. However, a directory for <command>arpd</command> and a man page will still
-    be installed. Prevent this by running the commands below.
-    If the <command>arpd</command> binary is needed,
-    instructions for compiling Berkeley DB can be found in the BLFS Book at
-    <ulink url="&blfs-book;server/db.html"/>.
+    be built since it depends on Berkeley DB, which is not installed in
+    LFS. However, a directory and a man page for <command>arpd</command> will still
+    be installed. Prevent this by running the commands shown below.
+    (If the <command>arpd</command> program is needed,
+    instructions for compiling Berkeley DB can be found in the BLFS book at
+    <ulink url="&blfs-book;server/db.html"/>.)
     </para>
 
@@ -130 +130 @@
         <term><command>genl</command></term>
         <listitem>
-          <para>Generic netlink utility frontend</para>
+          <para>Generic netlink utility front end</para>
           <indexterm zone="ch-system-iproute2 genl">
             <primary sortas="b-genl">genl</primary>
@@ -141 +141 @@
         <listitem>
           <para>A shell script wrapper for the <command>ip</command> command
-          [Note that it requires the <command>arping</command> and
+          (Note that this script requires the <command>arping</command> and
           <command>rdisk</command> programs from the
-          iputils package found at <ulink url="http://www.skbuff.net/iputils/"/>.]</para>
+          iputils package found at <ulink url="http://www.skbuff.net/iputils/"/>.)</para>
           <indexterm zone="ch-system-iproute2 ifcfg">
             <primary sortas="b-ifcfg">ifcfg</primary>
@@ -153 +153 @@
         <term><command>ifstat</command></term>
         <listitem>
-          <para>Shows the interface statistics, including the amount of
-          transmitted and received packets by interface</para>
+          <para>Shows interface statistics, including the number of
+          packets transmitted and received, by interface</para>
           <indexterm zone="ch-system-iproute2 ifstat">
             <primary sortas="b-ifstat">ifstat</primary>
@@ -164 +164 @@
         <term><command>ip</command></term>
         <listitem>
-          <para>The main executable. It has several different functions:</para>
+          <para>The main executable. It has several different functions, including these:</para>
 
           <para><command>ip link <replaceable>&lt;device&gt;</replaceable></command>
@@ -214 +214 @@
         <term><command>nstat</command></term>
         <listitem>
-          <para>Shows network statistics</para>
+          <para>Displays network statistics</para>
           <indexterm zone="ch-system-iproute2 nstat">
             <primary sortas="b-nstat">nstat</primary>
@@ -224 +224 @@
         <term><command>routef</command></term>
         <listitem>
-          <para>A component of <command>ip route</command>. This is for flushing
+          <para>A component of <command>ip route</command>, for flushing
           the routing tables</para>
           <indexterm zone="ch-system-iproute2 routef">
@@ -235 +235 @@
         <term><command>routel</command></term>
         <listitem>
-          <para>A component of <command>ip route</command>. This is for listing
+          <para>A component of <command>ip route</command>, for listing
           the routing tables</para>
           <indexterm zone="ch-system-iproute2 routel">
@@ -267 +267 @@
         <term><command>rtpr</command></term>
         <listitem>
-          <para>Converts the output of <command>ip -o</command> back into a
+          <para>Converts the output of <command>ip -o</command> into a
           readable form</para>
           <indexterm zone="ch-system-iproute2 rtpr">
@@ -296 +296 @@
       </varlistentry>
 
+      <!-- FixMe These options don't match tc -help screen -->
       <varlistentry id="tc">
         <term><command>tc</command></term>
         <listitem>
-          <para>Traffic Controlling Executable; this is for Quality Of Service
-          (QOS) and Class Of Service (COS) implementations</para>
-
-          <para><command>tc qdisc</command> allows users to setup the queueing
+          <para>Traffic control for Quality of Service
+          (QoS) and Class of Service (CoS) implementations</para>
+
+          <para><command>tc qdisc</command> allows users to set up the queueing
           discipline</para>
 
-          <para><command>tc class</command> allows users to setup classes based
+          <para><command>tc class</command> allows users to set up classes based
           on the queuing discipline scheduling</para>
 
           <para><command>tc estimator</command> allows users to estimate the
-          network flow into a network</para>
-
-          <para><command>tc filter</command> allows users to setup the QOS/COS
+          data flow through a network</para>
+
+          <para><command>tc filter</command> allows users to set up the QoS/CoS
           packet filtering</para>
 
-          <para><command>tc policy</command> allows users to setup the QOS/COS
+          <para><command>tc policy</command> allows users to set up the QoS/CoS
           policies</para>
           <indexterm zone="ch-system-iproute2 ss">