From 1efec3a2cb5e4d14f051939ce7ab16de996ddaff Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Sat, 6 Aug 2005 21:53:05 +0000
Subject: [PATCH] * add man pages for: 	avahi-publish-address 
 avahi-resolve-address 	avahi-resolve-host-name

git-svn-id: file:///home/lennart/svn/public/avahi/trunk@252 941a03a8-eaeb-0310-b9a0-b1bbd8fe43fe
---
 avahi-utils/avahi-resolve-address.in |  2 +-
 man/Makefile.am                      | 39 ++++++++++++++++-
 man/avahi-publish-address.1.xml.in   | 63 ++++++++++++++++++++++++++++
 man/avahi-publish-service.1.xml.in   |  4 +-
 man/avahi-resolve-address.1.xml.in   | 60 ++++++++++++++++++++++++++
 man/avahi-resolve-host-name.1.xml.in | 60 ++++++++++++++++++++++++++
 6 files changed, 223 insertions(+), 5 deletions(-)
 create mode 100644 man/avahi-publish-address.1.xml.in
 create mode 100644 man/avahi-resolve-address.1.xml.in
 create mode 100644 man/avahi-resolve-host-name.1.xml.in

diff --git a/avahi-utils/avahi-resolve-address.in b/avahi-utils/avahi-resolve-address.in
index b72a95b..71c6287 100755
--- a/avahi-utils/avahi-resolve-address.in
+++ b/avahi-utils/avahi-resolve-address.in
@@ -34,7 +34,7 @@ except ImportError, e:
 
 
 if len(sys.argv) <= 1:
-    print "Please specify host name(s) to resolve."
+    print "Please specify (an) address(es) to resolve."
     sys.exit(1)
 
 bus = dbus.SystemBus()
diff --git a/man/Makefile.am b/man/Makefile.am
index ddf9c2e..8fbe35c 100644
--- a/man/Makefile.am
+++ b/man/Makefile.am
@@ -19,16 +19,25 @@
 
 man_MANS = \
 	avahi-browse.1 \
-	avahi-publish-service.1
+	avahi-publish-service.1 \
+	avahi-publish-address.1 \
+	avahi-resolve-address.1 \
+	avahi-resolve-host-name.1
 
 noinst_DATA = \
 	avahi-browse.1.xml \
-	avahi-publish-service.1.xml
+	avahi-publish-service.1.xml \
+	avahi-publish-address.1.xml \
+	avahi-resolve-address.1.xml \
+	avahi-resolve-host-name.1.xml
 
 EXTRA_DIST = \
 	$(man_MANS) \
 	avahi-browse.1.xml.in \
 	avahi-publish-service.1.xml.in \
+	avahi-publish-address.1.xml.in \
+	avahi-resolve-address.1.xml.in \
+	avahi-resolve-host-name.1.xml.in \
 	xmltoman.css \
 	xmltoman.xsl \
 	xmltoman.dtd
@@ -48,6 +57,24 @@ avahi-publish-service.1.xml: avahi-publish-service.1.xml.in Makefile
 		-e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \
         -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@
 
+avahi-publish-address.1.xml: avahi-publish-address.1.xml.in Makefile
+	sed -e 's,@sysconfdir\@,$(sysconfdir),g' \
+	    -e 's,@sbindir\@,$(sbindir),g' \
+		-e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \
+        -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@
+
+avahi-resolve-address.1.xml: avahi-resolve-address.1.xml.in Makefile
+	sed -e 's,@sysconfdir\@,$(sysconfdir),g' \
+	    -e 's,@sbindir\@,$(sbindir),g' \
+		-e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \
+        -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@
+
+avahi-resolve-host-name.1.xml: avahi-resolve-host-name.1.xml.in Makefile
+	sed -e 's,@sysconfdir\@,$(sysconfdir),g' \
+	    -e 's,@sbindir\@,$(sbindir),g' \
+		-e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \
+        -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@
+
 if USE_XMLTOMAN
 
 CLEANFILES += $(man_MANS)
