From 1881f39c049a7477c686b0cc14ff04d46b858859 Mon Sep 17 00:00:00 2001
From: Warren Block <wblock@FreeBSD.org>
Date: Mon, 24 Jun 2013 00:46:26 +0000
Subject: [PATCH] Improve some xref and link examples and make them consistent.
---
.../fdp-primer/docbook-markup/chapter.xml | 26 ++++++++++---------
1 file changed, 14 insertions(+), 12 deletions(-)
diff --git a/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml b/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml
index a2e014fef5..376d37ab16 100644
--- a/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml
+++ b/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml
@@ -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