Issue 691 - Admin Guide configuration example confusion
Summary: Admin Guide configuration example confusion
Status: VERIFIED FIXED
Alias: None
Product: OpenLDAP
Classification: Unclassified
Component: documentation (show other issues)
Version: unspecified
Hardware: All All
: --- normal
Target Milestone: ---
Assignee: OpenLDAP project
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2000-08-29 17:26 UTC by cedric@earthling.net
Modified: 2000-09-01 11:57 UTC (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this issue.
Description Kurt Zeilenga 2000-08-29 15:04:41 UTC
moved from Incoming to Documentation
Comment 1 cedric@earthling.net 2000-08-29 17:26:47 UTC
Full_Name: Cedric Tefft
Version: CVS
OS: N/A
URL: ftp://ftp.openldap.org/incoming/
Submission from: (NULL) (205.138.230.84)


Yesterday's CVS version of the Admin Guide has a somewhat confusing example in
section 4.2: "Running configure" just after table 4.1: "Environment Variables". 
The verbage describing the example invocation of the configure script talks
about configuring the LDBM backend and the shell backend, but the shell backend
is not mentioned anywhere else in the example.  It is not clear how shell
support is being enabled.  If it is enabled by default this should be explicitly
stated so as not to confuse the reader.

Additionally, the given example enables a backend described as the "DNS-SRV"
backend which isn't mentioned anywhere else in the guide.

Comment 2 Kurt Zeilenga 2000-08-29 21:23:52 UTC
I concur.  The mention of other backend databases should be removed
and another flag, such as --disable-crypt, be used in the example.

At 05:26 PM 8/29/00 +0000, cedric@earthling.net wrote:
>Full_Name: Cedric Tefft
>Version: CVS
>OS: N/A
>URL: ftp://ftp.openldap.org/incoming/
>Submission from: (NULL) (205.138.230.84)
>
>
>Yesterday's CVS version of the Admin Guide has a somewhat confusing example in
>section 4.2: "Running configure" just after table 4.1: "Environment Variables". 
>The verbage describing the example invocation of the configure script talks
>about configuring the LDBM backend and the shell backend, but the shell backend
>is not mentioned anywhere else in the example.  It is not clear how shell
>support is being enabled.  If it is enabled by default this should be explicitly
>stated so as not to confuse the reader.
>
>Additionally, the given example enables a backend described as the "DNS-SRV"
>backend which isn't mentioned anywhere else in the guide.

Comment 3 Kurt Zeilenga 2000-09-01 11:57:58 UTC
changed state Open to Closed