libreoffice: update to 24.8.4.2
[oi-userland.git] / components / network / avahi / patches / 08-man-page.patch
blob480cdf3ba08d2eea5c5dfd0b3464d2d2d7395bf4
1 --- /dev/null 2007-06-13 17:00:01.000000000 +0100
2 +++ avahi-0.6.19/man/avahi-daemon-bridge-dsd.1 2007-06-13 17:07:14.447743000 +0100
3 @@ -0,0 +1,61 @@
4 +.TH avahi-daemon-bridge-dsd 1 User Manuals
5 +.SH NAME
6 +avahi-daemon-bridge-dsd \- The Avahi daemon bridge to dsd
7 +.SH SYNOPSIS
8 +\fBavahi-daemon-bridge-dsd [\fIoptions\fB]
10 +avahi-daemon-bridge-dsd --kill\fB
12 +avahi-daemon-bridge-dsd --check\fB
13 +\f1
14 +.SH DESCRIPTION
15 +The daemon implements a DBUS interface which provides a rich object oriented interface to DBUS enabled applications which browse for or register for services.
17 +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.
18 +.SH OPTIONS
19 +.TP
20 +\fB-D | --daemonize\f1
21 +Daemonize after startup. Implies \fB--syslog\f1
22 +.TP
23 +\fB-s | --syslog\f1
24 +Log to syslog instead of STDERR. Implied by \fB--daemonize\f1
25 +.TP
26 +\fB--debug\f1
27 +Increase verbosity to debug level
28 +.TP
29 +\fB--no-drop-root\f1
30 +Don't drop root priviliges after startup and don't require daemon to be started as root. We recommend not to use this option.
31 +.TP
32 +\fB--no-chroot\f1
33 +Don't \fBchroot(2)\f1 the daemon. This option is only available when compiled with chroot() support.
34 +.TP
35 +\fB--no-proctitle\f1
36 +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.
37 +.TP
38 +\fB-k | --kill\f1
39 +Kill an already running avahi-daemon-bridge-dsd. (equivalent to sending a SIGTERM)
40 +.TP
41 +\fB-r | --reload\f1
42 +Tell an already running avahi-daemon-bridge-dsd to reread the files from \fI/etc/avahi/services/\f1. (equivalent to sending a SIGHUP)
43 +.TP
44 +\fB-c | --check\f1
45 +Return 0 as return code when avahi-daemon-bridge-dsd is already running.
46 +.TP
47 +\fB-h | --help\f1
48 +Show help
49 +.TP
50 +\fB-v | --version\f1
51 +Show version information
52 +.SH FILES
53 +\fI/etc/avahi/hosts\f1: additional static hostname mappings to publish in mDNS,
54 +see \fBavahi.hosts(5)\f1 for more information.
56 +\fI/etc/avahi/services/*.service\f1: static service definitions, see \fBavahi.service(5)\f1 for more information.
57 +.SH SIGNALS
58 +\fISIGINT, SIGTERM, SIGQUIT\f1: avahi-daemon will shutdown. This is issued by passing --kill to avahi-daemon.
60 +\fISIGHUP\f1: avahi-daemon-bridge-dsd will reload and static service definitions from \fI/etc/avahi/services/\f1.
62 +.SH SEE ALSO
63 +.SH COMMENTS
64 +This man page was written using \fBxml2man(1)\f1 by Padraig O'Briain.
65 --- /dev/null 2007-06-13 17:00:01.000000000 +0100
66 +++ avahi-0.6.19/man/avahi-daemon-bridge-dsd.1.xml.in 2007-06-13 17:07:33.097758000 +0100
67 @@ -0,0 +1,117 @@
68 +<?xml version="1.0"?><!--*-nxml-*-->
69 +<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
70 +<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
72 +<!-- $Id: avahi-daemon.1.xml.in 1138 2006-02-14 22:13:30Z lennart $ -->
74 +<!--
75 + This file is part of avahi.
77 + avahi is free software; you can redistribute it and/or modify it
78 + under the terms of the GNU Lesser General Public License as
79 + published by the Free Software Foundation; either version 2.1 of the
80 + License, or (at your option) any later version.
82 + avahi is distributed in the hope that it will be useful, but WITHOUT
83 + ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
84 + or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
85 + Public License for more details.
87 + You should have received a copy of the GNU Lesser General Public
88 + License along with avahi; if not, write to the Free Software
89 + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
90 + USA.
91 +-->
93 + <manpage name="avahi-daemon-bridge-dsd" section="1" desc="The Avahi daemon">
95 + <synopsis>
96 + <cmd>avahi-daemon [<arg>options</arg>]</cmd>
97 + <cmd>avahi-daemon <opt>--kill</opt></cmd>
98 + <cmd>avahi-daemon <opt>--check</opt></cmd>
99 + </synopsis>
101 + <description>
102 + <p>The daemon implements a DBUS interface which provides a
103 + rich object oriented interface to DBUS enabled applications which
104 + browse for or register for services.</p>
106 + <p>Instead of implementing Apple's ZeroConf architecture (also known as
107 + "Rendezvous" or "Bonjour") it makes calls to the DNS Service Discovery
108 + API provided by Bonjour and so functions as a Bonjour client.</p>
109 + </description>
111 + <options>
113 + <option>
114 + <p><opt>-D | --daemonize</opt></p>
115 + <optdesc><p>Daemonize after startup. Implies <opt>--syslog</opt></p></optdesc>
116 + </option>
118 + <option>
119 + <p><opt>-s | --syslog</opt></p>
120 + <optdesc><p>Log to syslog instead of STDERR. Implied by <opt>--daemonize</opt></p></optdesc>
121 + </option>
123 + <option>
124 + <p><opt>--debug</opt></p>
125 + <optdesc><p>Increase verbosity to debug level</p></optdesc>
126 + </option>
128 + <option>
129 + <p><opt>--no-drop-root</opt></p>
130 + <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>
131 + </option>
133 + <option>
134 + <p><opt>--no-chroot</opt></p>
135 + <optdesc><p>Don't <manref section="2" name="chroot"/> the daemon. This option is only available when compiled with chroot() support.</p></optdesc>
136 + </option>
138 + <option>
139 + <p><opt>--no-proctitle</opt></p>
140 + <optdesc><p>Don't change the process name while
141 + running. Unless this option is specified avahi will reflect
142 + it's current state and selected host name in the process
143 + title.</p></optdesc>
144 + </option>
146 + <option>
147 + <p><opt>-k | --kill</opt></p>
148 + <optdesc><p>Kill an already running avahi-daemon-bridge-dsd. (equivalent to sending a SIGTERM)</p></optdesc>
149 + </option>
151 + <option>
152 + <p><opt>-c | --check</opt></p>
153 + <optdesc><p>Return 0 as return code when avahi-daemon-bridge-dsd is already running.</p></optdesc>
154 + </option>
156 + <option>
157 + <p><opt>-h | --help</opt></p>
158 + <optdesc><p>Show help</p></optdesc>
159 + </option>
161 + <option>
162 + <p><opt>-v | --version</opt></p>
163 + <optdesc><p>Show version information </p></optdesc>
164 + </option>
166 + </options>
168 + <section name="Files">
170 + </section>
172 + <section name="Signals">
173 + <p><arg>SIGINT, SIGTERM, SIGQUIT</arg>: avahi-daemon-bridge-dsd will shutdown. This is issued by passing --kill to avahi-daemon-bridge-dsd.</p>
174 + </section>
176 + <section name="See also">
177 + </section>
179 + <section name="Comments">
180 + <p>This man page was written using <manref name="xml2man" section="1"
181 + href="http://masqmail.cx/xml2man/"/> by Padraig O'Briain.</p>
182 + </section>
184 + </manpage>
185 --- /usr/tmp/clean/avahi-0.6.19/man/avahi-browse.1 Wed May 9 15:45:42 2007
186 +++ avahi-0.6.19/man/avahi-browse.1 Wed Jun 13 16:08:06 2007
187 @@ -13,7 +13,7 @@
188 avahi-browse-domains [\fIoptions\fB]
190 .SH DESCRIPTION
191 -Browse for mDNS/DNS-SD network services and browsing domains using the Avahi daemon.
192 +Browse for mDNS/DNS-SD network services and browsing domains using the Avahi daemon. The daemon is not the standard Avahi daemon but a proxy to a Bonjour daemon.
193 .SH OPTIONS
194 Specify a DNS-SD service type (e.g. _http._tcp) to browse for on the command line, or \fB-a\f1 to browse for all available service types. Items that appear on the network are prefixed with "+", items that disappear are prefixed with "-". If \fB--resolve\f1 is passed items that are resolved are prefixed with "=".
196 @@ -55,9 +55,7 @@
198 \fB-V | --version\f1
199 Show version information.
200 -.SH AUTHORS
201 -The Avahi Developers <avahi (at) lists (dot) freedesktop (dot) org>; Avahi is available from \fBhttp://avahi.org/\f1
202 .SH SEE ALSO
203 -\fBavahi-publish(1)\f1, \fBavahi-resolve(1)\f1, \fBavahi-daemon(8)\f1
204 +\fBavahi-publish(1)\f1, \fBavahi-resolve(1)\f1
205 .SH COMMENTS
206 This man page was written using \fBxml2man(1)\f1 by Oliver Kurth.
207 --- /usr/tmp/clean/avahi-0.6.19/man/avahi-discover.1 Wed May 9 15:45:43 2007
208 +++ avahi-0.6.19/man/avahi-discover.1 Wed Jun 13 15:42:13 2007
209 @@ -5,12 +5,10 @@
210 \fBavahi-discover
212 .SH DESCRIPTION
213 -Show a real-time graphical browse list for mDNS/DNS-SD network services running on the local LAN using the Avahi daemon.
214 +Show a real-time graphical browse list for mDNS/DNS-SD network services running on the local LAN using the Avahi daemon. The daemon is not the standard Avahi daemon but a proxy to a Bonjour daemon.
215 .SH OPTIONS
216 avahi-discover takes no command line arguments at the moment.
217 -.SH AUTHORS
218 -The Avahi Developers <avahi (at) lists (dot) freedesktop (dot) org>; Avahi is available from \fBhttp://avahi.org/\f1
219 .SH SEE ALSO
220 -\fBavahi-daemon(8)\f1, \fBavahi-browse(1)\f1
221 +\fBavahi-browse(1)\f1
222 .SH COMMENTS
223 This man page was written using \fBxml2man(1)\f1 by Oliver Kurth.
224 --- /usr/tmp/clean/avahi-0.6.19/man/avahi-publish.1 Wed May 9 15:45:43 2007
225 +++ avahi-0.6.19/man/avahi-publish.1 Wed Jun 13 15:44:27 2007
226 @@ -11,7 +11,7 @@
227 avahi-publish-address [\fIoptions\fB] \fIhost name\fB \fIaddress\fB
229 .SH DESCRIPTION
230 -Register an mDNS/DNS-SD service or host name/address mapping using the Avahi daemon.
231 +Register an mDNS/DNS-SD service or host name/address mapping using the Avahi daemon. The daemon is not the standard Avahi daemon but a proxy to a Bonjour daemon.
232 .SH OPTIONS
233 When calling in service registration mode, specify a DNS-SD service name (e.g. "Lennart's Files"), a service type (e.g. _http._tcp) and an IP port number for the service, optionally followed by any number of TXT record strings on the command line. When calling in address/host name registration mode specify a fully qualified host name and an address (IPv4 or IPv6).
235 @@ -41,9 +41,7 @@
237 \fB-V | --version\f1
238 Show version information.
239 -.SH AUTHORS
240 -The Avahi Developers <avahi (at) lists (dot) freedesktop (dot) org>; Avahi is available from \fBhttp://avahi.org/\f1
241 .SH SEE ALSO
242 -\fBavahi-resolve(1)\f1, \fBavahi-browse(1)\f1, \fBavahi-daemon(8)\f1
243 +\fBavahi-resolve(1)\f1, \fBavahi-browse(1)\f1
244 .SH COMMENTS
245 This man page was written using \fBxml2man(1)\f1 by Oliver Kurth.
246 --- /usr/tmp/clean/avahi-0.6.22/man/avahi-resolve.1 Mon Dec 17 15:40:46 2007
247 +++ avahi-0.6.22/man/avahi-resolve.1 Tue Dec 18 08:38:39 2007
248 @@ -11,7 +11,7 @@
249 avahi-resolve-address \fIaddress ...\fB
251 .SH DESCRIPTION
252 -Resolve one or more mDNS/DNS host name(s) to IP address(es) (and vice versa) using the Avahi daemon.
253 +Resolve one or more mDNS/DNS host name(s) to IP address(es) (and vice versa) using the Avahi daemon. The daemon is not the standard Avahi daemon but a proxy to a Bonjour daemon.
254 .SH OPTIONS
255 When passing -n, specify one or more fully qualified mDNS/DNS host name(s) (e.g. "foo.local") to resolve into IP addresses on the command line. When passing -a, specify one or more IP address to resolve into host names.
257 @@ -39,9 +39,7 @@
259 \fB-V | --version\f1
260 Show version information.
261 -.SH AUTHORS
262 -The Avahi Developers <avahi (at) lists (dot) freedesktop (dot) org>; Avahi is available from \fBhttp://avahi.org/\f1
263 .SH SEE ALSO
264 -\fBavahi-publish-address(1)\f1, \fBavahi-daemon(8)\f1
265 +\fBavahi-publish-address(1)\f1
266 .SH COMMENTS
267 This man page was written using \fBxml2man(1)\f1 by Oliver Kurth.
268 --- /usr/tmp/clean/avahi-0.6.22/man/avahi-set-host-name.1 Mon Dec 17 15:40:46 2007
269 +++ avahi-0.6.22/man/avahi-set-host-name.1 Tue Dec 18 08:39:22 2007
270 @@ -5,7 +5,7 @@
271 \fBavahi-set-host-name \fIhost-name\fB
273 .SH DESCRIPTION
274 -Set the mDNS host name of a currently running Avahi daemon. The effect of this operation is not persistent across daemon restarts. This operation is usually privileged.
275 +Set the mDNS host name of a currently running Avahi daemon. The effect of this operation is not persistent across daemon restarts. This operation is usually privileged. The daemon is not the standard Avahi daemon but a proxy to a Bonjour daemon.
276 .SH OPTIONS
278 \fB-v | --verbose\f1
279 @@ -16,9 +16,5 @@
281 \fB-V | --version\f1
282 Show version information.
283 -.SH AUTHORS
284 -The Avahi Developers <avahi (at) lists (dot) freedesktop (dot) org>; Avahi is available from \fBhttp://avahi.org/\f1
285 -.SH SEE ALSO
286 -\fBavahi-daemon(8)\f1
287 .SH COMMENTS
288 This man page was written using \fBxml2man(1)\f1 by Oliver Kurth.
289 --- /usr/tmp/clean/avahi-0.6.23/man/bssh.1 2008-06-24 00:29:07.000000000 +0100
290 +++ avahi-0.6.23/man/bssh.1 2008-06-25 13:56:28.037867000 +0100
291 @@ -28,8 +28,6 @@
293 \fB-h | --help\f1
294 Show help.
295 -.SH AUTHORS
296 -The Avahi Developers <avahi (at) lists (dot) freedesktop (dot) org>; Avahi is available from \fBhttp://avahi.org/\f1
297 .SH SEE ALSO
298 \fBavahi-browse(1)\f1, \fBssh(1)\f1, \fBvncviewer(1)\f1
299 .SH COMMENTS
300 --- /usr/tmp/clean/avahi-0.6.28/man/Makefile.am 2010-08-26 01:51:39.039153001 +0100
301 +++ avahi-0.6.28/man/Makefile.am 2011-01-20 14:48:39.364580063 +0000
302 @@ -45,6 +45,11 @@
303 avahi-autoipd.action.8.xml \
304 bssh.1.xml
306 +if HAVE_BONJOUR
307 +noinst_DATA += \
308 + avahi-daemon-bridge-dsd.1.xml
309 +endif
311 CLEANFILES = \
312 $(noinst_DATA)
314 @@ -81,6 +86,15 @@
315 endif
316 endif
318 +if HAVE_BONJOUR
319 +man_MANS += \
320 + avahi-daemon-bridge-dsd.1
322 +avahi-daemon-bridge-dsd.1.xml: avahi-daemon-bridge-dsd.1.xml.in Makefile
323 + sed -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \
324 + -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@
325 +endif
327 %.xml: %.xml.in Makefile
328 $(AM_V_GEN) sed -e 's,@pkgsysconfdir\@,$(pkgsysconfdir),g' \
329 -e 's,@servicedir\@,$(servicedir),g' \
330 @@ -130,6 +144,10 @@
331 xmltoman.xsl \
332 xmltoman.dtd
334 +if HAVE_BONJOUR
335 +EXTRA_DIST += \
336 + avahi-daemon-bridge-dsd.1.xml.in
337 +endif
339 if HAVE_DBUS