svn commit: r42017 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup

[Warren Block]

Author: wblock
Date: Mon Jun 24 00:46:26 2013
New Revision: 42017
URL: http://svnweb.freebsd.org/changeset/doc/42017

Log:
  Improve some xref and link examples and make them consistent.

Modified:
  head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml

Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml	Mon Jun 24 00:40:08 2013	(r42016)
+++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml	Mon Jun 24 00:46:26 2013	(r42017)
@@ -2011,14 +2011,14 @@ IMAGES=  chapter1/fig1.png
 	<title><literal>id</literal> on Chapters and
 	  Sections</title>
 
-	<programlisting><![CDATA[<chapter id="sample-chapter1">
+	<programlisting><![CDATA[<chapter id="introduction">
   <title>Introduction</title>
 
   <para>This is the introduction.  It contains a subsection,
     which is identified as well.</para>
 
-  <sect1 id="sample-chapter1-sect1">
-    <title>Sub-sect 1</title>
+  <sect1 id="introduction-moredetails">
+    <title>More Details</title>
 
     <para>This is a subsection.</para>
   </sect1>
@@ -2064,13 +2064,13 @@ IMAGES=  chapter1/fig1.png
 
 	<para>Assume that this fragment appears somewhere in a
 	  document that includes the <literal>id</literal>
-	  example:</para>
+	  example shown above:</para>
 
 	<programlisting><![CDATA[<para>More information can be found
-  in <xref linkend="chapter1"/>.</para>
+  in <xref linkend="introduction"/>.</para>
 
 <para>More specific information can be found
-  in <xref linkend="chapter1-sect1"/>.</para>]]></programlisting>
+  in <xref linkend="introduction-moredetails"/>.</para>]]></programlisting>
 
 	<para>The link text will be generated automatically, looking
 	  like (<emphasis>emphasized</emphasis> text indicates the
@@ -2078,11 +2078,11 @@ IMAGES=  chapter1/fig1.png
 
 	<blockquote>
 	  <para>More information can be found in <emphasis>Chapter
-	      1, The Sample Chapter</emphasis>.</para>
+	      1, Introduction</emphasis>.</para>
 
 	  <para>More specific information can be found in
 	    <emphasis>Section 1.1,
-	      <quote>Sample Sub-Sect</quote></emphasis>.</para>
+	      <quote>More Details</quote></emphasis>.</para>
 	</blockquote>
       </example>
 
@@ -2130,10 +2130,10 @@ IMAGES=  chapter1/fig1.png
 	    example.</para>
 
 	  <programlisting><![CDATA[<para>More information can be found in the
-  <link linkend="chapter1">sample chapter</link>.</para>
+  <link linkend="introduction">sample introduction</link>.</para>
 
 <para>More specific information can be found in the
-  <link linkend="chapter1-sect1">even more samples</link> section.</para>]]></programlisting>
+  <link linkend="introduction-moredetails">sample introduction with more details</link> section.</para>]]></programlisting>
 
 	  <para>This output will be generated
 	    (<emphasis>emphasized</emphasis> text is used to show the
@@ -2141,10 +2141,10 @@ IMAGES=  chapter1/fig1.png
 
 	  <blockquote>
 	    <para>More information can be found in the
-	      <emphasis>sample chapter</emphasis>.</para>
+	      <emphasis>sample introduction</emphasis>.</para>
 
 	    <para>More specific information can be found in the
-	      <emphasis>even more samples</emphasis> section.</para>
+	      <emphasis>sample introduction with more details</emphasis> section.</para>
 	  </blockquote>
 	</example>
 
@@ -2237,6 +2237,8 @@ IMAGES=  chapter1/fig1.png
     url="http://en.wikipedia.org/wiki/GUID_Partition_Table">GUID
     Partition Tables</ulink>.</para>]]></programlisting>
 
+	  <para>Appearance:</para>
+
 	  <para>Wikipedia has an excellent reference on
 	    <ulink
 	      url="http://en.wikipedia.org/wiki/GUID_Partition_Table">GUID