Bug 44798 - Mismatch beetween online documentation and configure --help
Summary: Mismatch beetween online documentation and configure --help
Status: RESOLVED FIXED
Alias: None
Product: Apache httpd-2
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 2.2.8
Hardware: All All
: P2 normal (vote)
Target Milestone: ---
Assignee: HTTP Server Documentation List
URL:
Keywords: PatchAvailable
Depends on:
Blocks:
 
Reported: 2008-04-10 07:38 UTC by Hendrik Schmieder
Modified: 2011-10-10 11:42 UTC (History)
1 user (show)



Attachments
Patch to fix autoconf macro APACHE_MODULE (1.90 KB, patch)
2010-01-26 10:13 UTC, Tobias Schmidt
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Hendrik Schmieder 2008-04-10 07:38:08 UTC
According to configure --help there's an option '--enable-http', but
according to the online documentation there's no '--enable-http', but a
'--disable-http'.

What is correct ?
Comment 1 Tobias Schmidt 2010-01-26 10:13:15 UTC
Created attachment 24894 [details]
Patch to fix autoconf macro APACHE_MODULE

The online documentation is correct. There is a problem in the Autoconf configuration, which leads to the wrong option name. The patch will fix this.

explanation:
mod_http requires to be a static module (see modules/http/config2.m4 line 7). Therefore the module default setting is 'static' instead of the normal 'yes' (see modules/http/config2.m4 line 17). The Autoconf macro APACHE_MODULE displays only for modules with default of 'yes' the correct label "--disable-<module>". Modules with other default values than 'yes' are labeled with "--enable-<module>" which is obviously wrong for the 'static' value.
Comment 2 Rich Bowen 2010-10-29 11:06:40 UTC
Moving docs bugs to docs@httpd.a.o ownership.
Comment 3 Rich Bowen 2011-10-10 11:42:57 UTC
The section listing all enabled/disabled modules has been removed from the trunk docs, and instead directs the reader to run configure --help for the enabled list effective in the particular version being run. This will eliminate this kind of confusion, as well as compensating for per-version fluctuations in this list.

So, to clarify, --help is always the correct one.