From darklogik@pittgoth.com  Fri Mar  8 12:31:49 2002
Return-Path: <darklogik@pittgoth.com>
Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111])
	by hub.freebsd.org (Postfix) with ESMTP id 169BC37B402
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  8 Mar 2002 12:31:45 -0800 (PST)
Received: (from darklogik@localhost)
	by pittgoth.com (8.11.6/8.11.6) id g28KXni00640;
	Fri, 8 Mar 2002 15:33:49 -0500 (EST)
	(envelope-from darklogik)
Message-Id: <200203082033.g28KXni00640@pittgoth.com>
Date: Fri, 8 Mar 2002 15:33:49 -0500 (EST)
From: Tom Rhodes <darklogik@pittgoth.com>
Reply-To: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Fix amd info
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         35683
>Category:       docs
>Synopsis:       Fix amd info
>Confidential:   no
>Severity:       serious
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Mar 08 12:40:05 PST 2002
>Closed-Date:    Thu Mar 21 22:32:37 PST 2002
>Last-Modified:  Thu Mar 21 22:32:37 PST 2002
>Originator:     Tom Rhodes
>Release:        FreeBSD 4.5-RELEASE i386
>Organization:
FreeBSD Project	
>Environment:
System: FreeBSD pittgoth.com 4.5-RELEASE FreeBSD 4.5-RELEASE #2: Thu Feb 21 23:00:49 EST 2002 root@pittgoth.com:/usr/src/sys/compile/PITTGOTH i386


	
>Description:
Now that the NFS section is updated, i'm gonna wack at other parts
of the advanced networking chapter ;) I just did not like using daemon
2 times in the same sentance like this...
>How-To-Repeat:
Read the handbook
>Fix:
Apply this patch...
	

--- amd1.diff begins here ---
diff -ru handbook/advanced-networking/chapter.sgml handbook.new/advanced-networking/chapter.sgml
--- handbook/advanced-networking/chapter.sgml	Thu Mar  7 18:55:11 2002
+++ handbook.new/advanced-networking/chapter.sgml	Fri Mar  8 13:58:10 2002
@@ -988,13 +988,13 @@
       <indexterm><primary>automatic mounter daemon</primary></indexterm>
 
       <para>&man.amd.8; (the automatic mounter daemon)
-	is a useful daemon that automatically mounts a
+	automatically mounts a
 	remote filesystem whenever a file or directory within that
 	filesystem is accessed.  Filesystems that are inactive for a
 	period of time will also be automatically unmounted by
 	<application>amd</application>.  Using
 	<application>amd</application> provides a simple alternative
-	to permanent mounts, as permanent mounts should be listed in the
+	to permanent mounts, as permanent mounts are usually listed in the
         <filename>/etc/fstab</filename>.</para>
 
       <para><application>amd</application> operates by attaching
--- amd1.diff ends here ---


>Release-Note:
>Audit-Trail:

From: Udo Erdelhoff <ue@nathan.ruhr.de>
To: Tom Rhodes <darklogik@pittgoth.com>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/35683: Fix amd info
Date: Fri, 8 Mar 2002 23:46:23 +0100

 Hi,
 On Fri, Mar 08, 2002 at 03:33:49PM -0500, Tom Rhodes wrote:
 
 > -	to permanent mounts, as permanent mounts should be listed in the
 > +	to permanent mounts, as permanent mounts are usually listed in the
 
 one additional suggestion: Please use "are usually listed in
 <filename>/etc/fstab</filename>", i.e. drop the word "the".
 
 /s/Udo
 -- 
 >Every program evolves until it is capable of sending email.
 Except Microsoft Exchange

From: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/35683: [PATCH] Fix amd info
Date: Sat, 9 Mar 2002 11:43:56 -0500 (EST)

 I like your suggestion Udo, I killed the nitpick word "the" and
 did a little more than just that.  This patch is a tad bit larger,
 and I would either like some comments or a commit.  I did not like
 the use of the word "access" 3 times in one sentence.  Here is a proposed
 rewording of that sentence, natd section.
 
 --
 Tom Rhodes
 
 diff -ru handbook/advanced-networking/chapter.sgml handbook.new/advanced-networking/chapter.sgml
 --- handbook/advanced-networking/chapter.sgml	Thu Mar  7 18:55:11 2002
 +++ handbook.new/advanced-networking/chapter.sgml	Sat Mar  9 11:37:19 2002
 @@ -988,13 +988,13 @@
        <indexterm><primary>automatic mounter daemon</primary></indexterm>
  
        <para>&man.amd.8; (the automatic mounter daemon)
 -	is a useful daemon that automatically mounts a
 +	automatically mounts a
  	remote filesystem whenever a file or directory within that
  	filesystem is accessed.  Filesystems that are inactive for a
  	period of time will also be automatically unmounted by
  	<application>amd</application>.  Using
  	<application>amd</application> provides a simple alternative
 -	to permanent mounts, as permanent mounts should be listed in the
 +	to permanent mounts, as permanent mounts are usually listed in
          <filename>/etc/fstab</filename>.</para>
  
        <para><application>amd</application> operates by attaching
 @@ -4796,7 +4796,7 @@
        <title>Setup</title>
        <para>Due to the diminishing IP space in IPv4, and the increased number
          of users on high-speed consumer lines such as cable or DSL, people are
 -        in more and more need of an Internet Connection Sharing solution.  The
 +        more in need of an Internet Connection Sharing solution.  The
          ability to connect several computers online through one connection and
          IP address makes &man.natd.8; a reasonable choice.</para>
  
 @@ -4831,9 +4831,9 @@
  	</textobject>
        </mediaobject>
  
 -      <para>With this setup, the machine without Internet access can use
 -        the machine with access as a gateway to access the outside 
 -        world.</para>
 +      <para>With a setup such as this, a machine not connected to the
 +        internet directly can still access the internet through
 +        the <acronym>LAN</acronym>.</para>
      </sect2>
  
      <sect2 id="configuration">

