man: build rmmod man page

diff --git a/man/Makefile.am b/man/Makefile.am
index f8c3e60..dbe11c7 100644 (file)
--- a/man/Makefile.am
+++ b/man/Makefile.am
@@ -1,5 +1,5 @@
 MAN5 = depmod.d.5 modprobe.d.5 modules.dep.5
-MAN8 = depmod.8 insmod.8 lsmod.8
+MAN8 = depmod.8 insmod.8 lsmod.8 rmmod.8
 
 dist_man_MANS = $(MAN5) $(MAN8) $(MAN_STUB)
 

diff --git a/man/rmmod.sgml b/man/rmmod.sgml
deleted file mode 100644 (file)
index bd009b7..0000000
--- a/man/rmmod.sgml
+++ /dev/null
@@ -1,159 +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>rmmod</refentrytitle>
-    <manvolnum>8</manvolnum>
-  </refmeta>
-  <refnamediv>
-    <refname>rmmod</refname> <refpurpose>simple program to remove a module from the Linux Kernel</refpurpose>
-  </refnamediv>
-  <refsynopsisdiv>
-    <cmdsynopsis>
-      <command>rmmod</command>
-      <arg><option>-f</option></arg>
-      <arg><option>-w</option></arg>
-      <arg><option>-s</option></arg>
-      <arg><option>-v</option></arg>
-      <arg><replaceable>modulename</replaceable></arg>
-    </cmdsynopsis>
-  </refsynopsisdiv>
-  <refsect1>
-    <title>DESCRIPTION</title>
-
-    <para><command>rmmod</command> is a trivial program to remove a
-      module (when module unloading support is provided) from the kernel.
-      Most users will want to use
-      <citerefentry>
-       <refentrytitle>modprobe</refentrytitle><manvolnum>8</manvolnum>
-      </citerefentry> with the <option>-r</option> option instead.
-    </para>
-  </refsect1>
-  <refsect1>
-    <title>OPTIONS</title>
-    <variablelist>
-      <varlistentry>
-        <term><option>-v</option> <option>--verbose</option>
-        </term>
-        <listitem>
-          <para>
-           Print messages about what the program is doing.
-           Usually <command>rmmod</command> prints messages
-           only if something goes wrong.
-         </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>-f</option> <option>--force</option>
-        </term>
-        <listitem>
-          <para>
-           This option can be extremely dangerous: it has no effect unless
-           CONFIG_MODULE_FORCE_UNLOAD was set when the kernel was
-           compiled.  With this option, you can remove modules which are
-           being used, or which are not designed to be removed, or have
-           been marked as unsafe (see <citerefentry>
-       <refentrytitle>lsmod</refentrytitle><manvolnum>8</manvolnum>
-      </citerefentry>).
-         </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>-w</option> <option>--wait</option>
-        </term>
-        <listitem>
-          <para>
-           Normally, <command>rmmod</command> will refuse to
-           unload modules which are in use.  With this option,
-           <command>rmmod</command> will isolate the module, and
-           wait until the module is no longer used.  Nothing new
-           will be able to use the module, but it's up to you to
-           make sure the current users eventually finish with it.
-           See <citerefentry>
-       <refentrytitle>lsmod</refentrytitle><manvolnum>8</manvolnum>
-      </citerefentry>) for information on usage counts.
-         </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>-s</option> <option>--syslog</option>
-        </term>
-        <listitem>
-          <para>
-           Send errors to syslog instead of standard error.
-         </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>-V</option> <option>--version</option>
-        </term>
-        <listitem>
-          <para>
-           Show version of program and exit.
-         </para>
-        </listitem>
-      </varlistentry>
-    </variablelist>
-  </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>modprobe</refentrytitle><manvolnum>8</manvolnum>
-      </citerefentry>,
-      <citerefentry>
-       <refentrytitle>insmod</refentrytitle><manvolnum>8</manvolnum>
-      </citerefentry>,
-      <citerefentry>
-       <refentrytitle>lsmod</refentrytitle><manvolnum>8</manvolnum>
-      </citerefentry>
-      <citerefentry>
-       <refentrytitle>modinfo</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/rmmod.xml b/man/rmmod.xml
new file mode 100644 (file)
index 0000000..2dfe971
--- /dev/null
+++ b/man/rmmod.xml
@@ -0,0 +1,149 @@
+<?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="rmmod">
+  <refentryinfo>
+    <title>rmmod</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>rmmod</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>rmmod</refname>
+    <refpurpose>
+      Simple program to remove a module from the Linux Kernel
+    </refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>rmmod</command>
+      <arg><option>-f</option></arg>
+      <arg><option>-w</option></arg>
+      <arg><option>-s</option></arg>
+      <arg><option>-v</option></arg>
+      <arg><replaceable>modulename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>DESCRIPTION</title>
+    <para>
+      <command>rmmod</command> is a trivial program to remove a module (when
+      module unloading support is provided) from the kernel.  Most users will
+      want to use
+      <citerefentry>
+        <refentrytitle>modprobe</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry> with the <option>-r</option> option instead.
+    </para>
+  </refsect1>
+
+  <refsect1><title>OPTIONS</title>
+    <variablelist>
+      <varlistentry>
+        <term><option>-v</option> <option>--verbose</option>
+        </term>
+        <listitem>
+          <para>
+            Print messages about what the program is doing.
+            Usually <command>rmmod</command> prints messages
+            only if something goes wrong.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-f</option> <option>--force</option>
+        </term>
+        <listitem>
+          <para>
+            This option can be extremely dangerous: it has no effect unless
+            CONFIG_MODULE_FORCE_UNLOAD was set when the kernel was compiled.
+            With this option, you can remove modules which are being used, or
+            which are not designed to be removed, or have been marked as unsafe
+            (see <citerefentry>
+              <refentrytitle>lsmod</refentrytitle><manvolnum>8</manvolnum>
+            </citerefentry>).
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-w</option> <option>--wait</option>
+        </term>
+        <listitem>
+          <para>
+            Normally, <command>rmmod</command> will refuse to unload modules
+            which are in use.  With this option, <command>rmmod</command> will
+            isolate the module, and wait until the module is no longer used.
+            Nothing new will be able to use the module, but it's up to you to
+            make sure the current users eventually finish with it.  See
+            <citerefentry>
+              <refentrytitle>lsmod</refentrytitle><manvolnum>8</manvolnum>
+            </citerefentry>) for information on usage counts.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-s</option> <option>--syslog</option>
+        </term>
+        <listitem>
+          <para>
+            Send errors to syslog instead of standard error.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-V</option> <option>--version</option>
+        </term>
+        <listitem>
+          <para>
+            Show version of program and exit.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </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>modprobe</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>insmod</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>lsmod</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>
+      <citerefentry>
+        <refentrytitle>modinfo</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>
+    </para>
+  </refsect1>
+</refentry>