At the moment, almost none of the support programs included with Apache
are documented in the manual.  However, most of them do have man pages. I
think that we should add a section or link on the front page of the manual
for "Support Programs" which will include

-apachectl
-apxs
-dbmmanage
-htdigest
-htpasswd
-log_server_status
-log_resolve
-rotatelogs
-split-logfile
-suexec

(Perhaps a few of the small perl scripts like log_server_status,
log_resolve, and split-logfile, should be grouped under an "other" page.)

The question is how to do this without creating a bunch of duplicate,
difficult to maintain docs.  We could just use "man2html" to convert the
man pages, but this program creates horrible HTML, and would require
hand-tweaking of the output in any case. I don't think there is any way of
avoiding the fact that future changes will need to be made both to the man
page and the html docs.

Any ideas?

Joshua.

Reply via email to