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 <title><literal>id</literal> on Chapters and
Sections</title> Sections</title>
<programlisting><![CDATA[<chapter id="sample-chapter1"> <programlisting><![CDATA[<chapter id="introduction">
<title>Introduction</title> <title>Introduction</title>
<para>This is the introduction. It contains a subsection, <para>This is the introduction. It contains a subsection,
which is identified as well.</para> which is identified as well.</para>
<sect1 id="sample-chapter1-sect1"> <sect1 id="introduction-moredetails">
<title>Sub-sect 1</title> <title>More Details</title>
<para>This is a subsection.</para> <para>This is a subsection.</para>
</sect1> </sect1>
@ -2064,13 +2064,13 @@ IMAGES= chapter1/fig1.png
<para>Assume that this fragment appears somewhere in a <para>Assume that this fragment appears somewhere in a
document that includes the <literal>id</literal> document that includes the <literal>id</literal>
example:</para> example shown above:</para>
<programlisting><![CDATA[<para>More information can be found <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 <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 <para>The link text will be generated automatically, looking
like (<emphasis>emphasized</emphasis> text indicates the like (<emphasis>emphasized</emphasis> text indicates the
@ -2078,11 +2078,11 @@ IMAGES= chapter1/fig1.png
<blockquote> <blockquote>
<para>More information can be found in <emphasis>Chapter <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 <para>More specific information can be found in
<emphasis>Section 1.1, <emphasis>Section 1.1,
<quote>Sample Sub-Sect</quote></emphasis>.</para> <quote>More Details</quote></emphasis>.</para>
</blockquote> </blockquote>
</example> </example>
@ -2130,10 +2130,10 @@ IMAGES= chapter1/fig1.png
example.</para> example.</para>
<programlisting><![CDATA[<para>More information can be found in the <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 <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 <para>This output will be generated
(<emphasis>emphasized</emphasis> text is used to show the (<emphasis>emphasized</emphasis> text is used to show the
@ -2141,10 +2141,10 @@ IMAGES= chapter1/fig1.png
<blockquote> <blockquote>
<para>More information can be found in the <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 <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> </blockquote>
</example> </example>
@ -2237,6 +2237,8 @@ IMAGES= chapter1/fig1.png
url="http://en.wikipedia.org/wiki/GUID_Partition_Table">GUID url="http://en.wikipedia.org/wiki/GUID_Partition_Table">GUID
Partition Tables</ulink>.</para>]]></programlisting> Partition Tables</ulink>.</para>]]></programlisting>
<para>Appearance:</para>
<para>Wikipedia has an excellent reference on <para>Wikipedia has an excellent reference on
<ulink <ulink
url="http://en.wikipedia.org/wiki/GUID_Partition_Table">GUID url="http://en.wikipedia.org/wiki/GUID_Partition_Table">GUID