change man pages to use a seealso file for references

the common references to lxc man pages
are now placed in one file "see_also.sgml.in"

Note that the few man pages that refer to man
pages that are not lxc ones have two "See Also" paragraph.

Signed-off-by: Michel Normand <normand@fr.ibm.com>
Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

diff --git a/configure.ac b/configure.ac
index 6e28345026825bfa55e96425ee1df91b4de3d236..f8d95c4e77826fee63b0442eabca887a8a048a27 100644 (file)
--- a/configure.ac
+++ b/configure.ac
@@ -78,6 +78,7 @@ AC_CONFIG_FILES([
        doc/lxc-cgroup.sgml
        doc/lxc.conf.sgml
        doc/lxc.sgml
+       doc/see_also.sgml
 
        scripts/Makefile
        scripts/lxc-debian

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 46a7dbb96144ed513b5d9260079235330b78aa58..6113e46d975f2018f226d14e1ee10c8b1cec0f5d 100644 (file)
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -23,13 +23,15 @@ man_MANS = \
 
 
 %.1 : %.sgml 
-       docbook2man $<
+       docbook2man -w all $<
 
 %.5 : %.sgml 
-       docbook2man $<
+       docbook2man -w all $<
 
 %.7 : %.sgml 
-       docbook2man $<
+       docbook2man -w all $<
+
+lxc-%.sgml : see_also.sgml
 
 clean-local:
        $(RM) manpage.* *.7 *.5 *.1 *.sgml $(man_MANS)

diff --git a/doc/lxc-cgroup.sgml.in b/doc/lxc-cgroup.sgml.in
index 47ab8d2c56d2db28769ccc1088d71a71d1b199b2..9a5ead07397d3cb3dc83317191729de8587ff2f7 100644 (file)
--- a/doc/lxc-cgroup.sgml.in
+++ b/doc/lxc-cgroup.sgml.in
@@ -23,7 +23,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -151,17 +154,7 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
   </refsect1>
 
-  <refsect1>
-    <title>See Also</title>
-
-    <simpara>    
-      <citerefentry>
-       <refentrytitle><command>lxc.conf</command></refentrytitle>
-       <manvolnum>5</manvolnum>
-      </citerefentry>,
-    </simpara>
-
-  </refsect1>
+  &seealso;
 
   <refsect1>
     <title>Author</title>

diff --git a/doc/lxc-console.sgml.in b/doc/lxc-console.sgml.in
index f86b8508436b3ce4c1c994c33b4e6d10caa13c3b..ef4d270c1cb2d50c68eb59248683c8355f49c649 100644 (file)
--- a/doc/lxc-console.sgml.in
+++ b/doc/lxc-console.sgml.in
@@ -23,7 +23,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -125,18 +128,7 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
   </refsect1>
 
-  <refsect1>
-    <title>See Also</title>
-
-    <simpara>    
-      <citerefentry>
-       <refentrytitle><command>lxc.conf</command></refentrytitle>
-       <manvolnum>5</manvolnum>
-      </citerefentry>
-    </simpara>
-
-
-  </refsect1>
+  &seealso;
 
   <refsect1>
     <title>Author</title>

diff --git a/doc/lxc-create.sgml.in b/doc/lxc-create.sgml.in
index f4022f28a853c2b09b8b04f97e92efdc161411f6..815ec2c832f42b24a168ff4598a13f773d99bdb4 100644 (file)
--- a/doc/lxc-create.sgml.in
+++ b/doc/lxc-create.sgml.in
@@ -23,7 +23,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -127,28 +130,7 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
   </refsect1>
 
-  <refsect1>
-    <title>See Also</title>
-
-    <simpara>    
-      <citerefentry>
-       <refentrytitle><command>lxc-destroy</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-execute</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc.conf</command></refentrytitle>
-       <manvolnum>5</manvolnum>
-      </citerefentry>
-    </simpara>
-
-
-  </refsect1>
+  &seealso;
 
   <refsect1>
     <title>Author</title>

diff --git a/doc/lxc-destroy.sgml.in b/doc/lxc-destroy.sgml.in
index 4d540d80444b6d45cda3f5a0aa5a077f2eec8d0a..ba265aa9a1688997fd432e505d9addf7a371bc6a 100644 (file)
--- a/doc/lxc-destroy.sgml.in
+++ b/doc/lxc-destroy.sgml.in
@@ -23,7 +23,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -111,23 +114,7 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
   </refsect1>
 
-  <refsect1>
-    <title>See Also</title>
-
-    <simpara>    
-      <citerefentry>
-       <refentrytitle><command>lxc-create</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-stop</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-    </simpara>
-
-
-  </refsect1>
+  &seealso;
 
   <refsect1>
     <title>Author</title>

diff --git a/doc/lxc-execute.sgml.in b/doc/lxc-execute.sgml.in
index c14ed72a53cb6fe2e91b41f854375999a08e3ea5..0043d140c8414b5aa2305474626d6e37ff1a8bf4 100644 (file)
--- a/doc/lxc-execute.sgml.in
+++ b/doc/lxc-execute.sgml.in
@@ -23,7 +23,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -133,39 +136,7 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
   </refsect1>
 
-  <refsect1>
-    <title>See Also</title>
-
-    <simpara>    
-      <citerefentry>
-       <refentrytitle><command>lxc-create</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-destroy</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-start</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-stop</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc.conf</command></refentrytitle>
-       <manvolnum>5</manvolnum>
-      </citerefentry>
-
-    </simpara>
-
-
-  </refsect1>
+  &seealso;
 
   <refsect1>
     <title>Author</title>

diff --git a/doc/lxc-freeze.sgml.in b/doc/lxc-freeze.sgml.in
index 8fb66c696085df93485bfbb5f42c497c201fcea2..5a3eb1d0835e97b93d54d25b8ee869264b9c95a3 100644 (file)
--- a/doc/lxc-freeze.sgml.in
+++ b/doc/lxc-freeze.sgml.in
@@ -23,7 +23,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -101,18 +104,7 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
   </refsect1>
 
-  <refsect1>
-    <title>See Also</title>
-
-    <simpara>    
-      <citerefentry>
-       <refentrytitle><command>lxc-unfreeze</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-    </simpara>
-
-
-  </refsect1>
+  &seealso;
 
   <refsect1>
     <title>Author</title>

diff --git a/doc/lxc-ls.sgml.in b/doc/lxc-ls.sgml.in
index 1fea4531bfe1827ead0d7ba82d2832a77fbb2dac..3ffd4f89855047a75c91bc3a2f8a52ea76a888ac 100644 (file)
--- a/doc/lxc-ls.sgml.in
+++ b/doc/lxc-ls.sgml.in
@@ -24,7 +24,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -112,9 +115,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
       </citerefentry>,
     </simpara>
 
-
   </refsect1>
 
+  &seealso;
+
   <refsect1>
     <title>Author</title>
     <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>

diff --git a/doc/lxc-monitor.sgml.in b/doc/lxc-monitor.sgml.in
index 35df19002e66102592faa9db0f89dc45855c80d8..bacae5eaad70969e7e1daefe64707b512f0f1197 100644 (file)
--- a/doc/lxc-monitor.sgml.in
+++ b/doc/lxc-monitor.sgml.in
@@ -23,7 +23,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -154,9 +157,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
       </citerefentry>,
     </simpara>
 
-
   </refsect1>
 
+  &seealso;
+
   <refsect1>
     <title>Author</title>
     <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>

diff --git a/doc/lxc-ps.sgml.in b/doc/lxc-ps.sgml.in
index ce0c4fa5220ca1bd031600e15f54b5d80eea9692..737457231081b962d30d47823d13095029e5d095 100644 (file)
--- a/doc/lxc-ps.sgml.in
+++ b/doc/lxc-ps.sgml.in
@@ -24,7 +24,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -126,9 +129,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
       </citerefentry>,
     </simpara>
 
-
   </refsect1>
 
+  &seealso;
+
   <refsect1>
     <title>Author</title>
     <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>

diff --git a/doc/lxc-start.sgml.in b/doc/lxc-start.sgml.in
index e536450eb77b6c3553b3fcda07ec1a23fc1c9153..587b44505ce2a2a68c5d7b0be9bacbeba0c75614 100644 (file)
--- a/doc/lxc-start.sgml.in
+++ b/doc/lxc-start.sgml.in
@@ -23,7 +23,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -120,39 +123,7 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
   </refsect1>
 
-  <refsect1>
-    <title>See Also</title>
-
-    <simpara>    
-      <citerefentry>
-       <refentrytitle><command>lxc-create</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-destroy</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-start</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-stop</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc.conf</command></refentrytitle>
-       <manvolnum>5</manvolnum>
-      </citerefentry>
-
-    </simpara>
-
-
-  </refsect1>
+  &seealso;
 
   <refsect1>
     <title>Author</title>

diff --git a/doc/lxc-stop.sgml.in b/doc/lxc-stop.sgml.in
index 31e4b9666529f8defd574ebc95a390f14032199a..6384c728b755ade12b9e4e8f7f93cbaf964fa6e4 100644 (file)
--- a/doc/lxc-stop.sgml.in
+++ b/doc/lxc-stop.sgml.in
@@ -23,7 +23,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -110,18 +113,7 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
   </refsect1>
 
-  <refsect1>
-    <title>See Also</title>
-
-    <simpara>    
-      <citerefentry>
-       <refentrytitle><command>lxc-start</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-    </simpara>
-
-
-  </refsect1>
+  &seealso;
 
   <refsect1>
     <title>Author</title>

diff --git a/doc/lxc-unfreeze.sgml.in b/doc/lxc-unfreeze.sgml.in
index 1e36fdf32fd968eafedbf64c512a7f662d457ad3..f2360a03d5914187646d53cf281468919eae9bb4 100644 (file)
--- a/doc/lxc-unfreeze.sgml.in
+++ b/doc/lxc-unfreeze.sgml.in
@@ -23,7 +23,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -98,18 +101,7 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
   </refsect1>
 
-  <refsect1>
-    <title>See Also</title>
-
-    <simpara>    
-      <citerefentry>
-       <refentrytitle><command>lxc-unfreeze</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-    </simpara>
-
-
-  </refsect1>
+  &seealso;
 
   <refsect1>
     <title>Author</title>

diff --git a/doc/lxc-wait.sgml.in b/doc/lxc-wait.sgml.in
index dc6d1e5d57be6aa1c9e1b057b8814d4435897a70..5dc3566283c6402706619ab18549dab4aa9ac338 100644 (file)
--- a/doc/lxc-wait.sgml.in
+++ b/doc/lxc-wait.sgml.in
@@ -24,7 +24,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -134,18 +137,7 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
   </refsect1>
 
-  <refsect1>
-    <title>See Also</title>
-
-    <simpara>    
-      <citerefentry>
-       <refentrytitle>lxc-info</refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-    </simpara>
-
-
-  </refsect1>
+  &seealso;
 
   <refsect1>
     <title>Author</title>

diff --git a/doc/lxc.conf.sgml.in b/doc/lxc.conf.sgml.in
index 66ea4d546cdcb5f5dc34b710816cea7636ea1cdd..76319d1850f5ccb5b5760f880ca85699386839e5 100644 (file)
--- a/doc/lxc.conf.sgml.in
+++ b/doc/lxc.conf.sgml.in
@@ -23,7 +23,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -589,16 +592,6 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
   <refsect1>
     <title>See Also</title>
     <simpara>    
-      <citerefentry>
-       <refentrytitle><command>lxc-create</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-      
-      <citerefentry>
-       <refentrytitle><command>lxc-execute</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
       <citerefentry>
        <refentrytitle><command>chroot</command></refentrytitle>
        <manvolnum>1</manvolnum>
@@ -617,6 +610,8 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
     </simpara>
   </refsect1>
   
+  &seealso;
+
   <refsect1>
     <title>Author</title>
     <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>

diff --git a/doc/lxc.sgml.in b/doc/lxc.sgml.in
index 2dfd79febfe00b1715e9fb6fd45e49326a9bb237..31f5e1807ac3a5a67496fb8a35c60506e45243b0 100644 (file)
--- a/doc/lxc.sgml.in
+++ b/doc/lxc.sgml.in
@@ -23,7 +23,10 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
 -->
 
-<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
+<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
+]>
 
 <refentry>
 
@@ -577,86 +580,7 @@ rootfs
     the frozen version.</para>
   </refsect1>
 
-  <refsect1>
-    <title>See Also</title>
-    <simpara>    
-      <citerefentry>
-       <refentrytitle><command>lxc-create</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-destroy</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-start</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-execute</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-stop</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-console</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-monitor</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-      
-      <citerefentry>
-       <refentrytitle><command>lxc-wait</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-cgroup</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-ls</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-ps</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-info</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-freeze</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc-unfreeze</command></refentrytitle>
-       <manvolnum>1</manvolnum>
-      </citerefentry>,
-
-      <citerefentry>
-       <refentrytitle><command>lxc.conf</command></refentrytitle>
-       <manvolnum>5</manvolnum>
-      </citerefentry>,
-
-    </simpara>
-  </refsect1>
+  &seealso;
 
   <refsect1>
     <title>Author</title>

diff --git a/doc/see_also.sgml.in b/doc/see_also.sgml.in
new file mode 100644 (file)
index 0000000..93b9344
--- /dev/null
+++ b/doc/see_also.sgml.in
@@ -0,0 +1,113 @@
+<!--
+
+lxc: linux Container library
+
+(C) Copyright IBM Corp. 2007, 2008
+
+Authors:
+Daniel Lezcano <dlezcano at fr.ibm.com>
+
+This library is free software; you can redistribute it and/or
+modify it under the terms of the GNU Lesser General Public
+License as published by the Free Software Foundation; either
+version 2.1 of the License, or (at your option) any later version.
+
+This library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public
+License along with this library; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+-->
+
+  <refsect1>
+    <title>See Also</title>
+
+    <simpara>
+      <citerefentry>
+       <refentrytitle><command>lxc</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-create</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-destroy</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-start</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-stop</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-execute</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-console</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-monitor</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-wait</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-cgroup</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-ls</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-ps</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-info</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-freeze</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc-unfreeze</command></refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+       <refentrytitle><command>lxc.conf</command></refentrytitle>
+       <manvolnum>5</manvolnum>
+      </citerefentry>
+
+    </simpara>
+
+  </refsect1>
+