Bug 7929 - groupdb:backend is undocumented
groupdb:backend is undocumented
Status: NEW
Product: Samba 3.5
Classification: Unclassified
Component: Docs
Other All
: P3 normal
: ---
Assigned To: John H Terpstra
Samba Documentation QA Contact~
Depends on:
  Show dependency treegraph
Reported: 2011-01-21 09:45 UTC by Björn Jacke
Modified: 2011-10-10 08:13 UTC (History)
0 users

See Also:


Note You need to log in before you can comment on or make changes to this bug.
Description Björn Jacke 2011-01-21 09:45:03 UTC
groupdb:backend = tdb can be used to use tdb for groupmaping database.

All new options should be documented so that our users have a change to know that they exist and how to use them.
Comment 1 Karolin Seeger 2011-10-08 18:39:34 UTC
Usually, parametric options are not documented in the manpage (there are exceptions, I know ;-).
I guess these are "hidden" options for special tuning.
So why is it a parametric option?
Comment 2 Björn Jacke 2011-10-10 08:13:36 UTC
let me correc this: parametric options have often been undocumented in the past, mainly because writing documentation is thankless work. But all parameters should be documented because every parameter has been introduced for some reason, to fix something or whatever. If the problem or that "whatever" isn't documented our users are not able to use it and thus they are not able to solve their configuration problems. This is why we need to consider missing documentation to be a bug. In case the option is "dangerous" or "discouraged to use" then this can be written in the documentation, too.