docs/132978: clean up bibliography list

Rene Ladan rene at FreeBSD.org
Mon Mar 23 15:40:02 UTC 2009


>Number:         132978
>Category:       docs
>Synopsis:       clean up bibliography list
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Mar 23 15:40:01 UTC 2009
>Closed-Date:
>Last-Modified:
>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 & 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 & 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>Æleen</firstname>
         <surname>Frisch</surname>
       </author>
-      <edition>2nd</edition>
+      <edition>2nd edition</edition>
       <publisher>
         <publishername>O'Reilly & 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 & 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 & 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 — 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:
>Unformatted:



More information about the freebsd-doc mailing list