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