Bug#402814: cyrus-imapd-2.2: Inadequate documentation of 'sasl_minimum_layer'

[Henrique de Moraes Holschuh]

On Wed, 13 Dec 2006, Michael Richters wrote:
> On Wed, Dec 13, 2006 at 12:01:11PM -0200, Henrique de Moraes Holschuh wrote:
> > On Tue, 12 Dec 2006, Michael Richters wrote:
> > > The manpage for imapd.conf is missing many things, including a description
> > > of the possible values for 'sasl_minimum_layer'.  I have spent hours searching,
> > > and cannot find any translation of these arbitrary values to real-world meanings,
> > > nor can I even find a list of allowed values for this option.  It sure would be
> > > nice if somebody would share their knowledge...
> > 
> > All sasl_* are passed as-is to SASL for processing, so we cannot do much
> > more than:
> > 
> > 1. Say exactly that in the cyrus imap manpage and docs and point to the
> > relevant sasl manpages and docs
> > 
> > 2. Write the relevant SASL manpages and send it upstream, AFAIK all the docs
> > on that stuff are in a single html file in the sasl documentation.
> > 
> > It is definately NOT the job of cyrus imapd to documet any sasl_ stuff in
> > manpages.
> 
> Why should the manpage for imapd.conf not document all of the options
> that can appear in /etc/imapd.conf?  At the very least, it should

SASL can change it at will, therefore SASL needs to document them. We just
add a pointer to SASL, as I said (see (1) above).

> tell me where to find this sasl documentation?  I have spent many

/usr/share/doc/libsasl2/ somewhere, grep for "options".  I didn't check the
new SASL, though.

-- 
  "One disk to rule them all, One disk to find them. One disk to bring
  them all and in the darkness grind them. In the Land of Redmond
  where the shadows lie." -- The Silicon Valley Tarot
  Henrique Holschuh