From nobody@FreeBSD.org  Thu Aug 15 19:02:14 2013
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
	(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by hub.freebsd.org (Postfix) with ESMTP id 84A6B7E7
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 15 Aug 2013 19:02:14 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from oldred.freebsd.org (oldred.freebsd.org [8.8.178.121])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by mx1.freebsd.org (Postfix) with ESMTPS id 715E4234F
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 15 Aug 2013 19:02:14 +0000 (UTC)
Received: from oldred.freebsd.org ([127.0.1.6])
	by oldred.freebsd.org (8.14.5/8.14.7) with ESMTP id r7FJ2CMl040019
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 15 Aug 2013 19:02:12 GMT
	(envelope-from nobody@oldred.freebsd.org)
Received: (from nobody@localhost)
	by oldred.freebsd.org (8.14.5/8.14.5/Submit) id r7FJ2CFH040015;
	Thu, 15 Aug 2013 19:02:12 GMT
	(envelope-from nobody)
Message-Id: <201308151902.r7FJ2CFH040015@oldred.freebsd.org>
Date: Thu, 15 Aug 2013 19:02:12 GMT
From: Keve Nagy <keve@safe-mail.net>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Typo (missing letter) in example dhcpd config for netboot.
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         181331
>Category:       docs
>Synopsis:       Typo (missing letter) in example dhcpd config for netboot.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    wblock
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Aug 15 19:10:00 UTC 2013
>Closed-Date:    Thu Aug 15 20:46:24 UTC 2013
>Last-Modified:  Thu Aug 15 20:50:00 UTC 2013
>Originator:     Keve Nagy
>Release:        N/A
>Organization:
N/A
>Environment:
N/A
>Description:
There is a typo in the example configuration code for dhcpd in the netboot section of the handbook.
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-pxe-nfs.html
Section 31.8.3. Setting up the DHCP Server, step 2, sample config line #6.
  option domain-name-server 192.168.35.35, 192.168.35.36 ;
A letter "s" is missing from the end of the second word, making domain-name-server in singular instead of plural. The correct line should read
  option domain-name-servers 192.168.35.35, 192.168.35.36 ;

I was trying to do some testing today, following the handbook step by step. ISC DHCPD refuses to start with the incorrectly spelt keyword in it. It does not recognize "domain-name-server", it only recognizes the plural form as "domain-name-servers".
As the incorrect form is actually a proper English expression and the line without the pluralizing "s" makes perfect sense (especially when one has a single nameserver to define), it is easy to make the mistake. For the same reason, it could be very difficult for an inexperienced sysadmin or a beginner FreeBSD user to spot the problem.
This should be corrected as soon as anyone with access right to the documentation source can afford the time and energy to commit the correction.
>How-To-Repeat:
Follow chapter 31.8.3 of the handbook to the letter and make the spelling mistake shown in the example configuration code.
>Fix:
Replace the line
  option domain-name-server 192.168.35.35, 192.168.35.36 ;
with
  option domain-name-servers 192.168.35.35, 192.168.35.36 ;
adding a pluralizing "s" to the end of keyword domain-name-serverS.


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->wblock 
Responsible-Changed-By: wblock 
Responsible-Changed-When: Thu Aug 15 20:39:50 UTC 2013 
Responsible-Changed-Why:  
Take. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=181331 
State-Changed-From-To: open->closed 
State-Changed-By: wblock 
State-Changed-When: Thu Aug 15 20:46:03 UTC 2013 
State-Changed-Why:  
Change committed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=181331 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/181331: commit references a PR
Date: Thu, 15 Aug 2013 20:46:00 +0000 (UTC)

 Author: wblock
 Date: Thu Aug 15 20:45:50 2013
 New Revision: 42550
 URL: http://svnweb.freebsd.org/changeset/doc/42550
 
 Log:
   Correct "domain-name-server" to the plural form.
   
   PR:		docs/181331
   Submitted by:	Keve Nagy <keve@safe-mail.net>
 
 Modified:
   head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml
 
 Modified: head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml	Thu Aug 15 02:39:21 2013	(r42549)
 +++ head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml	Thu Aug 15 20:45:50 2013	(r42550)
 @@ -4468,7 +4468,7 @@ myhost.example.com:/b/tftpboot/FreeBSD/i
     option subnet-mask 255.255.255.0 ;
     option routers 192.168.0.1 ;
     option broadcast-address 192.168.0.255 ;
 -   option domain-name-server 192.168.35.35, 192.168.35.36 ;
 +   option domain-name-servers 192.168.35.35, 192.168.35.36 ;
     option domain-name "example.com";
  
     # IP address of TFTP server
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 
>Unformatted:
