From nobody@FreeBSD.org  Mon Mar 23 15:29:59 2009
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 838F21065676
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 23 Mar 2009 15:29:59 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 71BEE8FC12
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 23 Mar 2009 15:29:59 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n2NFTxdw084752
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 23 Mar 2009 15:29:59 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id n2NFTxD3084751;
	Mon, 23 Mar 2009 15:29:59 GMT
	(envelope-from nobody)
Message-Id: <200903231529.n2NFTxD3084751@www.freebsd.org>
Date: Mon, 23 Mar 2009 15:29:59 GMT
From: Rene Ladan <rene@FreeBSD.org>
To: freebsd-gnats-submit@FreeBSD.org
Subject: clean up bibliography list
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         132978
>Category:       docs
>Synopsis:       clean up bibliography list
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Mar 23 15:40:01 UTC 2009
>Closed-Date:    Mon Mar 23 16:24:14 UTC 2009
>Last-Modified:  Mon Mar 23 16:30:03 UTC 2009
>Originator:     Rene Ladan
>Release:        7.1-RELEASE
>Organization:
>Environment:
doc/share/sgml/bibliography.sgml revision 1.9  2004/09/22 19:38:51 ceri

>Description:
The bibliography list in doc/share/sgml/bibliography.sgml contains several pagenums and edition tags which are not completely filled in, and several groups of authors which are not contained in an authorgroup tag.  For consistency, I've lowercased all instances of the word "edition".

See also http://perforce.freebsd.org/changeView.cgi?CH=159678
>How-To-Repeat:

>Fix:


Patch attached with submission follows:

==== //depot/projects/docproj_nl/share/sgml/bibliography.sgml#1 - /home/rene/freebsd/p4/doc/share/sgml/bibliography.sgml ====
@@ -24,9 +24,9 @@
 	<publishername>Sams</publishername>
       </publisher>
 
-      <edition>1st Edition</edition>
+      <edition>1st edition</edition>
 
-      <pagenums>992</pagenums>
+      <pagenums>992 pages</pagenums>
 
       <pubdate>October 2001</pubdate>
 
@@ -45,7 +45,7 @@
 	<publishername>O'Reilly and Associates</publishername>
       </publisher>
 
-      <edition>1st Edition</edition>
+      <edition>1st edition</edition>
 
       <pubdate>June 1994</pubdate>
 
@@ -66,7 +66,7 @@
 	<publishername>O'Reilly and Associates</publishername>
       </publisher>
 
-      <edition>1st Edition</edition>
+      <edition>1st edition</edition>
 
       <pubdate>June 1994</pubdate>
 
@@ -87,7 +87,7 @@
 	<publishername>O'Reilly and Associates</publishername>
       </publisher>
 
-      <edition>1st Edition</edition>
+      <edition>1st edition</edition>
 
       <pubdate>June 1994</pubdate>
 
@@ -108,7 +108,7 @@
 	<publishername>O'Reilly and Associates</publishername>
       </publisher>
 
-      <edition>1st Edition</edition>
+      <edition>1st edition</edition>
 
       <pubdate>June 1994</pubdate>
 
@@ -129,7 +129,7 @@
 	<publishername>O'Reilly and Associates</publishername>
       </publisher>
 
-      <edition>1st Edition</edition>
+      <edition>1st edition</edition>
 
       <pubdate>June 1994</pubdate>
 
@@ -301,7 +301,7 @@
         <publishername>BSDi</publishername>
       </publisher>
 
-      <edition>1st Edition</edition>
+      <edition>1st edition</edition>
 
       <pubdate>November 1999</pubdate>
 
@@ -433,6 +433,7 @@
       <publisher>
         <publishername>Elex Media Komputindo</publishername>
       </publisher>
+      <authorgroup>
       <author>
         <firstname>Onno W</firstname>
         <surname>Purbo</surname>
@@ -449,6 +450,7 @@
         <firstname>Widjil</firstname>
         <surname>Widodo</surname>
       </author>
+      </authorgroup>
     </biblioset>
   </biblioentry>
 
@@ -516,6 +518,7 @@
         <publishername>O'Reilly &amp; Associates, Inc</publishername>
       </publisher>
       <isbn>ISBN 1-56592-512-2</isbn>
+      <authorgroup>
       <author>
         <firstname>Paul Albitz</firstname>
         <surname>Albitz</surname>
@@ -524,8 +527,9 @@
         <firstname>Cricket</firstname>
         <surname>Liu</surname>
       </author>
+      </authorgroup>
       <pubdate>1998</pubdate>
-      <edition>3rd</edition>
+      <edition>3rd edition</edition>
     </biblioset>
   </biblioentry>
 
@@ -536,7 +540,7 @@
         <publishername>O'Reilly &amp; Associates, Inc</publishername>
       </publisher>
       <pubdate>1997</pubdate>
-      <edition>2nd</edition>
+      <edition>2nd edition</edition>
       <author>
         <firstname>Brian</firstname>
         <surname>Costales</surname>
@@ -552,7 +556,7 @@
         <firstname>&AElig;leen</firstname>
         <surname>Frisch</surname>
       </author>
-      <edition>2nd</edition>
+      <edition>2nd edition</edition>
       <publisher>
         <publishername>O'Reilly &amp; Associates</publishername>
       </publisher>
@@ -568,7 +572,7 @@
         <firstname>Craig</firstname>
         <surname>Hunt</surname>
       </author>
-      <edition>2nd</edition>
+      <edition>2nd edition</edition>
       <publisher>
         <publishername>O'Reilly &amp; Associates, Inc</publishername>
       </publisher>
@@ -628,7 +632,8 @@
         <publishername>Prentice Hall</publishername>
       </publisher>
       <pubdate>1995</pubdate>
-      <edition>4th</edition>
+      <edition>4th edition</edition>
+      <authorgroup>
       <author>
         <firstname>Samuel P.</firstname>
         <surname>Harbison</surname>
@@ -637,6 +642,7 @@
         <firstname>Guy L. Jr.</firstname>
         <surname>Steele</surname>
       </author>
+      </authorgroup>
       <isbn>ISBN 0-13-326224-3</isbn>
     </biblioset>
   </biblioentry>
@@ -648,10 +654,16 @@
         <publishername>Prentice Hall</publishername>
       </publisher>
       <pubdate>1998</pubdate>
-      <author>
-        <firstname>Brian, Kernighan and Dennis</firstname>
-        <surname>Ritchie</surname>
-      </author>
+      <authorgroup>
+	<author>
+	  <firstname>Brian</firstname>
+	  <surname>Kernighan</surname>
+	</author>
+	<author>
+	  <firstname>Dennis</firstname>
+	  <surname>Ritchie</surname>
+	</author>
+      </authorgroup> 
       <isbn>ISBN 0-13-110362-9</isbn>
     </biblioset>
   </biblioentry>
@@ -712,7 +724,7 @@
         <publishername>Prentice Hall</publishername>
       </publisher>
       <pubdate>1998</pubdate>
-      <edition>2nd</edition>
+      <edition>2nd edition</edition>
       <isbn>ISBN 0-13-490012-X</isbn>
     </biblioset>
   </biblioentry>
@@ -824,6 +836,7 @@
   <biblioentry id="biblio-tcpipillvol2theimplementation">
     <biblioset relation="book">
       <title>TCP/IP Illustrated, Volume 2: The Implementation</title>
+      <authorgroup>
       <author>
         <firstname>Gary R.</firstname>
         <surname>Wright</surname>
@@ -832,6 +845,7 @@
         <firstname>W. Richard</firstname>
         <surname>Stevens</surname>
       </author>
+      </authorgroup>
       <pubdate>1995</pubdate>
       <publisher>
         <publishername>Addison-Wesley</publishername>
@@ -843,6 +857,7 @@
   <biblioentry id="biblio-firewallsandinternetsecurity">
     <biblioset relation="book">
       <title>Firewalls and Internet Security: Repelling the Wily Hacker</title>
+      <authorgroup>
       <author>
         <firstname>William R.</firstname>
         <surname>CHeswick</surname>
@@ -851,6 +866,7 @@
         <firstname>Steven M.</firstname>
         <surname>Bellovin</surname>
       </author>
+      </authorgroup>
       <publisher>
         <publishername>Addison-Wesley</publishername>
       </publisher>
@@ -862,6 +878,7 @@
   <biblioentry id="biblio-practicalunixsecurity">
     <biblioset relation="book">
       <title>Practical UNIX Security</title>
+      <authorgroup>
       <author>
         <firstname>Simson</firstname>
         <surname>Garfinkel</surname>
@@ -870,8 +887,9 @@
         <firstname>Gene</firstname>
         <surname>Spafford</surname>
       </author>
+      </authorgroup>
       <pubdate>1996</pubdate>
-      <edition>2nd</edition>
+      <edition>2nd edition</edition>
       <publisher>
         <publishername>O'Reilly &amp; Associates, Inc</publishername>
       </publisher>
