From pepper@guest.reppep.com  Fri Jul 26 20:14:17 2002
Return-Path: <pepper@guest.reppep.com>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 890B737B400
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 26 Jul 2002 20:14:17 -0700 (PDT)
Received: from guest.reppep.com (guest.reppep.com [64.81.19.110])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 18B5443E42
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 26 Jul 2002 20:14:17 -0700 (PDT)
	(envelope-from pepper@guest.reppep.com)
Received: by guest.reppep.com (Postfix, from userid 501)
	id 39FEFFDD8; Fri, 26 Jul 2002 23:14:22 -0400 (EDT)
Message-Id: <20020727031422.39FEFFDD8@guest.reppep.com>
Date: Fri, 26 Jul 2002 23:14:22 -0400 (EDT)
From: Chris Pepper <pepper@rockefeller.edu>
Reply-To: Chris Pepper <pepper@rockefeller.edu>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] Typos in /etc/named/named.conf comments
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         41034
>Category:       docs
>Synopsis:       [PATCH] Typos in /etc/named/named.conf comments
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 26 20:20:01 PDT 2002
>Closed-Date:    Thu Feb 13 05:24:32 PST 2003
>Last-Modified:  Thu Feb 13 05:24:32 PST 2003
>Originator:     Chris Pepper
>Release:        FreeBSD 4.6-STABLE i386
>Organization:
>Environment:
System: FreeBSD guest.reppep.com 4.6-STABLE FreeBSD 4.6-STABLE #3: Fri Jul 26 19:51:33 EDT 2002 root@guest.reppep.com:/usr/obj/usr/src/sys/GENERIC i386


	
>Description:
	The default named.conf comments are ungramattical.
>How-To-Repeat:
	more /etc/named/named.conf
>Fix:
	Apply this patch.

--- named.conf.diff begins here ---
--- named.conf	Fri Jul 26 23:07:23 2002
+++ named.conf.fixed	Fri Jul 26 23:11:25 2002
@@ -1,10 +1,10 @@
 // $FreeBSD: src/etc/namedb/named.conf,v 1.6.2.5 2002/02/04 18:24:21 ume Exp $
 //
 // Refer to the named.conf(5) and named(8) man pages for details.  If
-// you are ever going to setup a primary server, make sure you've
-// understood the hairy details of how DNS is working.  Even with
+// you are ever going to set up a primary server, make sure you
+// understand the hairy details of how DNS works.  Even with
 // simple mistakes, you can break connectivity for affected parties,
