From 4a3e9771e2cf382ddd03eb1cacb22f2148b7a933 Mon Sep 17 00:00:00 2001
From: Peter Marschall <peter@adpm.de>
Date: Sun, 14 Aug 2011 22:31:31 +0200
Subject: [PATCH] doc/tools/*.xml: use <citerefentry> in "See also" sections

Instead of using plain text, use machine-parsable <citerefentry> sections
to refer to other odcuments.
---
 doc/tools/cryptoflex-tool.xml |  7 ++++++-
 doc/tools/netkey-tool.xml     |  7 ++++++-
 doc/tools/opensc-explorer.xml |  7 ++++++-
 doc/tools/opensc-tool.xml     |  7 ++++++-
 doc/tools/piv-tool.xml        |  7 ++++++-
 doc/tools/pkcs15-crypt.xml    | 11 ++++++++++-
 doc/tools/pkcs15-init.xml     |  7 ++++++-
 doc/tools/pkcs15-profile.xml  | 11 ++++++++++-
 doc/tools/pkcs15-tool.xml     | 11 ++++++++++-
 9 files changed, 66 insertions(+), 9 deletions(-)

diff --git a/doc/tools/cryptoflex-tool.xml b/doc/tools/cryptoflex-tool.xml
index 46fcc7e7..798140d1 100644
--- a/doc/tools/cryptoflex-tool.xml
+++ b/doc/tools/cryptoflex-tool.xml
@@ -128,7 +128,12 @@
 	
 	<refsect1>
 		<title>See also</title>
-		<para>pkcs15-tool(1)</para>
+		<para>
+			<citerefentry>
+				<refentrytitle>pkcs15-tool</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>
+		</para>
 	</refsect1>
 
 </refentry>
diff --git a/doc/tools/netkey-tool.xml b/doc/tools/netkey-tool.xml
index 2944c30d..6f413ce1 100644
--- a/doc/tools/netkey-tool.xml
+++ b/doc/tools/netkey-tool.xml
@@ -141,7 +141,12 @@
 
   <refsect1>
     <title>See also</title>
-    <para>opensc-explorer(1)</para>
+    <para>
+      <citerefentry>
+        <refentrytitle>opensc-explorer</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>
+    </para>
   </refsect1>
 
   <refsect1>
diff --git a/doc/tools/opensc-explorer.xml b/doc/tools/opensc-explorer.xml
index a5208ab1..7052af12 100644
--- a/doc/tools/opensc-explorer.xml
+++ b/doc/tools/opensc-explorer.xml
@@ -291,7 +291,12 @@
 	
 	<refsect1>
 		<title>See also</title>
-		<para>opensc-tool(1)</para>
+		<para>
+			<citerefentry>
+				<refentrytitle>opensc-tool</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>
+		</para>
 	</refsect1>
 
 </refentry>
diff --git a/doc/tools/opensc-tool.xml b/doc/tools/opensc-tool.xml
index 972ba04d..3aae6eac 100644
--- a/doc/tools/opensc-tool.xml
+++ b/doc/tools/opensc-tool.xml
@@ -90,7 +90,12 @@ to enable debug output in the opensc library.</para></listitem>
 	
 	<refsect1>
 		<title>See also</title>
-		<para>opensc-explorer(1)</para>
+		<para>
+			<citerefentry>
+				<refentrytitle>opensc-explorer</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>
+		</para>
 	</refsect1>
 
 </refentry>
diff --git a/doc/tools/piv-tool.xml b/doc/tools/piv-tool.xml
index 6fd66a5b..0a86692a 100644
--- a/doc/tools/piv-tool.xml
+++ b/doc/tools/piv-tool.xml
@@ -124,7 +124,12 @@
 	
 	<refsect1>
 		<title>See also</title>
-		<para>opensc-tool(1)</para>
+		<para>
+			<citerefentry>
+				<refentrytitle>opensc-tool</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>
+		</para>
 	</refsect1>
 
 </refentry>
diff --git a/doc/tools/pkcs15-crypt.xml b/doc/tools/pkcs15-crypt.xml
index 9c8e278a..794443e8 100644
--- a/doc/tools/pkcs15-crypt.xml
+++ b/doc/tools/pkcs15-crypt.xml
@@ -142,7 +142,16 @@
 	
 	<refsect1>
 		<title>See also</title>
-		<para>pkcs15-init(1), pkcs15-tool(1)</para>
+		<para>
+			<citerefentry>
+				<refentrytitle>pkcs15-init</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>,
+			<citerefentry>
+				<refentrytitle>pkcs15-tool</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>
+		</para>
 	</refsect1>
 
 </refentry>
diff --git a/doc/tools/pkcs15-init.xml b/doc/tools/pkcs15-init.xml
index 71594fcf..5a410e76 100644
--- a/doc/tools/pkcs15-init.xml
+++ b/doc/tools/pkcs15-init.xml
@@ -440,7 +440,12 @@
 
 	<refsect1>
 		<title>See also</title>
-		<para>pkcs15-profile(5)</para>
+		<para>
+			<citerefentry>
+				<refentrytitle>pkcs15-profile</refentrytitle>
+				<manvolnum>5</manvolnum>
+			</citerefentry>
+		</para>
 	</refsect1>
 
 </refentry>
diff --git a/doc/tools/pkcs15-profile.xml b/doc/tools/pkcs15-profile.xml
index 1220710b..dfbea864 100644
--- a/doc/tools/pkcs15-profile.xml
+++ b/doc/tools/pkcs15-profile.xml
@@ -44,7 +44,16 @@
 	
 	<refsect1>
 		<title>See also</title>
-		<para>pkcs15-init(1), pkcs15-crypt(1)</para>
+		<para>
+			<citerefentry>
+				<refentrytitle>pkcs15-init</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>,
+			<citerefentry>
+				<refentrytitle>pkcs15-crypt</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>
+		</para>
 	</refsect1>
 
 </refentry>
diff --git a/doc/tools/pkcs15-tool.xml b/doc/tools/pkcs15-tool.xml
index 649ea9a3..dd527227 100644
--- a/doc/tools/pkcs15-tool.xml
+++ b/doc/tools/pkcs15-tool.xml
@@ -178,7 +178,16 @@
 	
 	<refsect1>
 		<title>See also</title>
-		<para>pkcs15-init(1), pkcs15-crypt(1)</para>
+		<para>
+			<citerefentry>
+				<refentrytitle>pkcs15-init</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>,
+			<citerefentry>
+				<refentrytitle>pkcs15-crypt</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>
+		</para>
 	</refsect1>
 
 </refentry>