From: Lucas De Marchi <lucas.demarchi@profusion.mobi>
Date: Thu, 12 Jan 2012 15:53:55 +0000 (-0200)
Subject: man: build insmod man page
X-Git-Tag: v4~32
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d5578ee0db49a23441eb30c3b7e6e819beb21815;p=thirdparty%2Fkmod.git

man: build insmod man page
---

diff --git a/man/Makefile.am b/man/Makefile.am
index 2ce9f6e1..632b6a02 100644
--- 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
+MAN8 = depmod.8 insmod.8
 
 dist_man_MANS = $(MAN5) $(MAN8) $(MAN_STUB)
 
diff --git a/man/insmod.sgml b/man/insmod.sgml
deleted file mode 100644
index ab3a4e87..00000000
--- a/man/insmod.sgml
+++ /dev/null
@@ -1,94 +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>insmod</refentrytitle>
-    <manvolnum>8</manvolnum>
-  </refmeta>
-  <refnamediv>
-    <refname>insmod</refname> <refpurpose>simple program to insert a module into the Linux Kernel</refpurpose>
-  </refnamediv>
-  <refsynopsisdiv>
-    <cmdsynopsis>
-      <command>insmod</command>
-      <arg><replaceable>filename</replaceable></arg>
-      <arg rep='repeat'><replaceable>module options</replaceable></arg>
-    </cmdsynopsis>
-  </refsynopsisdiv>
-  <refsect1>
-    <title>DESCRIPTION</title>
-
-    <para><command>insmod</command> is a trivial program to insert a
-	module into the kernel: if the
-	<replaceable>filename</replaceable> is a hyphen, the module is
-	taken from standard input. Most users will want to use
-	<citerefentry><refentrytitle>modprobe</refentrytitle>
-	<manvolnum>8</manvolnum> </citerefentry> instead, which is
-	more clever and can handle module dependencies.</para>
-
-    <para>Only the most general of error messages are reported: as the
-	work of trying to link the module is now done inside the kernel,
-	the <command>dmesg</command> usually gives more information
-	about errors.</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>modprobe</refentrytitle><manvolnum>8</manvolnum>
-      </citerefentry>,
-      <citerefentry>
-	<refentrytitle>rmmod</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/insmod.xml b/man/insmod.xml
new file mode 100644
index 00000000..1529d350
--- /dev/null
+++ b/man/insmod.xml
@@ -0,0 +1,85 @@
+<?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="insmod">
+  <refentryinfo>
+    <title>insmod</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>insmod</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>insmod</refname>
+    <refpurpose>
+      Simple program to insert a module into the Linux Kernel
+    </refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>insmod</command>
+      <arg><replaceable>filename</replaceable></arg>
+      <arg rep='repeat'><replaceable>module options</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>DESCRIPTION</title>
+    <para>
+      <command>insmod</command> is a trivial program to insert a module into
+      the kernel: if the <replaceable>filename</replaceable> is a hyphen, the
+      module is taken from standard input. Most users will want to use
+      <citerefentry><refentrytitle>modprobe</refentrytitle>
+        <manvolnum>8</manvolnum> </citerefentry> instead, which is more clever
+      and can handle module dependencies.
+    </para>
+    <para>
+      Only the most general of error messages are reported: as the work of
+      trying to link the module is now done inside the kernel, the
+      <command>dmesg</command> usually gives more information about errors.
+    </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>modprobe</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>rmmod</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>lsmod</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>
+      <citerefentry>
+        <refentrytitle>modinfo</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>
+    </para>
+  </refsect1>
+</refentry>