@@ -58,5 +85,13 @@ avahi-browse.1: avahi-browse.1.xml Makefile
 avahi-publish-service.1: avahi-publish-service.1.xml Makefile
 	xmltoman $< > $@
 
+avahi-publish-address.1: avahi-publish-address.1.xml Makefile
+	xmltoman $< > $@
+
+avahi-resolve-address.1: avahi-resolve-address.1.xml Makefile
+	xmltoman $< > $@
+
+avahi-resolve-host-name.1: avahi-resolve-host-name.1.xml Makefile
+	xmltoman $< > $@
 
 endif
diff --git a/man/avahi-publish-address.1.xml.in b/man/avahi-publish-address.1.xml.in
new file mode 100644
index 0000000..003f7b2
--- /dev/null
+++ b/man/avahi-publish-address.1.xml.in
@@ -0,0 +1,63 @@
+<?xml version="1.0"?><!--*-nxml-*-->
+<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
+<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
+
+<!-- $Id$ -->
+
+<!-- 
+  This file is part of avahi.
+ 
+  avahi is free software; you can redistribute it and/or modify it
+  under the terms of the GNU Lesser General Public License as
+  published by the Free Software Foundation; either version 2.1 of the
+  License, or (at your option) any later version.
+ 
+  avahi is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+  or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
+  Public License for more details.
+ 
+  You should have received a copy of the GNU Lesser General Public
+  License along with avahi; if not, write to the Free Software
+  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+  USA.
+-->
+
+  <manpage name="avahi-publish-address" section="1" desc="Register an mDNS host name using the Avahi daemon">
+
+	<synopsis>
+      <cmd>avahi-publish-address <arg>name</arg> <arg>address</arg></cmd>
+	</synopsis>
+	
+    <description>
+      <p>Register an mDNS host name to address mapping (and vice versa) using the Avahi daemon.</p>
+	</description>
+	
+	<options>
+
+      <p>Specify a DNS host name (FQDN, e.g. "foobar.local") and an IP
+      address (e.g. "192.168.50.1" or "2001:db8:0:1::1") on the
+      command line.</p>
+	  
+	</options>
+	
+	<section name="Authors">
+	  <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+	  available from <url href="@PACKAGE_URL@"/></p>
+	</section>
+	
+	<section name="See also">
+	  <p>
+        <manref name="avahi-publish-service" section="1"/>, 
+        <manref name="avahi-resolve-address" section="1"/>, 
+        <manref name="avahi-resolve-host-name" section="1"/>, 
+        <manref name="avahi-daemon" section="8"/>
+	  </p>
+	</section>
+	
+	<section name="Comments">
+	  <p>This man page was written using <manref name="xml2man" section="1"
+		  href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p>
+	</section>
+	
+  </manpage>
diff --git a/man/avahi-publish-service.1.xml.in b/man/avahi-publish-service.1.xml.in
index 4f68890..2f5e7a8 100644
--- a/man/avahi-publish-service.1.xml.in
+++ b/man/avahi-publish-service.1.xml.in
@@ -26,8 +26,8 @@
   <manpage name="avahi-publish-service" section="1" desc="Register an mDNS/DNS-SD service using the Avahi daemon">
 
 	<synopsis>
-      <cmd>avahi-browse [<arg>options</arg>] <arg>name</arg> <arg>service-type</arg> <arg>port</arg></cmd>
-      <cmd>avahi-browse <opt>-h</opt></cmd>
+      <cmd>avahi-publish-service [<arg>options</arg>] <arg>name</arg> <arg>service-type</arg> <arg>port</arg></cmd>
+      <cmd>avahi-publish-service <opt>-h</opt></cmd>
 	</synopsis>
 	
     <description>
