svn commit: r257822 - in stable/8/release/doc: en_US.ISO8859-1/errata en_US.ISO8859-1/hardware en_US.ISO8859-1/installation en_US.ISO8859-1/readme en_US.ISO8859-1/relnotes share/misc share/xml

Xin LI delphij at FreeBSD.org
Thu Nov 7 22:08:05 UTC 2013


Author: delphij
Date: Thu Nov  7 22:08:04 2013
New Revision: 257822
URL: http://svnweb.freebsd.org/changeset/base/257822

Log:
  Convert stable/8 to use docbook 5.0.  We may still issue security advisories
  and do this conversion now so there wouldn't be surprises.

Modified:
  stable/8/release/doc/en_US.ISO8859-1/errata/article.xml
  stable/8/release/doc/en_US.ISO8859-1/hardware/article.xml
  stable/8/release/doc/en_US.ISO8859-1/installation/article.xml
  stable/8/release/doc/en_US.ISO8859-1/readme/article.xml
  stable/8/release/doc/en_US.ISO8859-1/relnotes/article.xml
  stable/8/release/doc/share/misc/man2hwnotes.pl
  stable/8/release/doc/share/xml/catalog.xml

Modified: stable/8/release/doc/en_US.ISO8859-1/errata/article.xml
==============================================================================
--- stable/8/release/doc/en_US.ISO8859-1/errata/article.xml	Thu Nov  7 21:52:04 2013	(r257821)
+++ stable/8/release/doc/en_US.ISO8859-1/errata/article.xml	Thu Nov  7 22:08:04 2013	(r257822)
@@ -1,17 +1,27 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.5-Based Extension//EN"
-        "../../../share/xml/freebsd45.dtd" [
+<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
+        "../../../share/xml/freebsd50.dtd" [
 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent">
 %release;
 ]>
+<!--
+	FreeBSD errata document.  Unlike some of the other RELNOTESng
+	files, this file should remain as a single SGML file, so that
+	the dollar FreeBSD dollar header has a meaningful modification
+	time.  This file is all but useless without a datestamp on it,
+	so we'll take some extra care to make sure it has one.
+
+	(If we didn't do this, then the file with the datestamp might
+	not be the one that received the last change in the document.)
+
+-->
+<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+  <info><title>&os; &release.current; Errata</title>
+    
 
-<article>
-  <articleinfo>
-    <title>&os; &release; Errata </title>
-
-    <corpauthor>
+    <author><orgname>
     The &os; Project
-    </corpauthor>
+    </orgname></author>
 
     <pubdate>$FreeBSD$</pubdate>
 
@@ -20,34 +30,34 @@
       <holder role="mailto:doc at FreeBSD.org">The &os; Documentation Project</holder>
     </copyright>
 
-    <legalnotice id="trademarks" role="trademarks">
+    <legalnotice xml:id="trademarks" role="trademarks">
       &tm-attrib.freebsd;
       &tm-attrib.intel;
       &tm-attrib.sparc;
       &tm-attrib.general;
     </legalnotice>
-  </articleinfo>
 
-  <abstract>
-    <para>This document lists errata items for &os; &release;,
-      containing significant information discovered after the release
-      or too late in the release cycle to be otherwise included in the
-      release documentation.
-      This information includes security advisories, as well as news
-      relating to the software or documentation that could affect its
-      operation or usability.  An up-to-date version of this document
-      should always be consulted before installing this version of
-      &os;.</para>
-
-    <para>This errata document for &os; &release;
-      will be maintained until the &os; &release; end of life.</para>
-  </abstract>
+    <abstract>
+      <para>This document lists errata items for &os; &release.current;,
+        containing significant information discovered after the release
+        or too late in the release cycle to be otherwise included in the
+        release documentation.
+        This information includes security advisories, as well as news
+        relating to the software or documentation that could affect its
+        operation or usability.  An up-to-date version of this document
+        should always be consulted before installing this version of
+        &os;.</para>
+
+      <para>This errata document for &os; &release.current;
+        will be maintained until the &os; &release; end of life.</para>
+    </abstract>
+  </info>
 
-  <sect1 id="intro">
+  <sect1 xml:id="intro">
     <title>Introduction</title>
 
     <para>This errata document contains <quote>late-breaking news</quote>
-      about &os; &release;
+      about &os; &release.current;
       Before installing this version, it is important to consult this
       document to learn about any post-release discoveries or problems
       that may already have been found and fixed.</para>
@@ -57,31 +67,30 @@
       out of date by definition, but other copies are kept updated on
       the Internet and should be consulted as the <quote>current
       errata</quote> for this release.  These other copies of the
-      errata are located at <ulink
-      url="http://www.FreeBSD.org/releases/"></ulink>, plus any sites
+      errata are located at <uri xlink:href="http://www.FreeBSD.org/releases/">http://www.FreeBSD.org/releases/</uri>, plus any sites
       which keep up-to-date mirrors of this location.</para>
 
     <para>Source and binary snapshots of &os; &release.branch; also
       contain up-to-date copies of this document (as of the time of
       the snapshot).</para>
 
-    <para>For a list of all &os; CERT security advisories, see <ulink
-      url="http://www.FreeBSD.org/security/"></ulink> or <ulink
-      url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/"></ulink>.</para>
+    <para>For a list of all &os; CERT security advisories, see <uri xlink:href="http://www.FreeBSD.org/security/">http://www.FreeBSD.org/security/</uri> or <uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/">ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/</uri>.</para>
+
   </sect1>
 
-  <sect1 id="security">
+  <sect1 xml:id="security">
     <title>Security Advisories</title>
 
-    <para>The following security advisories pertain to &os; &release;.
-      For more information, consult the individual advisories available from
-      <ulink url="http://security.FreeBSD.org/"></ulink>.</para>
+    <para>Problems described in the following security advisories have
+      been fixed in &release.current;. For more information, consult
+      the individual advisories available from
+      <uri xlink:href="http://security.FreeBSD.org/">http://security.FreeBSD.org/</uri>.</para>
 
     <informaltable frame="none" pgwide="1">
       <tgroup cols="3">
-	<colspec colwidth="1*" />
-	<colspec colwidth="1*" />
-	<colspec colwidth="3*" />
+	<colspec colwidth="1*"/>
+	<colspec colwidth="1*"/>
+	<colspec colwidth="3*"/>
 	<thead>
 	  <row>
 	    <entry>Advisory</entry>
@@ -92,110 +101,75 @@
 
 	<tbody>
 	  <row>
-	    <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-12:01.openssl.asc"
-		>SA-12:01.openssl</ulink></entry>
-
+	    <entry><link xlink:href="http://security.freebsd.org/advisories/FreeBSD-SA-12:01.openssl.asc">SA-12:01.openssl</link></entry>
 	    <entry>03 May 2012</entry>
 
 	    <entry><para>OpenSSL multiple vulnerabilities</para></entry>
 	  </row>
 
 	  <row>
-	    <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-12:02.crypt.asc"
-		>SA-12:02.crypt</ulink></entry>
-
+	    <entry><link xlink:href="http://security.freebsd.org/advisories/FreeBSD-SA-12:02.crypt.asc">SA-12:02.crypt</link></entry>
 	    <entry>30 May 2012</entry>
-
-	    <entry><para>Incorrect crypt() hashing</para></entry>
+	    <entry><para>Incorrect <function>crypt()</function> hashing</para></entry>
 	  </row>
 
 	  <row>
-	    <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-12:03.bind.asc"
-		>SA-12:03.bind</ulink></entry>
-
+	    <entry><link xlink:href="http://security.freebsd.org/advisories/FreeBSD-SA-12:03.bind.asc">SA-12:03.bind</link></entry>
 	    <entry>12 June 2012</entry>
-
-	    <entry><para>Incorrect handling of zero-length RDATA fields in named(8)</para></entry>
+	    <entry><para>Incorrect handling of zero-length RDATA fields in &man.named.8;</para></entry>
 	  </row>
 
 	  <row>
-	    <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-12:04.sysret.asc"
-		>SA-12:04.sysret</ulink></entry>
-
+	    <entry><link xlink:href="http://security.freebsd.org/advisories/FreeBSD-SA-12:04.sysret.asc">SA-12:04.sysret</link></entry>
 	    <entry>12 June 2012</entry>
-
 	    <entry><para>Privilege escalation when returning from kernel</para></entry>
 	  </row>
 
 	  <row>
-	    <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-12:05.bind.asc"
-		>SA-12:05.bind</ulink></entry>
-
-	    <entry>06 August 2012</entry>
-
-	    <entry><para>named(8) DNSSEC validation Denial of Service</para></entry>
+	    <entry><link xlink:href="http://security.freebsd.org/advisories/FreeBSD-SA-12:05.bind.asc">SA-12:05.bind</link></entry>
+	    <entry>6 August 2012</entry>
+	    <entry><para>&man.named.8; DNSSEC validation Denial of Service</para></entry>
 	  </row>
 
 	  <row>
-	    <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-12:06.bind.asc"
-		>SA-12:06.bind</ulink></entry>
-
+	    <entry><link xlink:href="http://security.freebsd.org/advisories/FreeBSD-SA-12:06.bind.asc">SA-12:06.bind</link></entry>
 	    <entry>22 November 2012</entry>
-
-	    <entry><para>Multiple Denial of Service vulnerabilities with named(8)</para></entry>
+	    <entry><para>Multiple Denial of Service vulnerabilities with &man.named.8;</para></entry>
 	  </row>
 
 	  <row>
-	    <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-12:07.hostapd.asc"
-		>SA-12:07.hostapd</ulink></entry>
-
+	    <entry><link xlink:href="http://security.freebsd.org/advisories/FreeBSD-SA-12:07.hostapd.asc">SA-12:07.hostapd</link></entry>
 	    <entry>22 November 2012</entry>
-
 	    <entry><para>Insufficient message length validation for EAP-TLS messages</para></entry>
 	  </row>
 
 	  <row>
-	    <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-12:08.linux.asc"
-		>SA-12:08.linux</ulink></entry>
-
+	    <entry><link xlink:href="http://security.freebsd.org/advisories/FreeBSD-SA-12:08.linux.asc">SA-12:08.linux</link></entry>
 	    <entry>22 November 2012</entry>
-
 	    <entry><para>Linux compatibility layer input validation error</para></entry>
 	  </row>
 
 	  <row>
-	    <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-13:02.libc.asc"
-		>SA-13:02.libc</ulink></entry>
-
+	    <entry><link xlink:href="http://security.freebsd.org/advisories/FreeBSD-SA-13:02.libc.asc">SA-13:02.libc</link></entry>
 	    <entry>19 February 2013</entry>
-
 	    <entry><para>glob(3) related resource exhaustion</para></entry>
 	  </row>
 
 	  <row>
-	    <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-13:03.openssl.asc"
-		>SA-13:03.openssl</ulink></entry>
-
+	    <entry><link xlink:href="http://security.freebsd.org/advisories/FreeBSD-SA-13:03.openssl.asc">SA-13:03.openssl</link></entry>
 	    <entry>02 April 2013</entry>
-
 	    <entry><para>OpenSSL multiple vulnerabilities</para></entry>
 	  </row>
 
 	  <row>
-	    <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-13:04.bind.asc"
-		>SA-13:04.bind</ulink></entry>
-
+	    <entry><link xlink:href="http://security.freebsd.org/advisories/FreeBSD-SA-13:04.bind.asc">SA-13:04.bind</link></entry>
 	    <entry>02 April 2013</entry>
-
 	    <entry><para>BIND remote denial of service</para></entry>
 	  </row>
 
 	  <row>
-	    <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-13:05.nfsserver.asc"
-		>SA-13:05.nfsserver</ulink></entry>
-
+	    <entry><link xlink:href="http://security.freebsd.org/advisories/FreeBSD-SA-13:05.nfsserver.asc">SA-13:05.nfsserver</link></entry>
 	    <entry>29 April 2013</entry>
-
 	    <entry><para>Insufficient input validation in the NFS server</para></entry>
 	  </row>
 	</tbody>
@@ -203,7 +177,7 @@
     </informaltable>
   </sect1>
 
-  <sect1 id="open-issues">
+  <sect1 xml:id="open-issues">
     <title>Open Issues</title>
 
     <para>[20130613] The &man.vtnet.4; network interface driver
@@ -213,8 +187,8 @@
     <screen>vtnet0: error setting host MAC filter table</screen>
 
     <para>This message is harmless when the interface has only one MAC
-      address.  The patch for this issue is filed to a PR <ulink
-      url="http://www.FreeBSD.org/cgi/query-pr.cgi?pr=178955">kern/178955</ulink>.</para>
+      address.  The patch for this issue is filed to a PR <link
+      xlink:href="http://www.FreeBSD.org/cgi/query-pr.cgi?pr=178955">kern/178955</link>.</para>
 
     <para>[20130609] There is incompatibility in &man.jail.8;
       configuration because the &man.jail.8; utility and
@@ -300,7 +274,7 @@ kernel: fxp0: link state changed to DOWN
       Notice.</para>
   </sect1>
 
-  <sect1 id="late-news">
+  <sect1 xml:id="late-news">
     <title>Late-Breaking News and Corrections</title>
 
     <para>[20130606] As described in &os; &release; Release Notes,

Modified: stable/8/release/doc/en_US.ISO8859-1/hardware/article.xml
==============================================================================
--- stable/8/release/doc/en_US.ISO8859-1/hardware/article.xml	Thu Nov  7 21:52:04 2013	(r257821)
+++ stable/8/release/doc/en_US.ISO8859-1/hardware/article.xml	Thu Nov  7 22:08:04 2013	(r257822)
@@ -1,17 +1,16 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.5-Based Extension//EN"
-        "../../../share/xml/freebsd45.dtd" [
+<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
+        "../../../share/xml/freebsd50.dtd" [
 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent">
 %release;
 <!ENTITY % devauto PUBLIC "-//FreeBSD//ENTITIES Auto Generated Device Lists//EN" "nonexistent">
 %devauto;
 ]>
+<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+  <info><title>&os; &release.current; Hardware Notes</title>
+    
 
-<article>
-  <articleinfo>
-    <title>&os; &release.current; Hardware Notes</title>
-
-    <corpauthor>The &os; Documentation Project</corpauthor>
+    <author><orgname>The &os; Documentation Project</orgname></author>
 
     <pubdate>$FreeBSD$</pubdate>
 
@@ -33,7 +32,7 @@
       <holder role="mailto:doc at FreeBSD.org">The &os; Documentation Project</holder>
     </copyright>
 
-    <legalnotice id="trademarks" role="trademarks">
+    <legalnotice xml:id="trademarks" role="trademarks">
       &tm-attrib.freebsd;
       &tm-attrib.amd;
       &tm-attrib.fujitsu;
@@ -44,9 +43,9 @@
       &tm-attrib.general;
     </legalnotice>
 
-  </articleinfo>
+  </info>
 
-  <sect1 id="intro">
+  <sect1 xml:id="intro">
     <title>Introduction</title>
 
     <para>This document contains the hardware compatibility notes for
@@ -56,14 +55,14 @@
       along with known working instances of these devices.</para>
   </sect1>
 
-  <sect1 id="proc">
+  <sect1 xml:id="proc">
     <title>Supported Processors and System Boards</title>
 
     <para>This section provides some architecture-specific information
       about the specific processors and systems that are supported by
       each architecture.</para>
 
-    <sect2 id="proc-amd64">
+    <sect2 xml:id="proc-amd64">
       <title>amd64</title>
 
       <para>Since mid-2003 &os;/&arch.amd64; has supported the AMD64
@@ -121,8 +120,8 @@
 	<listitem>
 	  <para>Some &intel; &pentium; 4s and Celeron Ds using
 	    the <quote>Prescott</quote> core have EM64T support.  See
-	    the <ulink url="http://processorfinder.intel.com">Intel
-	    Processor Spec Finder</ulink> for the definitive answer about
+	    the <link xlink:href="http://processorfinder.intel.com">Intel
+	    Processor Spec Finder</link> for the definitive answer about
 	    EM64T support in Intel processors.</para>
 	</listitem>
 
@@ -144,7 +143,7 @@
 
     </sect2>
 
-    <sect2 id="proc-i386">
+    <sect2 xml:id="proc-i386">
       <title>i386</title>
 
       <para>&os;/&arch.i386; runs on a wide variety of <quote>IBM PC
@@ -232,23 +231,19 @@
 	(DSDT) provided by each machine's BIOS.  Some machines have
 	bad or incomplete DSDTs, which prevents ACPI from functioning
 	correctly.  Replacement DSDTs for some machines can be found
-	at the <ulink
-	  url="http://acpi.sourceforge.net/dsdt/index.php">DSDT</ulink>
-	section of the <ulink
-	  url="http://acpi.sourceforge.net/">ACPI4Linux</ulink> project
+	at the <link xlink:href="http://acpi.sourceforge.net/dsdt/index.php">DSDT</link>
+	section of the <link xlink:href="http://acpi.sourceforge.net/">ACPI4Linux</link> project
 	Web site.  &os; can use these DSDTs to override the DSDT
 	provided by the BIOS; see the &man.acpi.4; manual page for
 	more information.</para>
     </sect2>
 
-    <sect2 id="proc-ia64">
+    <sect2 xml:id="proc-ia64">
       <title>ia64</title>
 
-      <para>Currently supported processors are the <ulink
-	  url="http://people.freebsd.org/~marcel/refs/ia64/itanium/24532003.pdf">&itanium;</ulink>
-	and the <ulink
-	  url="http://people.freebsd.org/~marcel/refs/ia64/itanium2/25111003.pdf">&itanium;
-	  2</ulink>.</para>
+      <para>Currently supported processors are the <link xlink:href="http://people.freebsd.org/~marcel/refs/ia64/itanium/24532003.pdf">&itanium;</link>
+	and the <link xlink:href="http://people.freebsd.org/~marcel/refs/ia64/itanium2/25111003.pdf">&itanium;
+	  2</link>.</para>
 
       <para>Supported chipsets include:</para>
 
@@ -278,7 +273,7 @@
 	and the use of a serial console is required.</para>
     </sect2>
 
-    <sect2 id="proc-pc98">
+    <sect2 xml:id="proc-pc98">
       <title>pc98</title>
 
       <para>NEC PC-9801/9821 series with almost all &i386;-compatible
@@ -307,7 +302,7 @@
 	FC-H98 series) is not supported.</para>
     </sect2>
 
-    <sect2 id="proc-powerpc">
+    <sect2 xml:id="proc-powerpc">
       <title>powerpc</title>
 
       <para>This section describes the systems currently known to be
@@ -369,15 +364,15 @@
       </itemizedlist>
     </sect2>
 
-    <sect2 id="proc-sparc64">
+    <sect2 xml:id="proc-sparc64">
       <title>sparc64</title>
 
       <para>This section describes the systems currently known to be
 	supported by &os; on the Fujitsu &sparc64; and Sun &ultrasparc;
 	platforms.  For
 	background information on the various hardware designs see the
-	<ulink url="http://sunsolve.sun.com/handbook_pub/">Sun System
-	  Handbook</ulink>.</para>
+	<link xlink:href="http://sunsolve.sun.com/handbook_pub/">Sun System
+	  Handbook</link>.</para>
 
       <para>SMP is supported on all systems with more than 1
 	processor.</para>
@@ -691,7 +686,7 @@
   build.
   -->
 
-  <sect1 id="support">
+  <sect1 xml:id="support">
     <title>Supported Devices</title>
 
     <para>This section describes the devices currently known to be
@@ -713,7 +708,7 @@
 	multiple times.</para>
     </note>
 
-    <sect2 id="disk">
+    <sect2 xml:id="disk">
       <title>Disk Controllers</title>
 
       <para>[&arch.amd64;, &arch.i386;, &arch.ia64;, &arch.pc98;,
@@ -835,8 +830,7 @@
 	support CD-ROM commands are supported for read-only access by
 	the CD-ROM drivers (such as &man.cd.4;).  WORM/CD-R/CD-RW
 	writing support is provided by &man.cdrecord.1;, which is a
-	part of the <filename
-	  role="package">sysutils/cdrtools</filename> port in the Ports
+	part of the <package>sysutils/cdrtools</package> port in the Ports
 	Collection.</para>
 
       <para>The following CD-ROM type systems are supported at this
@@ -868,7 +862,7 @@
       </itemizedlist>
     </sect2>
 
-    <sect2 id="ethernet">
+    <sect2 xml:id="ethernet">
       <title>Ethernet Interfaces</title>
 
       &hwlist.ae;
@@ -996,7 +990,7 @@
 
     </sect2>
 
-    <sect2 id="fddi">
+    <sect2 xml:id="fddi">
       <title>FDDI Interfaces</title>
 
       <para>[&arch.i386;, &arch.pc98;] DEC DEFPA PCI (&man.fpa.4;
@@ -1005,7 +999,7 @@
       <para>[&arch.i386;] DEC DEFEA EISA (&man.fpa.4; driver)</para>
     </sect2>
 
-    <sect2 id="atm">
+    <sect2 xml:id="atm">
       <title>ATM Interfaces</title>
 
       <para>[&arch.i386;, &arch.pc98;] Midway-based ATM interfaces
@@ -1026,7 +1020,7 @@
 	(&man.patm.4; driver)</para>
     </sect2>
 
-    <sect2 id="wlan">
+    <sect2 xml:id="wlan">
       <title>Wireless Network Interfaces</title>
 
       <para>[&arch.amd64;, &arch.i386;, &arch.pc98;] Cisco/Aironet
@@ -1077,7 +1071,7 @@
       &hwlist.zyd;
     </sect2>
 
-    <sect2 id="misc-network">
+    <sect2 xml:id="misc-network">
       <title>Miscellaneous Networks</title>
 
       &hwlist.ce;
@@ -1091,7 +1085,7 @@
       &hwlist.cm;
     </sect2>
 
-    <sect2 id="serial">
+    <sect2 xml:id="serial">
       <title>Serial Interfaces</title>
 
       <para>[&arch.amd64;, &arch.i386;] <quote>PC standard</quote>
@@ -1350,7 +1344,7 @@
 
     </sect2>
 
-    <sect2 id="sound">
+    <sect2 xml:id="sound">
       <title>Sound Devices</title>
 
       &hwlist.snd.ad1816;
@@ -1442,7 +1436,7 @@
       </itemizedlist>
     </sect2>
 
-    <sect2 id="camera">
+    <sect2 xml:id="camera">
       <title>Camera and Video Capture Devices</title>
 
       &hwlist.bktr;
@@ -1450,7 +1444,7 @@
       <para>[&arch.i386;] Connectix QuickCam</para>
     </sect2>
 
-    <sect2 id="usb">
+    <sect2 xml:id="usb">
       <title>USB Devices</title>
 
       <para>[&arch.amd64;, &arch.i386;, &arch.ia64;, &arch.pc98;] A
@@ -1469,8 +1463,7 @@
 
       <note>
 	<para>[&arch.amd64;, &arch.i386;, &arch.ia64;, &arch.pc98;]
-	  USB Bluetooth adapters can be found in <link
-	    linkend="bluetooth">Bluetooth</link> section.</para>
+	  USB Bluetooth adapters can be found in <link linkend="bluetooth">Bluetooth</link> section.</para>
       </note>
 
       &hwlist.ohci;
@@ -1539,7 +1532,7 @@
       &hwlist.uvisor;
     </sect2>
 
-    <sect2 id="firewire">
+    <sect2 xml:id="firewire">
       <title>IEEE 1394 (Firewire) Devices</title>
 
       &hwlist.fwohci;
@@ -1548,7 +1541,7 @@
 	Protocol 2 (SBP-2) storage devices (&man.sbp.4; driver)</para>
     </sect2>
 
-    <sect2 id="bluetooth">
+    <sect2 xml:id="bluetooth">
       <title>Bluetooth Devices</title>
 
       &hwlist.ng.bt3c;
@@ -1556,7 +1549,7 @@
       &hwlist.ng.ubt;
     </sect2>
 
-    <sect2 id="crypto-accel">
+    <sect2 xml:id="crypto-accel">
       <title>Cryptographic Accelerators</title>
 
       &hwlist.hifn;
@@ -1566,7 +1559,7 @@
       &hwlist.ubsec;
     </sect2>
 
-    <sect2 id="misc">
+    <sect2 xml:id="misc">
       <title>Miscellaneous</title>
 
       <para>[&arch.amd64;, &arch.i386;, &arch.pc98;]
@@ -1592,7 +1585,7 @@
       <note>
 	<para>Information regarding specific video cards and
 	  compatibility with <application>Xorg</application> can be
-	  found at <ulink url="http://www.x.org/"></ulink>.</para>
+	  found at <uri xlink:href="http://www.x.org/">http://www.x.org/</uri>.</para>
       </note>
 
       <para>[&arch.amd64;, &arch.i386;, &arch.ia64;, &arch.pc98;]
@@ -1647,8 +1640,7 @@
       <note>
 	<para>&man.moused.8; has more information on using pointing
 	  devices with &os;.  Information on using pointing devices
-	  with <application>Xorg</application> can be found at <ulink
-	    url="http://www.x.org/"></ulink>.</para>
+	  with <application>Xorg</application> can be found at <uri xlink:href="http://www.x.org/">http://www.x.org/</uri>.</para>
       </note>
 
       <para>[&arch.amd64;, &arch.i386;] <quote>PC standard</quote>
@@ -1681,8 +1673,7 @@
       </itemizedlist>
 
       <para>[&arch.i386;] Xilinx XC6200-based reconfigurable hardware
-	cards compatible with the HOT1 from <ulink
-	  url="http://www.vcc.com/">Virtual Computers</ulink> (xrpu
+	cards compatible with the HOT1 from <link xlink:href="http://www.vcc.com/">Virtual Computers</link> (xrpu
 	driver).</para>
 
       <para>[&arch.pc98;] Power Management Controller of NEC PC-98

Modified: stable/8/release/doc/en_US.ISO8859-1/installation/article.xml
==============================================================================
--- stable/8/release/doc/en_US.ISO8859-1/installation/article.xml	Thu Nov  7 21:52:04 2013	(r257821)
+++ stable/8/release/doc/en_US.ISO8859-1/installation/article.xml	Thu Nov  7 22:08:04 2013	(r257822)
@@ -1,15 +1,14 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.5-Based Extension//EN"
-        "../../../share/xml/freebsd45.dtd" [
+<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
+        "../../../share/xml/freebsd50.dtd" [
 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent">
 %release;
 ]>
+<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+  <info><title>&os; &release.current; Installation Instructions</title>
+    
 
-<article>
-  <articleinfo>
-    <title>&os; &release.current; Installation Instructions</title>
-
-    <corpauthor>The &os; Project</corpauthor>
+    <author><orgname>The &os; Project</orgname></author>
 
     <pubdate>$FreeBSD$</pubdate>
 
@@ -19,31 +18,31 @@
       <holder role="mailto:doc at FreeBSD.org">The &os; Documentation Project</holder>
     </copyright>
 
-    <legalnotice id="trademarks" role="trademarks">
+    <legalnotice xml:id="trademarks" role="trademarks">
       &tm-attrib.freebsd;
       &tm-attrib.intel;
       &tm-attrib.sparc;
       &tm-attrib.general;
     </legalnotice>
-  </articleinfo>
 
-  <abstract>
-    <para>This article gives some brief instructions on installing
-      &os; &release.current; and upgrading the systems running earlier
-      releases.</para>
-  </abstract>
+    <abstract>
+      <para>This article gives some brief instructions on installing
+        &os; &release.current; and upgrading the systems running earlier
+        releases.</para>
+    </abstract>
+  </info>
 
-  <sect1 id="install">
+  <sect1 xml:id="install">
     <title>Installing &os;</title>
 
     <para>For instructions on installing FreeBSD, please see Chapter 2
       of The FreeBSD Handbook.  It provides a complete installation
       walk-through for users new to FreeBSD, and can be found online
-      at: <ulink
-	url="&url.books.handbook;/install.html"></ulink></para>
+      at: <link
+	xlink:href="&url.books.handbook;/install.html"></link></para>
   </sect1>
 
-  <sect1 id="upgrade">
+  <sect1 xml:id="upgrade">
     <title>Upgrading &os;</title>
 
     <sect2>
@@ -51,8 +50,8 @@
 
       <para>The procedure for doing a source code based update is
 	described in
-	<ulink url="&url.books.handbook;/synching.html"></ulink> and
-	<ulink url="&url.books.handbook;//makeworld.html"></ulink>.</para>
+	<uri xlink:href="&url.books.handbook;/synching.html">&url.books.handbook;/synching.html</uri> and
+	<uri xlink:href="&url.books.handbook;/makeworld.html">&url.books.handbook;/makeworld.html</uri>.</para>
 
       <para>The branch tag to use for updating the source is
 	<literal>RELENG_8_3</literal> for CVS.  For SVN use
@@ -78,8 +77,8 @@
 
       <screen>&prompt.root; freebsd-update install</screen>
 
-      <para>The system must be rebooted with the newly installed
-	kernel before continuing.</para>
+      <para>The system must now be rebooted with the newly installed
+	kernel before the non-kernel components are updated.</para>
 
       <screen>&prompt.root; shutdown -r now</screen>
 

Modified: stable/8/release/doc/en_US.ISO8859-1/readme/article.xml
==============================================================================
--- stable/8/release/doc/en_US.ISO8859-1/readme/article.xml	Thu Nov  7 21:52:04 2013	(r257821)
+++ stable/8/release/doc/en_US.ISO8859-1/readme/article.xml	Thu Nov  7 22:08:04 2013	(r257822)
@@ -1,15 +1,22 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.5-Based Extension//EN"
-        "../../../share/xml/freebsd45.dtd" [
+<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
+        "../../../share/xml/freebsd50.dtd" [
 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent">
  %release;
 ]>
+<!-- 
+     Local Variables:
+     mode: sgml
+     sgml-indent-data: t
+     sgml-omittag: nil
+     sgml-always-quote-attributes: t
+     End:
+-->
+<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+  <info><title>&os; &release.current; README</title>
+    
 
-<article>
-  <articleinfo>
-    <title>&os; &release.current; README</title>
-
-    <corpauthor>The &os; Project</corpauthor>
+    <author><orgname>The &os; Project</orgname></author>
 
     <pubdate>$FreeBSD$</pubdate>
 
@@ -26,24 +33,24 @@
       <holder role="mailto:doc at FreeBSD.org">The &os; Documentation Project</holder>
     </copyright>
 
-    <legalnotice id="trademarks" role="trademarks">
+    <legalnotice xml:id="trademarks" role="trademarks">
       &tm-attrib.freebsd;
       &tm-attrib.intel;
       &tm-attrib.opengroup;
       &tm-attrib.sparc;
       &tm-attrib.general;
     </legalnotice>
-  </articleinfo>
 
-  <abstract>
-    <para>This document gives a brief introduction to &os;
-      &release.current;.  It includes some information on how to
-      obtain &os;, a listing of various ways to contact the &os;
-      Project, and pointers to some other sources of
-      information.</para>
-  </abstract>
+    <abstract>
+      <para>This document gives a brief introduction to &os;
+        &release.current;.  It includes some information on how to
+        obtain &os;, a listing of various ways to contact the &os;
+        Project, and pointers to some other sources of
+        information.</para>
+    </abstract>
+  </info>
 
-  <sect1 id="intro">
+  <sect1 xml:id="intro">
     <title>Introduction</title>
 
     <para>This distribution is a &release.type; of &os; &release.current;, the
@@ -133,7 +140,7 @@
     </sect2>
   </sect1>
 
-  <sect1 id="obtain">
+  <sect1 xml:id="obtain">
     <title>Obtaining &os;</title>
 
     <para>&os; may be obtained in a variety of ways.  This section
@@ -153,34 +160,29 @@
 	Collection, or other extra material.</para>
 
       <para>A list of the CDROM and DVD publishers known to the
-	project are listed in the <ulink
-	url="&url.books.handbook;/mirrors.html"><quote>Obtaining
-	&os;</quote></ulink> appendix to the Handbook.</para>
+	project are listed in the <link xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
+	&os;</quote></link> appendix to the Handbook.</para>
     </sect2>
 
     <sect2>
       <title>FTP</title>
 
       <para>You can use FTP to retrieve &os; and any or all of its
-	optional packages from <ulink
-	url="ftp://ftp.FreeBSD.org/"></ulink>, which is the official
+	optional packages from <uri xlink:href="ftp://ftp.FreeBSD.org/">ftp://ftp.FreeBSD.org/</uri>, which is the official
 	&os; release site, or any of its
 	<quote>mirrors</quote>.</para>
 
       <para>Lists of locations that mirror &os; can be found in the
-	<ulink
-	url="&url.books.handbook;/mirrors-ftp.html">FTP
-	Sites</ulink> section of the Handbook, or on the <ulink
-	url="http://mirrorlist.FreeBSD.org/"></ulink> Web pages.
+	<link xlink:href="&url.books.handbook;/mirrors-ftp.html">FTP
+	Sites</link> section of the Handbook.
 	Finding a close (in networking terms) mirror from which to
 	download the distribution is highly recommended.</para>
 
       <para>Additional mirror sites are always welcome.  Contact
 	<email>freebsd-admin at FreeBSD.org</email> for more details on
 	becoming an official mirror site.  You can also find useful
-        information for mirror sites at the <ulink
-        url="&url.articles.hubs;/">Mirroring
-        &os;</ulink> article.</para>
+        information for mirror sites at the <link xlink:href="&url.articles.hubs;/">Mirroring
+        &os;</link> article.</para>
 
       <para>Mirrors generally contain the ISO images generally used to
 	create a CDROM of a &os; release.  They usually also contain
@@ -191,7 +193,7 @@
     </sect2>
   </sect1>
 
-  <sect1 id="contacting">
+  <sect1 xml:id="contacting">
     <title>Contacting the &os; Project</title>
 
     <sect2>
@@ -218,14 +220,13 @@
 	preferable to subscribe instead to the &a.announce;.</para>
 
       <para>All of the mailing lists can be freely joined by anyone
-	wishing to do so.  Visit the <ulink url="&url.base;/mailman/listinfo">
-	&os; Mailman Info Page</ulink>.  This will give you more
+	wishing to do so.  Visit the <link xlink:href="&url.base;/mailman/listinfo">
+	&os; Mailman Info Page</link>.  This will give you more
 	information on joining the various lists, accessing archives,
 	etc.  There are a number of mailing lists targeted at special
 	interest groups not mentioned here; more information can be
-	obtained either from the Mailman pages or the <ulink
-	url="&url.base;/support.html#mailing-list">mailing
-	lists section</ulink> of the &os; Web site.</para>
+	obtained either from the Mailman pages or the <link xlink:href="&url.base;/support.html#mailing-list">mailing
+	lists section</link> of the &os; Web site.</para>
 
       <important>
 	<para>Do <emphasis>not</emphasis> send email to the lists
@@ -248,9 +249,8 @@
 	<quote>Problem Reports</quote> (PRs) submitted in this way
 	will be filed and their progress tracked; the &os; developers
 	will do their best to respond to all reported bugs as soon as
-	possible.  <ulink
-	url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi">A list
-	of all active PRs</ulink> is available on the &os; Web site;
+	possible.  <link xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi">A list
+	of all active PRs</link> is available on the &os; Web site;
 	this list is useful to see what potential problems other users
 	have encountered.</para>
 
@@ -260,22 +260,21 @@
 	are unable to use &man.send-pr.1; to submit a bug report, you
 	can try to send it to the &a.bugs;.</para>
 
-      <para>For more information, <ulink
-	url="&url.articles.problem-reports;/"><quote>Writing
-	&os; Problem Reports</quote></ulink>, available on the &os; Web
+      <para>For more information, <link xlink:href="&url.articles.problem-reports;/"><quote>Writing
+	&os; Problem Reports</quote></link>, available on the &os; Web
 	site, has a number of helpful hints on writing and submitting
 	effective problem reports.</para>
     </sect2>
   </sect1>
 
-  <sect1 id="seealso">
+  <sect1 xml:id="seealso">
     <title>Further Reading</title>
 
     <para>There are many sources of information about &os;; some are
       included with this distribution, while others are available
       on-line or in print versions.</para>
 
-    <sect2 id="release-docs">
+    <sect2 xml:id="release-docs">
       <title>Release Documentation</title>
 
       <para>A number of other files provide more specific information
@@ -335,7 +334,7 @@
 	  other copies are kept updated on the Internet and should be
 	  consulted as the <quote>current errata</quote> for this
 	  release.  These other copies of the errata are located at
-	  <ulink url="&url.base;/releases/"></ulink> (as
+	  <uri xlink:href="&url.base;/releases/">&url.base;/releases/</uri> (as
 	  well as any sites which keep up-to-date mirrors of this
 	  location).</para>
       </note>
@@ -346,9 +345,8 @@
 
       <para>As with almost all &unix; like operating systems, &os; comes
 	with a set of on-line manual pages, accessed through the
-	&man.man.1; command or through the <ulink
-	url="http://www.FreeBSD.org/cgi/man.cgi">hypertext manual
-	pages gateway</ulink> on the &os; Web site.  In general, the
+	&man.man.1; command or through the <link xlink:href="http://www.FreeBSD.org/cgi/man.cgi">hypertext manual
+	pages gateway</link> on the &os; Web site.  In general, the
 	manual pages provide information on the different commands and
 	APIs available to the &os; user.</para>
 
@@ -365,13 +363,10 @@
       <para>Two highly-useful collections of &os;-related information,
 	maintained by the &os; Project,
 	are the &os; Handbook and &os; FAQ (Frequently Asked
-	Questions document).  On-line versions of the <ulink
-	url="&url.books.handbook;/">Handbook</ulink>
-	and <ulink
-	url="&url.books.faq;/">FAQ</ulink>
-	are always available from the <ulink
-	url="&url.base;/docs.html">&os; Documentation
-	page</ulink> or its mirrors.  If you install the
+	Questions document).  On-line versions of the <link xlink:href="&url.books.handbook;/">Handbook</link>
+	and <link xlink:href="&url.books.faq;/">FAQ</link>
+	are always available from the <link xlink:href="&url.base;/docs.html">&os; Documentation
+	page</link> or its mirrors.  If you install the
 	<filename>doc</filename> distribution set, you can use a Web
 	browser to read the Handbook and FAQ locally.  In particular,
 	note that the Handbook contains a step-by-step guide to
@@ -387,8 +382,7 @@
         distribution set.</para>
 
       <para>A listing of other books and documents about &os; can be
-        found in the <ulink
-        url="&url.books.handbook;/bibliography.html">bibliography</ulink>
+        found in the <link xlink:href="&url.books.handbook;/bibliography.html">bibliography</link>
         of the &os; Handbook.  Because of &os;'s strong &unix; heritage,
         many other articles and books written for &unix; systems are
         applicable as well, some of which are also listed in the
@@ -396,16 +390,15 @@
     </sect2>
   </sect1>
 
-  <sect1 id="acknowledgements">
+  <sect1 xml:id="acknowledgements">
     <title>Acknowledgments</title>
 
     <para>&os; represents the cumulative work of many hundreds, if not
       thousands, of individuals from around the world who have worked
       countless hours to bring about this &release.type;.  For a
       complete list of &os; developers and contributors, please see
-      <ulink
-      url="&url.articles.contributors;/"><quote>Contributors
-      to &os;</quote></ulink> on the &os; Web site or any of its
+      <link xlink:href="&url.articles.contributors;/"><quote>Contributors
+      to &os;</quote></link> on the &os; Web site or any of its
       mirrors.</para>
 
     <para>Special thanks also go to the many thousands of &os; users
@@ -413,12 +406,3 @@
       simply would not have been possible.</para>
   </sect1>
 </article>
-
-<!-- 
-     Local Variables:
-     mode: sgml
-     sgml-indent-data: t
-     sgml-omittag: nil
-     sgml-always-quote-attributes: t
-     End:
--->

Modified: stable/8/release/doc/en_US.ISO8859-1/relnotes/article.xml
==============================================================================
--- stable/8/release/doc/en_US.ISO8859-1/relnotes/article.xml	Thu Nov  7 21:52:04 2013	(r257821)
+++ stable/8/release/doc/en_US.ISO8859-1/relnotes/article.xml	Thu Nov  7 22:08:04 2013	(r257822)
@@ -1,15 +1,14 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.5-Based Extension//EN"
-        "../../../share/xml/freebsd45.dtd" [
+<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
+        "../../../share/xml/freebsd50.dtd" [
 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent">
  %release;
 ]>
 
-<article>
-<articleinfo>
-  <title>&os; &release.current; Release Notes</title>
-
-  <corpauthor>The &os; Project</corpauthor>
+<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">

*** DIFF OUTPUT TRUNCATED AT 1000 LINES ***


More information about the svn-src-stable-8 mailing list