758N/AApache HTTP Server Trunk Documentation Status File. Last modified: $Date$
758N/AFor more information on how to contribute to the Apache Documentation
758N/A ------------------------------
758N/A- The following directives of modules included in
2.4.x are not documented:
758N/A ProxyHTMLMeta (mod_proxy_html)
758N/A SSLPKCS7CertificateFile (mod_ssl)
758N/A document to be useful. In particular:
758N/A - Document the various macros that can be used in documents.
758N/A - Document the translation process.
758N/A - Generally update it to make it reflect the current reality of how
1116N/A - Improving the documentation of the documentations' build system
758N/A itself (requirements, procedures)
758N/A- Continue to enhance the FAQ, which is in the wiki:
758N/A- Security docs are unhelpful, and assume that the reader knows nothing.
1818N/A Need something a little more advanced, which either discusses
758N/A application-level security, or links to something that does. I'm not
758N/A even sure what to say needs done. Can we get someone to elaborate on
758N/A what, exactly, needs written? Ivan Ristic has said maybe he would be
758N/A - More content and better organisation
758N/A - mod_dav resources are owned by the httpd. Perhaps write up the
758N/A two-httpd dav setup covered in Rich Bowen's DAV Apachecon
They both need review and updates to reflect the current state
- Bill Rowe is a good contact for tech questions.
- "using apache" has been done, "compiling apache" is still open
- hints on uninstalling apache (exit monitor, close directories,
registry entries etc) (PR 10154)
- FAQ: UTF-8 config and URL encoding for non-ascii characters.
- Much clean-up and enhancement of aaa howto (Can someone clarify
exactly what needs cleaned up and enhanced?)
- Independent note on how to upgrade to new auth system
- Discussion of DBD auth, and, in particular, examples of how to set
up auth using each of the supported databases.
- Expression syntax for <If>, Require expr, SetEnvIfExpr, CustomLog, ...
Start is in
expr.xml, igalic is working on this
- the following modules added since 2.2 lack documentation
the list may be incomplete
maybe some of the modules will not be included in 2.4
- mod_suexec: very little documentation
- mod_substitute and reverse proxies: Add example using mod_filter
- explain what the following command line options do
-D ONE_PROCESS -- is this the same as -X, if not, should it be?
one-process-mode == no threads,
i.e. only one
process handling the requests in a single loop?
- Identify which documents are grossly out of date, and fix.
- SSL docs need serious update and enhancement
- A basic how to has been started here:
but it needs some work...
looks like a good starting point for overhauling the FAQ, and
has been placed at our disposal by the author.
- Ben Laurie has written some hooks documentation
- authn provider API documentation could be useful
- Missing documentation for the support program checkgid
(draft available in wiki)
- New index: directives by context, including listing which directives
are available for each AllowOverride setting.
- New index: backout modules by type (aaa, mappers, loggers etc.)
probably by introducing a <category> element in modulesynopsis
- Use a tag like <var> in place of <em> for things like the
- add letter links to glossary and quickreference,
perhaps also a term overview (sidebar)
- Provide example solutions for the mapping of encodings, especially
for .gz etc. (also in regard to our default configuration)
- How-To style documents for more of the daily tasks
- Logging, log rotation, and log reporting
- Secure mod_dav configuration
- Purge all the dead links
- Verify links to external resources at least every year
- Update the list of translations at
are accurate, and others are way outdated.
- I'd like to expand the discussion of conditional logging, and add a
few more useful exmaples.
That would be a good place to document logging of cache
hit/miss:
- Is it worth having a doc that discusses recommended (what does this
mean?) third-party modules like mod_security, mod_php, and so on - the
things that we all assume everyone uses, but some folks might not know
- Clarify which directives only affect requests when they're handled
by the default handler. (
e.g. ForceType, TraceEnable, etc.)
- Add examples using expr to mod_rewrite recipes. Possibly benchmark the
different approaches and make intelligent remarks about the
comparative value of each.
- Fix this error message:
Request exceeded the limit of 10 internal redirects due to probable
configuration error. Use 'LimitInternalRecursion' to increase the limit
if necessary. Use 'LogLevel debug' to get a backtrace.
This error message is often returned when a RewriteRule loops, in
which case setting LimitInternalRecursion won't do anything towards
fixing the problem. However, the error message is already very long.
- Examples in Rewrite Flags doc for QSD, Redirect, Chain, DPI, END, NS
Decide how and where to document the error codes (AH****), and then
- If someone has xslt and LaTeX skills, they could consider getting the
xml->LaTeX->PDF build chain working again. See specifically
of what's broken. For the moment, PDF docs are no longer referenced on
- The "MSIE on Mac" example in the SSI Howto is silly, and needs to be
replaced by something actually useful and relevant in this century.