@@ -897,6 +915,7 @@
   <biblioentry id="biblio-pentiumprocarch">
     <biblioset relation="book">
       <title>Pentium Processor System Architecture</title>
+      <authorgroup>
       <author>
         <firstname>Don</firstname>
         <surname>Anderson</surname>
@@ -905,11 +924,12 @@
         <firstname>Tom</firstname>
         <surname>Shanley</surname>
       </author>
+      </authorgroup>
       <publisher>
         <publishername>Addison-Wesley</publishername>
       </publisher>
       <pubdate>1995</pubdate>
-      <edition>2nd</edition>
+      <edition>2nd edition</edition>
       <isbn>ISBN 0-201-40992-5</isbn>
     </biblioset>
   </biblioentry>
@@ -921,7 +941,7 @@
         <firstname>Richard F.</firstname>
         <surname>Ferraro</surname>
       </author>
-      <edition>3rd</edition>
+      <edition>3rd edition</edition>
       <publisher>
         <publishername>Addison-Wesley</publishername>
       </publisher>
@@ -941,7 +961,7 @@
         <publishername>Addison-Wesley</publishername>
       </publisher>
       <pubdate>1995</pubdate>
-      <edition>3rd</edition>
+      <edition>3rd edition</edition>
       <isbn>ISBN 0-201-40994-1</isbn>
     </biblioset>
   </biblioentry>
@@ -956,7 +976,7 @@
       <publisher>
         <publishername>Addison-Wesley</publishername>
       </publisher>
-      <edition>3rd</edition>
+      <edition>3rd edition</edition>
       <pubdate>1995</pubdate>
       <isbn>ISBN 0-201-40996-8</isbn>
     </biblioset>
@@ -973,7 +993,7 @@
         <publishername>Addison-Wesley</publishername>
       </publisher>
       <pubdate>1995</pubdate>
-      <edition>3rd</edition>
+      <edition>3rd edition</edition>
       <isbn>ISBN 0-201-40993-3</isbn>
     </biblioset>
   </biblioentry>
@@ -1016,7 +1036,7 @@
         <publishername>ITP Media Group</publishername>
       </publisher>
       <pubdate>1996</pubdate>
-      <edition>6th</edition>
+      <edition>6th edition</edition>
       <isbn>ISBN 1573980137</isbn>
     </biblioset>
   </biblioentry>
@@ -1032,7 +1052,7 @@
         <publishername>MIT Press</publishername>
       </publisher>
       <pubdate>1996</pubdate>
-      <edition>3rd</edition>
+      <edition>3rd edition</edition>
       <isbn>ISBN 0-262-68092-0</isbn>
     </biblioset>
   </biblioentry>
@@ -1055,6 +1075,7 @@
   <biblioentry id="biblio-unixhatershandbook">
     <biblioset relation="book">
       <title>The UNIX-HATERS Handbook</title>
+      <authorgroup>
       <author>
         <firstname>Steven</firstname>
         <surname>Strassman</surname>
@@ -1067,6 +1088,7 @@
         <firstname>Simon</firstname>
         <surname>Garfinkel</surname>
       </author>
+      </authorgroup>
       <publisher>
         <publishername>IDG Books Worldwide, Inc</publishername>
       </publisher>
@@ -1078,6 +1100,7 @@
   <biblioentry id="biblio-lifewithunix">
     <biblioset relation="book">
       <title>Life with UNIX &mdash; special edition</title>
+      <authorgroup>
       <author>
         <firstname>Don</firstname>
         <surname>Libes</surname>
@@ -1086,6 +1109,7 @@
         <firstname>Sandy</firstname>
         <surname>Ressler</surname>
       </author>
+      </authorgroup>
       <publisher>
         <publishername>Prentice-Hall</publishername>
       </publisher>


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: rene 
State-Changed-When: Mon Mar 23 16:23:23 UTC 2009 
State-Changed-Why:  
Committed 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/132978: commit references a PR
Date: Mon, 23 Mar 2009 16:22:41 +0000 (UTC)

 rene        2009-03-23 16:22:27 UTC
 
   FreeBSD doc repository
 
   Modified files:
     share/sgml           bibliography.sgml 
   Log:
   * insert "pages" and "edition" (lowercase existing instances) in pages and edition tags
   * use authorgroup tags where appropriate
   
   PR:             docs/132978
   Submitted by:   rene
   Approved by:    gabor
   
   Revision  Changes    Path
   1.10      +50 -26    doc/share/sgml/bibliography.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"
 
>Unformatted:
