man: build modules.dep{,.bin} man pages

diff --git a/man/Makefile.am b/man/Makefile.am
index ebdc32d911938c5e7e283f007ed63bd01506ee83..d7e0f9eb7220019a9ad433438c3ae3eaf6c04121 100644 (file)
--- a/man/Makefile.am
+++ b/man/Makefile.am
@@ -1,9 +1,10 @@
-MAN5 = depmod.d.5 modprobe.d.5
+MAN5 = depmod.d.5 modprobe.d.5 modules.dep.5
 MAN8 =
 
-dist_man_MANS = $(MAN5) $(MAN8)
+dist_man_MANS = $(MAN5) $(MAN8) $(MAN_STUB)
 
 EXTRA_DIST = $(MAN5:%.5=%.xml) $(MAN8:%.8=%.xml)
+
 XSLTPROC_FLAGS = \
        --nonet \
        --param funcsynopsis.style "'ansi'"

diff --git a/man/modules.dep.sgml b/man/modules.dep.sgml
deleted file mode 100644 (file)
index a0b68ed..0000000
--- a/man/modules.dep.sgml
+++ /dev/null
@@ -1,89 +0,0 @@
-<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
-  <!ENTITY debian  "<productname>Debian GNU/Linux</productname>">
-  <!ENTITY docbook "<productname>DocBook</productname>">
-  <!ENTITY sgml    "<abbrev>SGML</abbrev>">
-]>
-
-<!-- Stolen from manual page for docbook-to-man, DocBook source file
-     (C) 1999 W. Borgert debacle@debian.org
-
-     $Id: docbook-to-man.sgml,v 1.8 2002/04/27 15:28:02 debacle Exp $ -->
-
-<refentry>
-  <refentryinfo>
-    <address>
-      <email>jcm@jonmasters.org</email>
-    </address>
-    <author>
-      <firstname>Jon</firstname>
-      <surname>Masters</surname>
-    </author>
-    <date>2010-03-01</date>
-  </refentryinfo>
-  <refmeta>
-    <refentrytitle>modules.dep</refentrytitle>
-    <manvolnum>5</manvolnum>
-  </refmeta>
-  <refnamediv>
-    <refname>modules.dep.bin</refname><refname>modules.dep</refname> <refpurpose>Module dependency information</refpurpose>
-  </refnamediv>
-  <refsect1>
-    <title>DESCRIPTION</title>
-
-    <para>
-      The <filename>modules.dep.bin</filename> as generated by
-      module-init-tools <command>depmod</command>, lists the
-      dependencies for every module in the directories under
-      <filename>/lib/modules/</filename><replaceable>version</replaceable>,
-      where <filename>modules.dep.bin</filename> (or the human readable
-      version <filename>modules.dep</filename>) is also located. It is
-      used by utilities such as <command>modprobe</command>. The
-      binary version will be used by default, if it was generated by
-      a compatible version of <command>depmod</command>, with fallback
-      to the generic <filename>modules.dep</filename>.
-    </para>
-    <para>
-      These files are not intended for editing or use by any additional
-      utilities as their format is subject to change in the future. You
-      should use the
-      <citerefentry><refentrytitle>modinfo</refentrytitle><manvolnum>8</manvolnum></citerefentry> command to obtain information about modules in a future
-      proof and compatible fashion rather than touching these files.
-    </para>
-  </refsect1>
-  <refsect1>
-    <title>COPYRIGHT</title>
-    <para>
-      This manual page originally Copyright 2002, Rusty Russell, IBM
-      Corporation. Maintained by Jon Masters and others.
-    </para>
-  </refsect1>
-  <refsect1>
-    <title>SEE ALSO</title>
-
-    <para>
-      <citerefentry>
-       <refentrytitle>depmod</refentrytitle><manvolnum>8</manvolnum>
-      </citerefentry>,
-      <citerefentry>
-       <refentrytitle>modprobe</refentrytitle><manvolnum>8</manvolnum>
-      </citerefentry>
-    </para>
-  </refsect1>
-</refentry>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:2
-sgml-indent-data:t
-sgml-parent-document:nil
-sgml-default-dtd-file:nil
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
--->

diff --git a/man/modules.dep.xml b/man/modules.dep.xml
new file mode 100644 (file)
index 0000000..d08991c
--- /dev/null
+++ b/man/modules.dep.xml
@@ -0,0 +1,79 @@
+<?xml version="1.0"?>
+<!--*-nxml-*-->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+<refentry id="modules.dep">
+  <refentryinfo>
+    <title>modules.dep</title>
+    <productname>kmod</productname>
+
+    <authorgroup>
+      <author>
+        <contrib>Developer</contrib>
+        <firstname>Jon</firstname>
+        <surname>Masters</surname>
+        <email>jcm@jonmasters.org</email>
+      </author>
+      <author>
+        <contrib>Developer</contrib>
+        <firstname>Lucas</firstname>
+        <surname>De Marchi</surname>
+        <email>lucas.demarchi@profusion.mobi</email>
+      </author>
+    </authorgroup>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>modules.dep</refentrytitle>
+    <manvolnum>5</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>modules.dep</refname>
+    <refname>modules.dep.bin</refname>
+    <refpurpose>Module dependency information</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <para><filename>/lib/modules/modules.dep</filename></para>
+    <para><filename>/lib/modules/modules.dep.bin</filename></para>
+  </refsynopsisdiv>
+
+  <refsect1><title>DESCRIPTION</title>
+    <para>
+      The <filename>modules.dep.bin</filename> as generated by
+      module-init-tools <command>depmod</command>, lists the dependencies for
+      every module in the directories under
+      <filename>/lib/modules/</filename><replaceable>version</replaceable>,
+      where <filename>modules.dep.bin</filename> (or the human readable version
+      <filename>modules.dep</filename>) is also located. It is used by
+      utilities such as <command>modprobe</command>. The binary version will be
+      used by default, if it was generated by a compatible version of
+      <command>depmod</command>, with fallback to the generic
+      <filename>modules.dep</filename>.
+    </para>
+    <para>
+      These files are not intended for editing or use by any additional
+      utilities as their format is subject to change in the future. You should
+      use the
+      <citerefentry><refentrytitle>modinfo</refentrytitle><manvolnum>8</manvolnum></citerefentry>
+      command to obtain information about modules in a future proof and
+      compatible fashion rather than touching these files.
+    </para>
+  </refsect1>
+  <refsect1><title>COPYRIGHT</title>
+    <para>
+      This manual page originally Copyright 2002, Rusty Russell, IBM
+      Corporation. Maintained by Jon Masters and others.
+    </para>
+  </refsect1>
+  <refsect1><title>SEE ALSO</title>
+    <para>
+      <citerefentry>
+        <refentrytitle>depmod</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>modprobe</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>
+    </para>
+  </refsect1>
+</refentry>