[Pkg-cups-devel] Bug#612285: cups: Clarify relationship between BrowseProtocols and BrowseLocalProtocols, BrowseRemoteProtocols documentation

[Brian Potkin]

tags 612285 + upstream
thanks



On Mon 07 Feb 2011 at 12:32:30 +0000, Sam Morris wrote:

> The documentation says:
> 
>   The BrowseProtocols directive specifies the protocols to use when
>   showing and advertising shared printers on the local network.
> 
>   The BrowseRemoteProtocols directive specifies the protocols to use
>   when finding remote shared printers on the network.
> 
>   The BrowseLocalProtocols directive specifies the protocols to use
>   when advertising local shared printers on the network.
> 
> It does not say whether BrowseProtocols overrides the other two, or
> vice-versa.

Can we assume configuration files are always read from the beginning
and a value for an option later in the file is the one which prevails?
In which case the answer is - "it depends". What follows is from a
discussion at

 http://www.cups.org/newsgroups.php?s1+gcups.general+v1+T+Q%22Several+questions%22

   >> BrowseProtocols sets both the local and remote protocols.
   >> BrowseLocalProtocols and BrowseRemoveProtocols set the corresponding
   >> ones only.
   > Which means BrowseLocalProtocols and BrowseRemoteProtocols are ignored
   > if BrowseProtocols is set ?

   Not exactly.  The current implementation uses the last value in the
   cupsd.conf file, so:

       BrowseProtocols foo
       BrowseLocalProtocols bar

   will set BrowseLocalProtocols to "bar" and BrowseRemoteProtocols
   (implicitly) to "foo".  However, if you do the lines in a different
   order:

       BrowseLocalProtocols bar
       BrowseProtocols foo

   then both BrowseLocalProtocols and BrowseRemoteProtocols will be "foo".