diff --git a/man/avahi-resolve-address.1.xml.in b/man/avahi-resolve-address.1.xml.in
new file mode 100644
index 0000000..234f1f3
--- /dev/null
+++ b/man/avahi-resolve-address.1.xml.in
@@ -0,0 +1,60 @@
+<?xml version="1.0"?><!--*-nxml-*-->
+<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
+<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
+
+<!-- $Id$ -->
+
+<!-- 
+  This file is part of avahi.
+ 
+  avahi is free software; you can redistribute it and/or modify it
+  under the terms of the GNU Lesser General Public License as
+  published by the Free Software Foundation; either version 2.1 of the
+  License, or (at your option) any later version.
+ 
+  avahi is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+  or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
+  Public License for more details.
+ 
+  You should have received a copy of the GNU Lesser General Public
+  License along with avahi; if not, write to the Free Software
+  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+  USA.
+-->
+
+  <manpage name="avahi-resolve-address" section="1" desc="Resolve one or more IP address(es) to mDNS host name(s) using the Avahi daemon">
+
+	<synopsis>
+      <cmd>avahi-resolve-address <arg>address ...</arg></cmd>
+	</synopsis>
+	
+    <description>
+      <p>Resolve one or more IP address(es) to mDNS host name(s) using the Avahi daemon ("reverse name lookup").</p>
+	</description>
+	
+	<options>
+
+      <p>Specify one or more IP address(es) (e.g. "192.168.50.1" or "2001:db8:0:1::1") for being resolved into host names on the command line.</p>
+	  
+	</options>
+	
+	<section name="Authors">
+	  <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+	  available from <url href="@PACKAGE_URL@"/></p>
+	</section>
+	
+	<section name="See also">
+	  <p>
+        <manref name="avahi-publish-address" section="1"/>, <manref
+        name="avahi-resolve-host-name" section="1"/>, <manref
+        name="avahi-daemon" section="8"/>
+	  </p>
+	</section>
+	
+	<section name="Comments">
+	  <p>This man page was written using <manref name="xml2man" section="1"
+		  href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p>
+	</section>
+	
+  </manpage>
diff --git a/man/avahi-resolve-host-name.1.xml.in b/man/avahi-resolve-host-name.1.xml.in
new file mode 100644
index 0000000..9c9b0a6
--- /dev/null
+++ b/man/avahi-resolve-host-name.1.xml.in
@@ -0,0 +1,60 @@
+<?xml version="1.0"?><!--*-nxml-*-->
+<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
+<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
+
+<!-- $Id$ -->
+
+<!-- 
+  This file is part of avahi.
+ 
+  avahi is free software; you can redistribute it and/or modify it
+  under the terms of the GNU Lesser General Public License as
+  published by the Free Software Foundation; either version 2.1 of the
+  License, or (at your option) any later version.
+ 
+  avahi is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+  or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
+  Public License for more details.
+ 
+  You should have received a copy of the GNU Lesser General Public
+  License along with avahi; if not, write to the Free Software
+  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+  USA.
+-->
+
+  <manpage name="avahi-resolve-host-name" section="1" desc="Resolve one or more mDNS host name(s) to IP address(es) using the Avahi daemon">
+
+	<synopsis>
+      <cmd>avahi-resolve-host-name <arg>host-name ...</arg></cmd>
+	</synopsis>
+	
+    <description>
+      <p>Resolve one or more mDNS host name(s) to IP address(es) using the Avahi daemon</p>
+	</description>
+	
+	<options>
+      
+      <p>Specify one or more mDNS host name(s) (e.g. "foo.local") for being resolved into IP addresses on the command line.</p>
+      
+	</options>
+	
+	<section name="Authors">
+	  <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+	  available from <url href="@PACKAGE_URL@"/></p>
+	</section>
+	
+	<section name="See also">
+	  <p>
+        <manref name="avahi-publish-address" section="1"/>, <manref
+        name="avahi-resolve-address" section="1"/>, <manref
+        name="avahi-daemon" section="8"/>
+	  </p>
+	</section>
+	
+	<section name="Comments">
+	  <p>This man page was written using <manref name="xml2man" section="1"
+		  href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p>
+	</section>
+	
+  </manpage>
-- 
2.39.5