docs/181117: Network Servers and INETD Cleanup

[Ken Reed]

>Number:         181117
>Category:       docs
>Synopsis:       Network Servers and INETD Cleanup
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Aug 07 17:10:00 UTC 2013
>Closed-Date:
>Last-Modified:
>Originator:     Ken Reed
>Release:        9.1-Release-p5
>Organization:
>Environment:
FreeBSD chaos 9.1-RELEASE-p5 FreeBSD 9.1-RELEASE-p5 #0: Sat Jul 27 01:14:23 UTC 2013     root at amd64-builder.daemonology.net:/usr/obj/usr/src/sys/GENERIC  amd64
>Description:
Removing a duplicate line in network-servers.html, then modifying some text and making tags consistent in both that and network-inetd.html.
>How-To-Repeat:

>Fix:


Patch attached with submission follows:

Index: en_US.ISO8859-1/books/handbook/network-servers/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/handbook/network-servers/chapter.xml	(revision 42517)
+++ en_US.ISO8859-1/books/handbook/network-servers/chapter.xml	(working copy)
@@ -23,12 +23,13 @@
     <title>Synopsis</title>
 
     <para>This chapter will cover some of the more frequently used
-      network services on &unix; systems.  We will cover how to
-      install, configure, test, and maintain many different types of
-      network services.  Example configuration files are included
-      throughout this chapter for you to benefit from.</para>
+      	network services on &unix; systems.  This will include how to
+      	install, configure, test, and maintain the many different types 
+	of network services.  As an added convenience, example 
+	configuration files are included throughout this chapter 
+	for you to benefit from.</para>
 
-    <para>After reading this chapter, you will know:</para>
+    <para>At the end of this chapter, readers should know:</para>
 
     <itemizedlist>
 
@@ -38,41 +39,39 @@
       </listitem>
 
       <listitem>
-	<para>How to set up a network file system.</para>
+	<para>How to set up the Network File System
+	(<acronym>NFS</acronym>).</para>
       </listitem>
 
       <listitem>
-	<para>How to set up a network information server for sharing
-	  user accounts.</para>
+	<para>How to set up the network information server
+	(<acronym>NIS</acronym>) for centralizing and sharing user accounts.
+	</para>
       </listitem>
 
       <listitem>
 	<para>How to set &os; up to act as an <acronym>LDAP</acronym>
-	  server or client</para>
+	  server or client.</para>
       </listitem>
 
       <listitem>
-	<para>How to set &os; up to act as an <acronym>LDAP</acronym>
-	  server or client</para>
-      </listitem>
-
-      <listitem>
 	<para>How to set up automatic network settings using
-	  DHCP.</para>
+	  <acronym>DHCP</acronym>.</para>
       </listitem>
 
       <listitem>
-	<para>How to set up a domain name server.</para>
+	<para>How to set up a domain name server
+	(<acronym>DNS</acronym>).</para>
       </listitem>
 
       <listitem>
 	<para>How to set up the <application>Apache</application>
-	  HTTP Server.</para>
+	  <acronym>HTTP</acronym> Server.</para>
       </listitem>
 
       <listitem>
-	<para>How to set up a File Transfer Protocol (FTP)
-	  Server.</para>
+	<para>How to set up a File Transfer Protocol
+	(<acronym> FTP</acronym>) Server.</para>
       </listitem>
 
       <listitem>
@@ -82,7 +81,8 @@
 
       <listitem>
 	<para>How to synchronize the time and date, and set up a
-	  time server, with the NTP protocol.</para>
+	time server with the Network Time Protocol
+	(<acronym>NTP</acronym>).</para>
       </listitem>
 
       <listitem>
@@ -93,7 +93,7 @@
 
     </itemizedlist>
 
-    <para>Before reading this chapter, you should:</para>
+    <para>Reading this chapter assumes a basic knowledge of:</para>
 
     <itemizedlist>
       <listitem>
@@ -102,11 +102,11 @@
       </listitem>
 
       <listitem>
-	<para>Be familiar with basic network terminology.</para>
+	<para>Basic network terminology.</para>
       </listitem>
 
       <listitem>
-	<para>Know how to install additional third-party
+	<para>Ability to install additional third-party
 	  software (<xref linkend="ports"/>).</para>
       </listitem>
 
@@ -210,12 +210,12 @@
 	single IP address from requesting any service more than 60
 	times in any given minute.</para>
 
-      <para>Although we mention rate-limiting options below, novice
-	users may be pleased to note that these parameters usually do
-	not need to be modified.  These options may be useful if
-	an excessive amount of connections are being established.
-	A full list of options can be found in the
-	&man.inetd.8; manual.</para>
+      <para>Although the following examples include rate-limiting
+	options below, novice users should be aware that
+	these parameters usually do not need to be modified.
+	These options may be useful if an excessive amount of
+	connections are being established.  A full list of
+	options can be found in the &man.inetd.8; manual page.</para>
 
       <variablelist>
 	<varlistentry>
@@ -1850,7 +1850,7 @@
 
 	      <note>
 		<para>Keep in mind that at least one local account
-		  (i.e. not imported via NIS) must exist in
+		  (i.e., not imported via NIS) must exist in
 		  <filename>/etc/master.passwd</filename> and this
 		  account should also be a member of the group
 		  <groupname>wheel</groupname>.  If there is something


>Release-Note:
>Audit-Trail:
>Unformatted: