httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject [Bug 58129] man pages are not generated correctly
Date Tue, 14 Jul 2015 00:51:39 GMT
https://bz.apache.org/bugzilla/show_bug.cgi?id=58129

Bruce Lilly <bruce.lilly@gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEEDINFO                    |NEW

--- Comment #2 from Bruce Lilly <bruce.lilly@gmail.com> ---
To be quite clear:
The default file and directory locations are established during configure prior
to building from sources (e.g. via --prefix=).  These are then hard-coded into
the httpd executable.
The default prefix, not the configured default location, is what is written in
docs/man/httpd.8 as distributed in the source tarball.

One of the problems is that httpd.8 is *NOT* updated to reflect the configured
default locations.
A related problem is that 'make install' as directed in
http://httpd.apache.org/docs/2.4/install.html installs -- without notice or
warning -- the *unmodified* httpd.8 (as part of the generated Makefile
install-man target).
There is certainly nothing in the generated Makefile nor in the "Compiling and
Installing" instructions that would result in httpd.8 being "Generated from XML
source" to reflect the actual configured and compiled-in locations.
http://httpd.apache.org/docs/2.4/install.html does not even mention the
documentation, the generation of which is apparently only described in a
separate, well-hidden area not likely to be seen by anybody following the
"Compiling and Installing" instructions.

To make matters worse, the gobbledygook hidden away regarding building the
documentation doesn't even mention the man pages -- at all.  I refer
specifically to
http://mirror.symnds.com/software/Apache//httpd/docs/README.html and
http://httpd.apache.org/docs-project/docsformat.html ("Module Format and
Transformation").
It is unclear (to me) whether or not going following what's hidden there would
result in pages being updated to reflect as-configured builds.

It is unreasonable to pin the blame for this on every single distribution,
since the Apache-distributed tarballs, the "Compiling and Installing"
procedure, and the (frankly) poorly documented procedure for building the
documentation directly result in this problem.

-- 
You are receiving this mail because:
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message