man: convert depmod.d.sgml to xml and update it

2 files changed, 128 insertions, 130 deletions

diff --git a/man/depmod.d.sgml b/man/depmod.d.sgml
deleted file mode 100644
index b5ab5bc..0000000
--- a/man/depmod.d.sgml
+++ /dev/null
@@ -1,130 +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>depmod.d</refentrytitle>
-    <manvolnum>5</manvolnum>
-  </refmeta>
-  <refnamediv>
-    <refname>depmod.d</refname><refname>depmod.d</refname> <refpurpose>Configuration directory for depmod</refpurpose>
-  </refnamediv>
-  <refsect1>
-    <title>DESCRIPTION</title>
-
-    <para>The order in which modules are processed by the
-      <command>depmod</command> command can be altered on a global or
-      per-module basis. This is typically useful in cases where built-in
-      kernel modules are complemented by custom built versions of the
-      same and the user wishes to affect the priority of processing in
-      order to override the module version supplied by the kernel.
-    </para>
-    <para>
-      The format of files under <filename>depmod.d</filename> is simple: one
-      command per line, with blank lines and lines starting with '#'
-      ignored (useful for adding comments).  A '\' at the end of a line
-      causes it to continue on the next line, which makes the files a
-      bit neater.
-    </para>
-  </refsect1>
-  <refsect1>
-    <title>COMMANDS</title>
-    <variablelist>
-      <varlistentry>
-        <term>search <replaceable>subdirectory...</replaceable>
-        </term>
-	<listitem>
-	  <para>
-	    This allows you to specify the order in which /lib/modules
-	    (or other configured module location) subdirectories will
-	    be processed by <command>depmod</command>. Directories are
-	    listed in order, with the highest priority given to the
-	    first listed directory and the lowest priority given to the last
-	    directory listed. The special keyword <command>built-in</command> 
-	    refers to the standard module directories installed by the kernel.
-	  </para>
-	  <para>
-	    By default, depmod will give a higher priority to 
-	    a directory with the name <command>updates</command>
-	    using this built-in search string: "updates built-in"
-	    but more complex arrangements are possible and are
-	    used in several popular distributions.
-	  </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>override <replaceable>modulename</replaceable> <replaceable>kernelversion</replaceable> <replaceable>modulesubdirectory</replaceable>
-        </term>
-	<listitem>
-	  <para>
-	    This command allows you to override which version of a
-	    specific module will be used when more than one module
-	    sharing the same name is processed by the
-	    <command>depmod</command> command. It is possible to
-	    specify one kernel or all kernels using the * wildcard.
-	    <replaceable>modulesubdirectory</replaceable> is the
-	    name of the subdirectory under /lib/modules (or other
-	    module location) where the target module is installed.
-	  </para>
-	  <para>
-	    For example, it is possible to override the priority of
-	    an updated test module called <command>kmod</command> by
-	    specifying the following command: "override kmod * extra".
-	    This will ensure that any matching module name installed
-	    under the <command>extra</command> subdirectory within
-	    /lib/modules (or other module location) will take priority
-	    over any likenamed module already provided by the kernel.
-	  </para>
-        </listitem>
-      </varlistentry>
-    </variablelist>
-  </refsect1>
-  <refsect1>
-    <title>COPYRIGHT</title>
-    <para>
-      This manual page Copyright 2006-2010, Jon Masters, Red Hat, Inc.
-    </para>
-  </refsect1>
-    <refsect1>
-    <title>SEE ALSO</title>
-    <para><citerefentry>
-	<refentrytitle>depmod</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/depmod.d.xml b/man/depmod.d.xml
new file mode 100644
index 0000000..ecf783e
--- /dev/null
+++ b/man/depmod.d.xml
@@ -0,0 +1,128 @@
+<?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="depmod.d">
+  <refentryinfo>
+    <title>depmod.d</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>Robby</firstname>
+        <surname>Workman</surname>
+        <email>rworkman@slackware.com</email>
+      </author>
+      <author>
+        <contrib>Developer</contrib>
+        <firstname>Lucas</firstname>
+        <surname>De Marchi</surname>
+        <email>lucas.demarchi@profusion.mobi</email>
+      </author>
+    </authorgroup>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>depmod.d</refentrytitle>
+    <manvolnum>5</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>depmod.d</refname>
+    <refpurpose>Configuration directory for depmod</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <para><filename>/usr/lib/depmod.d/*.conf</filename></para>
+    <para><filename>/etc/depmod.d/*.conf</filename></para>
+    <para><filename>/run/depmod.d/*.conf</filename></para>
+  </refsynopsisdiv>
+
+  <refsect1><title>DESCRIPTION</title>
+    <para>The order in which modules are processed by the
+      <command>depmod</command> command can be altered on a global or
+      per-module basis. This is typically useful in cases where built-in
+      kernel modules are complemented by custom built versions of the
+      same and the user wishes to affect the priority of processing in
+      order to override the module version supplied by the kernel.
+    </para>
+    <para>
+      The format of files under <filename>depmod.d</filename> is simple: one
+      command per line, with blank lines and lines starting with '#'
+      ignored (useful for adding comments).  A '\' at the end of a line
+      causes it to continue on the next line, which makes the files a
+      bit neater.
+    </para>
+  </refsect1>
+  <refsect1>
+    <title>COMMANDS</title>
+    <variablelist>
+      <varlistentry>
+        <term>search <replaceable>subdirectory...</replaceable>
+        </term>
+        <listitem>
+          <para>
+            This allows you to specify the order in which /lib/modules
+            (or other configured module location) subdirectories will
+            be processed by <command>depmod</command>. Directories are
+            listed in order, with the highest priority given to the
+            first listed directory and the lowest priority given to the last
+            directory listed. The special keyword <command>built-in</command> 
+            refers to the standard module directories installed by the kernel.
+          </para>
+          <para>
+            By default, depmod will give a higher priority to 
+            a directory with the name <command>updates</command>
+            using this built-in search string: "updates built-in"
+            but more complex arrangements are possible and are
+            used in several popular distributions.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>override <replaceable>modulename</replaceable> <replaceable>kernelversion</replaceable> <replaceable>modulesubdirectory</replaceable>
+        </term>
+        <listitem>
+          <para>
+            This command allows you to override which version of a
+            specific module will be used when more than one module
+            sharing the same name is processed by the
+            <command>depmod</command> command. It is possible to
+            specify one kernel or all kernels using the * wildcard.
+            <replaceable>modulesubdirectory</replaceable> is the
+            name of the subdirectory under /lib/modules (or other
+            module location) where the target module is installed.
+          </para>
+          <para>
+            For example, it is possible to override the priority of
+            an updated test module called <command>kmod</command> by
+            specifying the following command: "override kmod * extra".
+            This will ensure that any matching module name installed
+            under the <command>extra</command> subdirectory within
+            /lib/modules (or other module location) will take priority
+            over any likenamed module already provided by the kernel.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1><title>COPYRIGHT</title>
+    <para>
+      This manual page Copyright 2006-2010, Jon Masters, Red Hat, Inc.
+    </para>
+  </refsect1>
+  <refsect1><title>SEE ALSO</title>
+    <para>
+      <citerefentry>
+        <refentrytitle>depmod</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>
+    </para>
+  </refsect1>
+</refentry>