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.