link: Extended example for more cases, cleanup

Removed some tags/text and added more examples of link usage.
All four basic link cases are now represented.
linkend w and w/o endterm, and xlink:href with and without content.

diff --git a/link/example.xml b/link/example.xml
index 865ecb87745cff178224b1612603ba84a578362c..415387717b287410cada4657c473dc77a2c48f7e 100644 (file)
--- a/link/example.xml
+++ b/link/example.xml
@@ -1,43 +1,40 @@
 <?xml version="1.0" encoding="utf-8"?>
 <article version="5.0" xml:lang="en"
         xmlns="http://docbook.org/ns/docbook"
-        xmlns:xi="http://www.w3.org/2001/XInclude"
         xmlns:xlink="http://www.w3.org/1999/xlink">
   <info>
-    <title>Making a link a footnote</title>
-    <titleabbrev>Linkfootnote</titleabbrev>
+    <title><tag>link</tag> tag example</title>
+    <titleabbrev><tag>link</tag></titleabbrev>
     <author>
       <personname>
-       <honorific>Mr</honorific>
        <firstname>Fredrik</firstname>
        <surname>Unger</surname>
       </personname>
       <email>fred@tree.se</email>
-      <affiliation>
-       <orgname>Tree.se</orgname>
-      </affiliation>
     </author>
     <pubdate>2013-07-29</pubdate>
-    <abstract>
-      <para>
-       Displaying a link as a footnote instead of the default in
-       text representation.
-      </para>
-    </abstract>
   </info>
-  <section><title>Example code</title>
+  <section><title>Example usage of the tag <tag>link</tag></title>
   <para>
-    Sometimes a link in the text to a website is better not
-    interspersed in the text as the default processing but put as a
-    footnote. This makes the text easier to read but still providing
-    the link. By using overloading the style sheet the docbook xml can
-    be kept the same.
+    In the <link linkend='nextpara'>next paragraph</link> describes a
+    domain handled by <link xlink:href="http://iana.org" />
   </para>
-  <para>
+  <para xml:id='nextpara'>
     There is a <link xlink:href="http://example.com">domain</link>
     that is established to be used for illustrative examples in
     documents. One can use this domain in examples without prior
     coordination or asking for permission.
   </para>
+  <para>
+    The next section <link linkend='nextsect'
+    endterm='nextsect.title'/> gives some more information.
+  </para>
+  </section>
+  <section xml:id='nextsect'>
+    <title xml:id='nextsect.title'>RFC 2606</title>
+    <para>
+      The RFC 2606 "Reserved Top Level DNS Names" was approved in June
+      1999.
+    </para>
   </section>
 </article>