patches/avahi-08-man-page.diff
changeset 10044 7508208432e4
child 10115 220be1ae65d0
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/patches/avahi-08-man-page.diff	Tue Jun 12 10:44:53 2007 +0000
@@ -0,0 +1,259 @@
+--- /usr/tmp/clean/avahi-0.6.19/man/Makefile.am	Wed May  9 15:30:24 2007
++++ avahi-0.6.19/man/Makefile.am	Wed Jun  6 14:31:45 2007
+@@ -47,6 +47,11 @@
+ 	avahi-autoipd.action.8.xml \
+ 	bssh.1.xml
+ 
++if HAVE_BONJOUR
++noinst_DATA += \
++       avahi-daemon.1.xml
++endif
++
+ CLEANFILES = \
+ 	$(noinst_DATA)
+ 
+@@ -80,6 +85,15 @@
+ endif
+ endif
+ 
++if HAVE_BONJOUR
++man_MANS += \
++	avahi-daemon.1
++
++avahi-daemon.1.xml: avahi-daemon.1.xml.in Makefile
++	sed -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \
++        -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@
++endif
++
+ avahi-browse.1.xml: avahi-browse.1.xml.in Makefile
+ 	sed -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \
+         -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@
+@@ -155,6 +169,11 @@
+ 
+ CLEANFILES += $(man_MANS)
+ 
++if HAVE_BONJOUR
++avahi-daemon.1: avahi-daemon.1.xml Makefile
++	xmltoman $< > $@
++endif
++
+ avahi-browse.1: avahi-browse.1.xml Makefile
+ 	xmltoman $< > $@
+ 
+@@ -230,13 +249,18 @@
+ 	xmltoman.xsl \
+ 	xmltoman.dtd
+ 
++if HAVE_BONJOUR
++EXTRA_DIST += \
++	avahi-daemon.1.xml.in
++endif
+ 
++
+ if HAVE_DBUS
+ 
+ install-exec-local:
+ 	mkdir -p $(DESTDIR)/$(mandir)/man1 && \
+ 		cd $(DESTDIR)/$(mandir)/man1 && \
+-		rm -f avahi-resolve-host-name.1 avahi-resolve-address.1 avahi-browse-domains.1 avahi-publish-address.1 avahi-publish-service.1 && \
++		rm -f avahi-resolve-host-name.1 avahi-resolve-address.1 avahi-browse-domains.1 avahi-publish-address.1 avahi-publish-service.1 bvnc.1 && \
+ 		$(LN_S) avahi-resolve.1 avahi-resolve-host-name.1 && \
+ 		$(LN_S) avahi-resolve.1 avahi-resolve-address.1 && \
+ 		$(LN_S) avahi-browse.1 avahi-browse-domains.1 && \
+--- /dev/null	2006-09-11 13:07:11.000000000 +0100
++++ avahi-0.6.13/man/avahi-daemon.1	2006-09-11 13:34:03.600015000 +0100
+@@ -0,0 +1,65 @@
++.TH avahi-daemon 1 User Manuals
++.SH NAME
++avahi-daemon \- The Avahi daemon
++.SH SYNOPSIS
++\fBavahi-daemon [\fIoptions\fB]
++
++avahi-daemon --kill\fB
++
++avahi-daemon --check\fB
++\f1
++.SH DESCRIPTION
++The Avahi daemon implements a DBUS interface which provides a rich object oriented interface to DBUS enabled applications which browse for or register for services.
++
++Instead of implementing Apple's ZeroConf architecture (also known as "Rendezvous" or "Bonjour") it makes calls to the DNS Service Discovery API provided by Bonjour and so functions as a Bonjour client.
++.SH OPTIONS
++.TP
++\fB-D | --daemonize\f1
++Daemonize after startup. Implies \fB--syslog\f1
++.TP
++\fB-s | --syslog\f1
++Log to syslog instead of STDERR. Implied by \fB--daemonize\f1
++.TP
++\fB--debug\f1
++Increase verbosity to debug level
++.TP
++\fB--no-drop-root\f1
++Don't drop root priviliges after startup and don't require daemon to be started as root. We recommend not to use this option.
++.TP
++\fB--no-chroot\f1
++Don't \fBchroot(2)\f1 the daemon. This option is only available when compiled with chroot() support.
++.TP
++\fB--no-proctitle\f1
++Don't change the process name while running. Unless this option is specified avahi will reflect it's current state and selected host name in the process title.
++.TP
++\fB-k | --kill\f1
++Kill an already running avahi-daemon. (equivalent to sending a SIGTERM)
++.TP
++\fB-r | --reload\f1
++Tell an already running avahi-daemon to reread the files from \fI/etc/avahi/services/\f1. (equivalent to sending a SIGHUP)
++.TP
++\fB-c | --check\f1
++Return 0 as return code when avahi-daemon is already running.
++.TP
++\fB-h | --help\f1
++Show help
++.TP
++\fB-v | --version\f1
++Show version information 
++.SH FILES
++\fI/etc/avahi/hosts\f1: additional static hostname mappings to publish in mDNS,
++see \fBavahi.hosts(5)\f1 for more information.
++
++\fI/etc/avahi/services/*.service\f1: static service definitions, see \fBavahi.service(5)\f1 for more information.
++.SH SIGNALS
++\fISIGINT, SIGTERM, SIGQUIT\f1: avahi-daemon will shutdown. This is issued by passing --kill to avahi-daemon.
++
++\fISIGHUP\f1: avahi-daemon will reload and static service definitions from \fI/etc/avahi/services/\f1.
++
++.SH AUTHORS
++The avahi developers <avahi (at) lists (dot) freedesktop (dot) org>; avahi is available from \fBhttp://avahi.org/\f1
++
++Making the Avahi Daemon proxy to the Bonjour daemon instead of implementing Bonjour has been written by Sun Microsystems Inc. to support applications which use the Avahi Client API when run on a system with Bonjour.
++.SH SEE ALSO
++.SH COMMENTS
++This man page was written using \fBxml2man(1)\f1 by Padraig O'Briain.
+--- /dev/null	2006-05-31 14:49:02.000000000 +0100
++++ avahi-0.6.10/man/avahi-daemon.1.xml.in	2006-05-31 15:04:18.204316000 +0100
+@@ -0,0 +1,126 @@
++<?xml version="1.0"?><!--*-nxml-*-->
++<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
++<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
++
++<!-- $Id: avahi-daemon.1.xml.in 1138 2006-02-14 22:13:30Z lennart $ -->
++
++<!-- 
++  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-daemon" section="1" desc="The Avahi daemon">
++
++	<synopsis>
++      <cmd>avahi-daemon [<arg>options</arg>]</cmd>
++      <cmd>avahi-daemon <opt>--kill</opt></cmd>
++      <cmd>avahi-daemon <opt>--check</opt></cmd>
++	</synopsis>
++	
++    <description>
++      <p>The Avahi daemon implements a DBUS interface which provides a 
++      rich object oriented interface to DBUS enabled applications which
++      browse for or register for services.</p>
++
++      <p>Instead of implementing Apple's ZeroConf architecture (also known as 
++      "Rendezvous" or "Bonjour") it makes calls to the DNS Service Discovery
++      API provided by Bonjour and so functions as a Bonjour client.</p>
++    </description>
++      
++	<options>
++
++	  <option>
++		<p><opt>-D | --daemonize</opt></p>
++		<optdesc><p>Daemonize after startup. Implies <opt>--syslog</opt></p></optdesc>
++	  </option>
++
++      <option>
++        <p><opt>-s | --syslog</opt></p>
++        <optdesc><p>Log to syslog instead of STDERR. Implied by <opt>--daemonize</opt></p></optdesc>
++      </option>
++
++      <option>
++        <p><opt>--debug</opt></p>
++        <optdesc><p>Increase verbosity to debug level</p></optdesc>
++      </option>
++
++      <option>
++        <p><opt>--no-drop-root</opt></p>
++        <optdesc><p>Don't drop root priviliges after startup and don't require daemon to be started as root. We recommend not to use this option.</p></optdesc>
++      </option>
++
++      <option>
++        <p><opt>--no-chroot</opt></p>
++        <optdesc><p>Don't <manref section="2" name="chroot"/> the daemon. This option is only available when compiled with chroot() support.</p></optdesc>
++      </option>
++
++      <option>
++        <p><opt>--no-proctitle</opt></p>
++        <optdesc><p>Don't change the process name while
++        running. Unless this option is specified avahi will reflect
++        it's current state and selected host name in the process
++        title.</p></optdesc>
++      </option>
++
++	  <option>
++		<p><opt>-k | --kill</opt></p>
++		<optdesc><p>Kill an already running avahi-daemon. (equivalent to sending a SIGTERM)</p></optdesc>
++	  </option>
++
++	  <option>
++		<p><opt>-c | --check</opt></p>
++		<optdesc><p>Return 0 as return code when avahi-daemon is already running.</p></optdesc>
++	  </option>
++
++	  <option>
++		<p><opt>-h | --help</opt></p>
++		<optdesc><p>Show help</p></optdesc>
++	  </option>
++
++	  <option>
++		<p><opt>-v | --version</opt></p>
++		<optdesc><p>Show version information </p></optdesc>
++	  </option>
++
++	</options>
++
++    <section name="Files">
++      
++    </section>
++
++    <section name="Signals">
++      <p><arg>SIGINT, SIGTERM, SIGQUIT</arg>: avahi-daemon will shutdown. This is issued by passing --kill to avahi-daemon.</p>
++    </section>
++
++	<section name="Authors">
++	  <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
++	  available from <url href="@PACKAGE_URL@"/></p>
++          <p> Making the Avahi Daemon proxy to the Bonjour daemon instead of
++          implementing Bonjour has been written by Sun Microsystems Inc. to
++          support applications which use the Avahi Client API when run on a
++          system with Bonjour.</p>
++	</section>
++	
++	<section name="See also">
++	</section>
++	
++	<section name="Comments">
++	  <p>This man page was written using <manref name="xml2man" section="1"
++		  href="http://masqmail.cx/xml2man/"/> by Padraig O'Briain.</p>
++	</section>
++	
++  </manpage>