Improve some xref and link examples and make them consistent.

This commit is contained in:
Warren Block 2013-06-24 00:46:26 +00:00
parent a3bf9b4d9e
commit 1881f39c04
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=42017

View file

@ -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