From: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@FreeBSD.org,
	Michael Lucas <mwlucas@blackhelicopters.org>
Cc:  
Subject: Re: docs/35683: Fix amd info
Date: Mon, 11 Mar 2002 10:57:53 -0500

 Apologies to all that this is listed a ``serious'' pr.  I did not wish 
 to do that, and was a slight mistake.  Instead of keeping this pr open, 
 lets apply the patch (if no objections) and close this pr.  A new one 
 will be opened afterwords ;)  Enjoy, and thanks!
 
 -- 
 Tom (Darklogik) Rhodes
 www.Pittgoth.com Gothic Liberation Front
 www.FreeBSD.org  The Power To Serve
 

From: Giorgos Keramidas <keramida@freebsd.org>
To: Tom Rhodes <darklogik@pittgoth.com>
Cc: bug-followup@freebsd.org
Subject: Re: docs/35683: Fix amd info
Date: Thu, 21 Mar 2002 02:09:35 +0200 (EET)

 On 2002-03-09 16:43:56, Tom Rhodes wrote:
 
 >         <para>Due to the diminishing IP space in IPv4, and the increased number
 >           of users on high-speed consumer lines such as cable or DSL, people are
 >  -        in more and more need of an Internet Connection Sharing solution.  The
 >  +        more in need of an Internet Connection Sharing solution.  The
 
 `increasingly' in need?
 
 Other than that, I feel my brain going numb when I try to find a clear way
 to describe the 'gateway' hunk of this patch, without mentioning the word
 'gateway'.  It still seems funny after the patch though :/
 
 Giorgos Keramidas                       FreeBSD Documentation Project
 keramida@{freebsd.org,ceid.upatras.gr}  http://www.FreeBSD.org/docproj/
 

From: Tom Rhodes <darklogik@pittgoth.com>
To: Giorgos Keramidas <keramida@FreeBSD.ORG>
Cc: freebsd-doc@FreeBSD.ORG, FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/35683: Fix amd info
Date: Wed, 20 Mar 2002 20:37:41 -0500

 --=.'z?DcP/f)GXOjH
 Content-Type: text/plain; charset=US-ASCII
 Content-Transfer-Encoding: 7bit
 
 On Wed, 20 Mar 2002 16:10:03 -0800 (PST)
 Giorgos Keramidas <keramida@FreeBSD.ORG> wrote:
 
 > The following reply was made to PR docs/35683; it has been noted by
 > GNATS.
 > 
 > From: Giorgos Keramidas <keramida@freebsd.org>
 > To: Tom Rhodes <darklogik@pittgoth.com>
 > Cc: bug-followup@freebsd.org
 > Subject: Re: docs/35683: Fix amd info
 > Date: Thu, 21 Mar 2002 02:09:35 +0200 (EET)
 > 
 >  On 2002-03-09 16:43:56, Tom Rhodes wrote:
 >  
 >  >         <para>Due to the diminishing IP space in IPv4, and the
 >  >         increased number  of users on high-speed consumer lines
 >  >         such as cable or DSL, people are- in more and more
 >  >         need of an Internet Connection Sharing solution. The+   
 >  >             more in need of an Internet Connection Sharing
 >  >             solution.  The
 >  
 >  `increasingly' in need?
 >  
 >  Other than that, I feel my brain going numb when I try to find a
 >  clear way to describe the 'gateway' hunk of this patch, without
 >  mentioning the word'gateway'.  It still seems funny after the patch
 >  though :/
 >  
 >  Giorgos Keramidas                       FreeBSD Documentation
 >  Project keramida@{freebsd.org,ceid.upatras.gr} 
 >  http://www.FreeBSD.org/docproj/
 
 Maybe...  perhaps...  we could always describe the gateway as ``the
 door to the internet'' or doorway to the outside world...
 
 I like your ``increasingly'' idea, but I do not see the use of
 ``gateway'' in this paragraph.  Here we are kinda opening up
 the natd section and trying to create that vision of understanding
 for our reader.  I'm totally open to suggestions here ;)
 
 -- 
 Tom (Darklogik) Rhodes
 www.FreeBSD.org  -The Power To Serve
 www.Pittgoth.com -Pittgoth Discussion Portal
 
 
 --=.'z?DcP/f)GXOjH
 Content-Type: application/pgp-signature
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.0.6 (FreeBSD)
 
 iD8DBQE8mTlpwPmgiRuevUMRAgjRAKCtN+9lV8/XlRqMT13nyfS2UkJFawCZAXZX
 MRUOYLg/gl5hDN+SPdKbAUU=
 =vm2j
 -----END PGP SIGNATURE-----
 
 --=.'z?DcP/f)GXOjH--
 
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Thu Mar 21 22:30:40 PST 2002 
State-Changed-Why:  
Slightly modified version committed. 
Thanks for helping bring this in shape, both in mail and IRC. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=35683 
>Unformatted:
