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:
patches welcome...
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.
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.
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?
not sed-fu, writing extra apache documentation sounds good.. what about the gentoo web server handbook? (iirc there is sth in our overlay)
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.