cups-filters/cups-filters-man.patch
2013-07-01 14:17:35 +02:00

180 lines
5.8 KiB
Diff

diff -up cups-filters-1.0.35/Makefile.am.man cups-filters-1.0.35/Makefile.am
--- cups-filters-1.0.35/Makefile.am.man 2013-05-15 20:46:22.000000000 +0200
+++ cups-filters-1.0.35/Makefile.am 2013-07-01 14:03:58.395572035 +0200
@@ -618,7 +618,6 @@ EXTRA_DIST += \
# UTILS
# =====
-EXTRA_DIST += utils/cups-browsed.in
sbin_PROGRAMS = \
cups-browsed
cups_browsed_SOURCES = \
@@ -636,6 +635,11 @@ cups_browsed_LDADD = \
$(GLIB_LIBS)
initrcdir = $(INITDDIR)
initrc_SCRIPTS = utils/cups-browsed
+man_MANS = \
+ utils/cups-browsed.8 \
+ utils/cups-browsed.conf.5
+EXTRA_DIST += utils/cups-browsed.in \
+ $(man_MANS)
# ===
# PPD
diff -up cups-filters-1.0.35/utils/cups-browsed.8.man cups-filters-1.0.35/utils/cups-browsed.8
--- cups-filters-1.0.35/utils/cups-browsed.8.man 2013-07-01 14:03:58.404571910 +0200
+++ cups-filters-1.0.35/utils/cups-browsed.8 2013-07-01 14:03:58.404571910 +0200
@@ -0,0 +1,56 @@
+.\"Text automatically generated by txt2man
+.TH cups-browsed 8 "29 June 2013" "" ""
+.SH NAME
+\fBcups-browsed \fP- A daemon for browsing the Bonjour broadcasts of shared, remote CUPS printers
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBcups-browsed\fP [\fB-v\fP | \fB-d\fP | \fB--debug\fP]
+
+.fam T
+.fi
+.fam T
+.fi
+.SH DESCRIPTION
+\fBcups-browsed\fP has three independently switchable functions:
+.IP 1. 4
+Browse Bonjour broadcasts of remote printers and create/remove local
+raw queues pointing to these printers.
+.IP 2. 4
+Browse CUPS broadcasts of remote printers and create/remove local raw
+queues pointing to these printers.
+.IP 3. 4
+Broadcast local queues with the CUPS protocol.
+.SH OPTIONS
+.TP
+.B
+\fB-v\fP, \fB-d\fP, \fB--debug\fP
+Debug mode
+.SH FILES
+/etc/cups/cups-browsed.conf
+.SH NOTES
+Please take references to cups 1.6.x to include newer versions.
+Similarily, cups 1.5.x is intended to encompass older versions too.
+.PP
+In environments with only cups 1.6.x servers and clients (plus
+\fBcups-browsed\fP on either server or client or both) the function described in 1.
+enables the automatic discovery of remote queues and their display in
+printing dialogues of applications and with command line tools.
+.PP
+The facility provided by 3. means that servers running cups 1.6.x plus
+\fBcups-browsed\fP can broadcast their local queues so that clients with cups
+1.5.x get these queues automatically available. The outcome of 2. is
+that clients running cups 1.6.x plus \fBcups-browsed\fP can use the CUPS
+broadcasts from servers with cups 1.5.x. As with browsing of Bonjour
+broadcasts, the created local raw queues are available to applications
+and command line tools.
+.SH SEE ALSO
+
+\fBcups-browsed.conf\fP(5)
+.PP
+/usr/share/doc/\fBcups-filters\fP/README
+.SH AUTHOR
+The authors of \fBcups-browsed\fP are listed in /usr/share/doc/\fBcups-filters\fP/AUTHORS.
+.PP
+This manual page was written for the Debian Project, but it may be used by others.
diff -up cups-filters-1.0.35/utils/cups-browsed.conf.5.man cups-filters-1.0.35/utils/cups-browsed.conf.5
--- cups-filters-1.0.35/utils/cups-browsed.conf.5.man 2013-07-01 14:03:58.404571910 +0200
+++ cups-filters-1.0.35/utils/cups-browsed.conf.5 2013-07-01 14:03:58.404571910 +0200
@@ -0,0 +1,92 @@
+.\"Text automatically generated by txt2man
+.TH cups-browsed.conf 5 "29 June 2013" "" ""
+.SH NAME
+\fBcups-browsed.conf \fP- server configuration file for cups-browsed
+\fB
+.SH DESCRIPTION
+The cups-browsed.conf file configures the cups-browsed daemon. It is normally
+located in the /etc/cups directory. Each line in the file can be a
+configuration directive, a blank line, or a comment. Comment lines start
+with the # character.
+.SH DIRECTIVES
+
+The BrowseAllow directive specifies a system or network to accept
+CUPS browse packets from. The default is to accept browse packets from
+all hosts when BrowseRemoteProtocols uses the CUPS protocol.
+.PP
+.nf
+.fam C
+ BrowseAllow 192.168.7.20
+ BrowseAllow 192.168.7.0/24
+ BrowseAllow 192.168.7.0/255.255.255.0
+
+
+.fam T
+.fi
+The BrowsePoll directive polls a server for available printers once
+every 60 seconds. Multiple BrowsePoll directives can be specified
+to poll multiple servers. The default port to connect to is 631.
+BrowsePoll works independently of whether CUPS browsing is activated
+in BrowseRemoteProtocols.
+.PP
+.nf
+.fam C
+ BrowsePoll 192.168.7.20
+ BrowsePoll 192.168.7.65:631
+ BrowsePoll host.example.com:631
+
+
+.fam T
+.fi
+The BrowseLocalProtocols directive specifies the protocols to use
+when advertising local shared printers on the network. The default
+is "none". Control of advertising of local shared printers using
+dnssd is done in /etc/cups/cupsd.conf.
+.PP
+.nf
+.fam C
+ BrowseLocalProtocols none
+ BrowseLocalProtocols CUPS
+
+
+.fam T
+.fi
+The BrowseRemoteProtocols directive specifies the protocols to use
+when finding remote shared printers on the network. Multiple
+protocols can be specified by separating them with spaces.
+The default is "dnssd cups".
+.PP
+.nf
+.fam C
+ BrowseRemoteProtocols none
+ BrowseRemoteProtocols CUPS dnssd
+ BrowseRemoteProtocols CUPS
+ BrowseRemoteProtocols dnssd
+
+.fam T
+.fi
+The BrowseProtocols directive specifies the protocols to use when
+finding remote shared printers on the network and advertising local
+shared printers. "dnssd" is ignored for BrowseLocalProtocols. Multiple
+protocols can be specified by separating them with spaces. The
+default is "none" for BrowseLocalProtocols and "dnssd cups" for
+BrowseRemoteProtocols.
+.PP
+.nf
+.fam C
+ BrowseProtocols none
+ BrowseProtocols CUPS dnssd
+ BrowseProtocols CUPS
+ BrowseProtocols dnssd
+
+.fam T
+.fi
+.SH SEE ALSO
+
+\fBcups-browsed\fP(8)
+.PP
+/usr/share/doc/cups-filters/README
+.SH AUTHOR
+The authors of cups-browsed are listed in /usr/share/doc/cups-filters/AUTHORS.
+.PP
+This manual page was written for the Debian Project, but it may be used by others.