-// or cause huge amount of useless Internet traffic.
+// or cause huge amounts of useless Internet traffic.
 
 options {
 	directory "/etc/namedb";
@@ -16,8 +16,8 @@
 //      forward only;
 
 // If you've got a DNS server around at your upstream provider, enter
-// its IP address here, and enable the line below.  This will make you
-// benefit from its cache, thus reduce overall DNS traffic in the Internet.
+// its IP address here, and enable the entry below.  This will let you
+// benefit from its cache, thus reducing overall DNS traffic on the Internet.
 /*
 	forwarders {
 		127.0.0.1;
@@ -48,11 +48,11 @@
 };
 */
 
-// Setting up secondaries is way easier and the rough picture for this
-// is explained below.
+// Setting up secondaries is way easier and a rough example for this
+// is provided below.
 //
 // If you enable a local name server, don't forget to enter 127.0.0.1
-// into your /etc/resolv.conf so this server will be queried first.
+// first in your /etc/resolv.conf so this server will be queried.
 // Also, make sure to enable it in /etc/rc.conf.
 
 zone "." {
@@ -74,17 +74,17 @@
 // serve demonstration/documentation purposes!
 //
 // Example secondary config entries.  It can be convenient to become
-// a secondary at least for the zone where your own domain is in.  Ask
+// a secondary at least for the zone your own domain is in.  Ask
 // your network administrator for the IP address of the responsible
 // primary.
 //
 // Never forget to include the reverse lookup (IN-ADDR.ARPA) zone!
-// (This is the first bytes of the respective IP address, in reverse
+// (This is named after the first bytes of the IP address, in reverse
 // order, with ".IN-ADDR.ARPA" appended.)
 //
-// Before starting to setup a primary zone, better make sure you fully
-// understand how DNS and BIND works, however.  There are sometimes
-// unobvious pitfalls.  Setting up a secondary is comparably simpler.
+// Before starting to set up a primary zone, make sure you fully
+// understand how DNS and BIND works.  There are sometimes
+// non-obvious pitfalls.  Setting up a secondary is simpler.
 //
 // NB: Don't blindly enable the examples below. :-)  Use actual names
 // and addresses instead.
--- named.conf.diff ends here ---


>Release-Note:
>Audit-Trail:

From: "M.J.Kouache" <mjk@rhoda.fsworld.co.uk>
To: freebsd-gnats-submit@FreeBSD.org, pepper@rockefeller.edu
Cc:  
Subject: Re: docs/41034: [PATCH] Typos in /etc/named/named.conf comments
Date: Tue, 30 Jul 2002 05:36:23 +0100

  ... before that all gets commited :), substitute this in the relevant place above,
 the only difference is an apostrophe on "it's".
 
 @@ -16,8 +16,8 @@
  //      forward only;
  
  // If you've got a DNS server around at your upstream provider, enter
 -// its IP address here, and enable the line below.  This will make you
 -// benefit from its cache, thus reduce overall DNS traffic in the Internet.
 +// it's IP address here, and enable the entry below.  This will let you
 +// benefit from its cache, thus reducing overall DNS traffic on the Internet.
  /*
  	forwarders {
  		127.0.0.1;
 
 
 

From: "M.J.Kouache" <mjk@rhoda.fsworld.co.uk>
To: freebsd-gnats-submit@FreeBSD.org, pepper@rockefeller.edu
Cc:  
Subject: Re: docs/41034: [PATCH] Typos in /etc/named/named.conf comments
Date: Tue, 30 Jul 2002 13:43:08 +0100

 Please ignore my previous submission.
 
 Dontya just love making a fool of youself in public ?
 
 

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Tom Hukins <tom@FreeBSD.org>
Cc: "M.J.Kouache" <mjk@rhoda.fsworld.co.uk>, bug-followup@FreeBSD.org
Subject: Re: docs/41034: [PATCH] Typos in /etc/named/named.conf comments
Date: Tue, 6 Aug 2002 23:53:54 +0300

 On 2002-07-30 09:51 +0000, Tom Hukins wrote:
 > On Mon, Jul 29, 2002 at 09:40:04PM -0700, M.J.Kouache wrote:
 > >   ... before that all gets commited :), substitute this in the relevant place above,
 > >  the only difference is an apostrophe on "it's".
 > >
 > >  @@ -16,8 +16,8 @@
 > >   //      forward only;
 > >
 > >   // If you've got a DNS server around at your upstream provider, enter
 > >  -// its IP address here, and enable the line below.  This will make you
 > >  -// benefit from its cache, thus reduce overall DNS traffic in the Internet.
 > >  +// it's IP address here, and enable the entry below.  This will let you
 > >  +// benefit from its cache, thus reducing overall DNS traffic on the Internet.
 >
 > This part of the patch is incorrect.  In the posessive form, "its" is
 > the correct spelling.
 
 The second change of the first line, s/make you/let you/ and the
 second line of changes though seem like a good idea to me.  What do
 you others think?
 
 - Giorgos
 

From: Tom Hukins <tom@FreeBSD.org>
To: Giorgos Keramidas <keramida@FreeBSD.org>
Cc: "M.J.Kouache" <mjk@rhoda.fsworld.co.uk>, bug-followup@FreeBSD.org
Subject: Re: docs/41034: [PATCH] Typos in /etc/named/named.conf comments
Date: Wed, 7 Aug 2002 09:12:39 +0100

 On Tue, Aug 06, 2002 at 11:53:54PM +0300, Giorgos Keramidas wrote:
 > On 2002-07-30 09:51 +0000, Tom Hukins wrote:
 > > On Mon, Jul 29, 2002 at 09:40:04PM -0700, M.J.Kouache wrote:
 > > >
 > > >  -// its IP address here, and enable the line below.  This will make you
 > > >  -// benefit from its cache, thus reduce overall DNS traffic in the Internet.
 > > >  +// it's IP address here, and enable the entry below.  This will let you
 > > >  +// benefit from its cache, thus reducing overall DNS traffic on the Internet.
 > >
 > > This part of the patch is incorrect.  In the posessive form, "its" is
 > > the correct spelling.
 > 
 > The second change of the first line, s/make you/let you/ and the
 > second line of changes though seem like a good idea to me.  What do
 > you others think?
 
 Yes,  I should have been clearer: I agree with the patch apart from
 the "its" to "it's" change.
 
 Tom

From: Chris Pepper <pepper@reppep.com>
To: Tom Hukins <tom@FreeBSD.org>
Cc: freebsd-doc@FreeBSD.org,
	Giorgos Keramidas <keramida@FreeBSD.org>,
	"M.J.Kouache" <mjk@rhoda.fsworld.co.uk>, bug-followup@FreeBSD.org
Subject: Re: docs/41034: [PATCH] Typos in /etc/named/named.conf comments
Date: Fri, 4 Oct 2002 21:49:31 -0400

 At 1:20 AM -0700 2002/08/07, Tom Hukins wrote:
 >The following reply was made to PR docs/41034; it has been noted by GNATS.
 >
 >From: Tom Hukins <tom@FreeBSD.org>
 >To: Giorgos Keramidas <keramida@FreeBSD.org>
 >Cc: "M.J.Kouache" <mjk@rhoda.fsworld.co.uk>, bug-followup@FreeBSD.org
 >Subject: Re: docs/41034: [PATCH] Typos in /etc/named/named.conf comments
 >Date: Wed, 7 Aug 2002 09:12:39 +0100
 >
 >  On Tue, Aug 06, 2002 at 11:53:54PM +0300, Giorgos Keramidas wrote:
 >  > On 2002-07-30 09:51 +0000, Tom Hukins wrote:
 >  > > On Mon, Jul 29, 2002 at 09:40:04PM -0700, M.J.Kouache wrote:
 >  > > >
 >  > > >  -// its IP address here, and enable the line below.  This 
 >will make you
 >  > > >  -// benefit from its cache, thus reduce overall DNS traffic 
 >in the Internet.
 >  > > >  +// it's IP address here, and enable the entry below.  This 
 >will let you
 >  > > >  +// benefit from its cache, thus reducing overall DNS 
 >traffic on the Internet.
 >  > >
 >  > > This part of the patch is incorrect.  In the posessive form, "its" is
 >  > > the correct spelling.
 >  >
 >  > The second change of the first line, s/make you/let you/ and the
 >  > second line of changes though seem like a good idea to me.  What do
 >  > you others think?
 >
 >  Yes,  I should have been clearer: I agree with the patch apart from
 >  the "its" to "it's" change.
 
 Tom,
 
 	You're right -- that's a straight error on my part.
 
 	Somebody please apply the rest.
 
 
 						Thanks,
 
 
 						Chris Pepper
 -- 
 Chris Pepper:               <http://www.reppep.com/~pepper/>
 Rockefeller University:     <http://www.rockefeller.edu/>
State-Changed-From-To: open->patched 
State-Changed-By: keramida 
State-Changed-When: Fri Feb 7 12:58:59 PST 2003 
State-Changed-Why:  
Committed all the changes except for `its -> it's' in current. 


Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Fri Feb 7 12:58:59 PST 2003 
Responsible-Changed-Why:  
I'll do the MFC. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=41034 
State-Changed-From-To: patched->closed 
State-Changed-By: keramida 
State-Changed-When: Thu Feb 13 05:23:57 PST 2003 
State-Changed-Why:  
Merged to -STABLE.  Thank you, Chris :) 

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