Henrique de Moraes Holschuh wrote: > > The OP already has exactly what you want. It was argued we need to be careful > > throwing all too many configurables at the consumer, for which there is > > currently only a single mechanism in place. *That's* what I'm trying to work > > with here. > > Our demographics are sysadmins. IMO, we should just organize the > documentation properly to let them know what options are best left alone, > but document them througoutly. Cluster all such options (e.g. under a new > "advanced options" manpage section, and people will just skip over them > unless they need them. >
And so the question becomes; How do you propose we do that, given the manpages are generated from lib/imapoptions by tools/config2man? I suppose one way to get extraordinarily awesome man pages is to not generate the manpages any longer, but instead write them by hand. -- Jeroen van Meeuwen Senior Engineer, Kolab Systems AG e: [email protected] t: +316 42 801 403 w: http://www.kolabsys.com pgp: 9342 BF08
