From 6f0263d67a8123fc988e5a59e0a63b4785156f2e Mon Sep 17 00:00:00 2001
From: Fredrik Unger <fred@tree.se>
Date: Thu, 1 Aug 2013 21:14:07 +0200
Subject: [PATCH] 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.
---
 link/example.xml | 37 +++++++++++++++++--------------------
 1 file changed, 17 insertions(+), 20 deletions(-)

diff --git a/link/example.xml b/link/example.xml
index 865ecb8..4153877 100644
--- 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>
-- 
2.30.2