Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 71712 - Apache2 Manuals Wrong
Summary: Apache2 Manuals Wrong
Status: RESOLVED WONTFIX
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Apache Team - Bugzilla Reports
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2004-11-18 16:07 UTC by Kaiting Chen
Modified: 2005-02-26 11:44 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Kaiting Chen 2004-11-18 16:07:55 UTC
The Apache2 manuals still use the default names for most of the /usr/sbin files. For instance, it still says apachectl instead of apache2ctl. Either patch the manuals, or remove the lines in the ebuild that say something like:

mv /usr/sbin/... /usr/sbin/...2

The line that contains:
--with-suexec-bin=/usr/sbin/suexec2
will need to be changed to:
--with-suexec-bin=/usr/sbin/suexec

I think we should just patch the manuals.

Reproducible: Always
Steps to Reproduce:
Comment 1 Robin Johnson archtester Gentoo Infrastructure gentoo-dev Security 2004-12-18 19:26:46 UTC
patches welcome...
Comment 2 Elfyn McBratney 2005-01-23 11:47:49 UTC
What should be done with this?  I guess we have two options: sed-fu on the docs, or leave as-is.  I'm with the latter, as, if we change the installed docs, our docs will contradict upstream's and vice-versa.  Any thoughts?

Btw, Kaiting, taking out the part of the ebuild that renames files isn't an option while we're still supporting both 1.3 and 2.x versions of Apache.
Comment 3 Kaiting Chen 2005-01-23 19:49:38 UTC
Ok. Actually, the behavior I'd like best is to do use flags. I'd like a "noslot" flag so that it doesn't support both, as I don't use Apache, only Apache2. I'd implement this myself, but the last time I tried, everything broke. I'll try again and post the results.

And I'll try sed-ing the manuals too.
Comment 4 Michael Stewart (vericgar) (RETIRED) gentoo-dev 2005-01-23 22:18:02 UTC
A noslot USE-flag to keep the binaries from being renamed doesn't sit right with me, it'll cause support issues, and the slots can't be installed side-by-side anymore, which goes against Gentoo policy. USE-flags shouldn't effect things like that.

As to sed-fu on the manual... it should be doable, but this is upstream provided documentation - I don't think it should be changed like that. What should happen is additional documentation be created that is specific to Gentoo. Does anyone know of any other packages that sed-fu upstream-provided manuals? What does the Apache herd think? sed-fu or no sed-fu?
Comment 5 Benedikt Böhm (RETIRED) gentoo-dev 2005-01-25 03:29:23 UTC
not sed-fu, writing extra apache documentation sounds good..

what about the gentoo web server handbook? (iirc there is sth in our overlay)
Comment 6 Michael Stewart (vericgar) (RETIRED) gentoo-dev 2005-02-26 11:44:07 UTC
The installed default documentation from upstream will stay unmodified. We will provide a web-server handbook eventually - this is a differnt project and I don't know what the status is on it.

Resolving WONTFIX.