Bug 145737
Summary: | httpd-manual package is missing | ||
---|---|---|---|
Product: | Red Hat Enterprise Linux 3 | Reporter: | Andrei Ivanov <iva> |
Component: | httpd | Assignee: | Joe Orton <jorton> |
Status: | CLOSED WONTFIX | QA Contact: | |
Severity: | medium | Docs Contact: | |
Priority: | medium | ||
Version: | 3.0 | ||
Target Milestone: | --- | ||
Target Release: | --- | ||
Hardware: | i386 | ||
OS: | Linux | ||
Whiteboard: | |||
Fixed In Version: | Doc Type: | Bug Fix | |
Doc Text: | Story Points: | --- | |
Clone Of: | Environment: | ||
Last Closed: | 2005-01-21 11:46:31 UTC | Type: | --- |
Regression: | --- | Mount Type: | --- |
Documentation: | --- | CRM: | |
Verified Versions: | Category: | --- | |
oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
Cloudforms Team: | --- | Target Upstream Version: | |
Embargoed: |
Description
Andrei Ivanov
2005-01-20 23:24:45 UTC
Thanks for contacting us. From RHEL3 onwards, the httpd manual is no longer redistributed in packaged form. The Apache website has an always-up-to-date copy of the 2.0 documentation: http://httpd.apache.org/docs-2.0/ Is there some logical explanation why that was decided so? The .src.rpm still contains all the manuals, and you're just avoiding the -manual subpackage. User should have local access to documentation, corresponding to the version of software installed on his system, not necessarily to the latest vesrion of the manual on the web (which may be inaccessible for some reason(s)). Sure, it's trade-off: - PRO: always accessible local copy - CON: local copy isn't usable anyway if local httpd isn't running due to use of typemap files for .html - CON: size (ever-increasing as more translations are added upstream) - CON: continually out-of-date/maintenance burdern The upstream manual does address versioning concerns, any features only present in say 2.0.49 will be marked as such. The RHEL manuals do also cover Apache configuration. It's also easy to set up a caching reverse proxy to the upstream sources, i.e.: ProxyPass /manual http://httpd.apache.org/docs-2.0/ # ... + caching setup > The upstream manual does address versioning concerns, any features
> only present in say 2.0.49 will be marked as such.
Because RedHat rather often backports new features to previous stable
versions of packages, sometimes it's hard to say which feature set
is available with this particular package.
And in all cases documentation should be available locally (no matter
how easy it can be found on the web. In Apache's case I personally
have some doubts about reliablility of the .org TLD.)
RedHat has commited to support RHEL3 for 5 years, till the end of
2008, or so. What if Apache project will cease to exist in December,
2005 [for example]?
Oh, please accept my apologies, I need to eat humble pie: the -manual package is actually included again from RHEL4! I'm not sure there's motivation to reverse this for RHEL3. It does not address your requirement that backported features are versioned appropriately. echo rsync -aqz --cvs-exclude rsync.apache.org::httpd-site/docs-2.0/ /var/www/manual/ > /etc/cron.daily/httpd-manual ? |