* improved manpages.

- added nm-vpn-properties, nm-applet manpages
- added debian/nm-applet.manpages
* uploaded to unstable.

git-svn-id: svn+ssh://svn.debian.org/svn/pkg-utopia/packages/unstable/networkmanager@562 ceb527fc-18e6-0310-9fe2-813c157c29e7

5 files changed, 206 insertions, 1 deletions

diff --git a/debian/changelog b/debian/changelog
index d3d488a4..ae89ee9f 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,12 @@
+network-manager (0.5.1-2) unstable; urgency=low
+
+  * improved manpages.
+  - added nm-vpn-properties, nm-applet manpages
+  - added debian/nm-applet.manpages
+  * uploaded to unstable.
+
+ -- Riccardo Setti <giskard@autistici.org>  Wed,  8 Feb 2006 22:08:42 +0100
+
 network-manager (0.5.1-1) experimental; urgency=low
 
   * renamed 25NetworkManagerDispatcher in 26NetworkManagerDispatcher because
diff --git a/debian/nm-applet.manpages b/debian/nm-applet.manpages
new file mode 100644
index 00000000..15a34e96
--- /dev/null
+++ b/debian/nm-applet.manpages
@@ -0,0 +1,2 @@
+debian/nm-vpn-properties.1
+debian/nm-applet.1
diff --git a/debian/nm-applet.sgml b/debian/nm-applet.sgml
new file mode 100644
index 00000000..0194d70b
--- /dev/null
+++ b/debian/nm-applet.sgml
@@ -0,0 +1,97 @@
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+
+<!-- Process this file with docbook-to-man to generate an nroff manual
+     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
+     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
+     less'.  A typical entry in a Makefile or Makefile.am is:
+
+manpage.1: manpage.sgml
+	docbook-to-man $< > $@
+
+    
+	The docbook-to-man binary is found in the docbook-to-man package.
+	Please remember that if you create the nroff version in one of the
+	debian/rules file targets (such as build), you will need to include
+	docbook-to-man in your Build-Depends control field.
+
+  -->
+
+  <!-- Please adjust the date whenever revising the manpage. -->
+  <!ENTITY date        "<date>8 February, 2006</date>">
+  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
+       allowed: see man(7), man(1). -->
+  <!ENTITY package     "nm-applet">
+  <!ENTITY gnu         "<acronym>GNU</acronym>">
+  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
+]>
+
+<refentry>
+  <refentryinfo>
+    <address>
+      <email>giskard@autistici.org</email>;
+    </address>
+    <author>
+      <firstname>Riccardo</firstname>
+      <surname>Setti</surname>
+    </author>
+    <copyright>
+      <year>2006</year>
+      <holder>Riccardo Setti</holder>
+    </copyright>
+    &date;
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>nm-applet</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+  <refnamediv>
+    <refname>&package;</refname>
+
+    <refpurpose>Network management framework</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>&package;</command>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+
+    <para><command>&package;</command> is the gnome front-end for NetworkManager</para>
+	 <para>If you want to know how you can add by default nm-applet in your gnome notify-area, please read README.Debian
+	 in /usr/share/common/&package;
+  </refsect1>
+  <refsect1>
+    <title>SEE ALSO</title>
+
+    <para>NetworkManager (1). nm-vpn-properties (1)</para>
+
+    <para>More Information about NetworkManager can be found at
+      http://www.gnome.org/projects/NetworkManager/ .</para>
+  </refsect1>
+  <refsect1>
+    <title>AUTHOR</title>
+
+    <para>This manual page was written by Riccardo Setti <email>giskard@autistici.org</email> for
+      the <productname>Debian</productname> system.
+    </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/debian/nm-vpn-properties.sgml b/debian/nm-vpn-properties.sgml
new file mode 100644
index 00000000..7b42239e
--- /dev/null
+++ b/debian/nm-vpn-properties.sgml
@@ -0,0 +1,95 @@
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+
+<!-- Process this file with docbook-to-man to generate an nroff manual
+     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
+     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
+     less'.  A typical entry in a Makefile or Makefile.am is:
+
+manpage.1: manpage.sgml
+	docbook-to-man $< > $@
+
+    
+	The docbook-to-man binary is found in the docbook-to-man package.
+	Please remember that if you create the nroff version in one of the
+	debian/rules file targets (such as build), you will need to include
+	docbook-to-man in your Build-Depends control field.
+
+  -->
+
+  <!-- Please adjust the date whenever revising the manpage. -->
+  <!ENTITY date        "<date>8 February, 2006</date>">
+  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
+       allowed: see man(7), man(1). -->
+  <!ENTITY package     "nm-vpn-properties">
+  <!ENTITY gnu         "<acronym>GNU</acronym>">
+  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
+]>
+
+<refentry>
+  <refentryinfo>
+    <address>
+      <email>giskard@autistici.org</email>;
+    </address>
+    <author>
+      <firstname>Riccardo</firstname>
+      <surname>Setti</surname>
+    </author>
+    <copyright>
+      <year>2006</year>
+      <holder>Riccardo Setti</holder>
+    </copyright>
+    &date;
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>nm-vpn-properties</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+  <refnamediv>
+    <refname>&package;</refname>
+
+    <refpurpose>Network management framework</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>&package;</command>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+
+    <para><command>&package;</command> is the gnome front-end for the NetworkManager VPN handler</para>
+  </refsect1>
+  <refsect1>
+    <title>SEE ALSO</title>
+
+    <para>NetworkManager (1), nm-applet (1)</para>
+
+    <para>More Information about NetworkManager can be found at
+      http://www.gnome.org/projects/NetworkManager/ .</para>
+  </refsect1>
+  <refsect1>
+    <title>AUTHOR</title>
+
+    <para>This manual page was written by Riccardo Setti <email>giskard@autistici.org</email> for
+      the <productname>Debian</productname> system.
+    </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/debian/rules b/debian/rules
index 8c8bfe3e..e140634f 100755
--- a/debian/rules
+++ b/debian/rules
@@ -19,7 +19,9 @@ clean::
 build/network-manager::
 	
 	/usr/bin/docbook-to-man debian/NetworkManagerDispatcher.sgml > debian/NetworkManagerDispatcher.1
-	/usr/bin/docbook-to-man debian/NetworkManager.sgml > debian/NetworkManager.1
+	/usr/bin/docbook-to-man debian/NetworkManagerDispatcher.sgml > debian/NetworkManagerDispatcher.1
+	/usr/bin/docbook-to-man debian/nm-vpn-properties > nm-vpn-properties.1
+	/usr/bin/docbook-to-man debian/nm-applet > nm-applet.1
 	
 binary-install/network-manager::
 	install -m 755 debian/network-manager.dbus-event \