Bug 63570

Summary: [patch] Language cleanup for the Handbook's DNS section
Product: Documentation Reporter: Chris Pepper <pepper>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me CC: chern
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
chapter.sgml.diff none

Description Chris Pepper 2004-03-01 04:30:16 UTC
	Picked a bunch of language and consistency nits in the DNS networking section.
	As written, slaves only reply when the primary is down; this is not the case.
	Added a mention that there must be two authoritative servers.
	Revised caching terminology; among other things, caching is rarely *necessary*, but often valuable.
	At some point, cached records expire, so external lookups are required again.


	In addition, there's a deeper problem I didn't change. The two paragraphs below imply that slaves and masters are mutually exclusive. For all domains I've deal with, ns2 is a slave from ns1, but listed with an NS record in the zone, and thus authoritative as well. The terminolgy should probably be either clarified or changed, but I don't have a solution to propose at this point.
	
	  <para>a backup name server, called a slave, must reply to queries
	    when the primary is down or inaccessible.</para>

        <para>In the slave case, the zone information is transferred from
	  the master name server for the particular zone, and saved in the
	  file specified.  If and when the master server dies or is
	  unreachable, the slave name server will have the transferred
	  zone information and will be able to serve it.</para>
      </sect3>

Fix: Apply this patch. 
	
How-To-Repeat: 	Visit http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-dns.html
Comment 1 Ceri Davies freebsd_committer freebsd_triage 2004-03-01 11:47:20 UTC
Responsible Changed
From-To: freebsd-doc->ceri

I'll take this one.
Comment 2 Ceri Davies freebsd_committer freebsd_triage 2008-11-02 22:41:42 UTC
Responsible Changed
From-To: ceri->freebsd-doc

I don't really belong in the FreeBSD project anymomre.
Comment 3 Christian Brueffer freebsd_committer freebsd_triage 2010-05-14 16:28:57 UTC
State Changed
From-To: open->closed

The DNS section has been reworked some time ago. I applied the 
still applicable changes in the patch, thanks!
Comment 4 dfilter service freebsd_committer freebsd_triage 2010-05-14 16:29:01 UTC
brueffer    2010-05-14 15:28:53 UTC

  FreeBSD doc repository

  Modified files:
    en_US.ISO8859-1/books/handbook/network-servers chapter.sgml 
  Log:
  Improved wording in the DNS section.
  
  PR:             63570
  Submitted by:   Chris Pepper <pepper@reppep.com>
  
  Revision  Changes    Path
  1.121     +9 -9      doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"