0N/AApache HTTP Server 2.0 Documentation Status File.

2362N/ALast modified: $Date: 2002/09/05 19:21:52 $

0N/A

0N/AIf you are interested in helping accomplish some of the tasks on this

0N/Alist or otherwise improving the documentation, please join the

0N/Aapache-docs mailing list by mailing to apache-docs-subscribe@apache.org

0N/A

0N/AFor more information on how to contribute to the Apache Documentation

0N/AProject, please see http://httpd.apache.org/docs-project/, and

0N/Ahttp://apache-server.com/tutorials/ATdocs-project.html for an excellent

0N/Atutorial on how to get started with making your contribution.

0N/A

0N/A ------------------------------

0N/A

0N/A- XML

0N/A - The xsl transformations could be greatly improved to a) look better

0N/A and b) use proper CSS+html rather than the horrible hack that

0N/A Joshua did (in progress).

2362N/A - Rewriting of the remainder of the manual into xml is in

2362N/A progress. See the bottom of this file for status info.

2362N/A

0N/A- modules docs

0N/A - mod_suexec: very little documentation

0N/A - mod_proxy: updates for 2.0

0N/A - mod_status: updates for 2.0

0N/A - mod_example: updates for 2.0

0N/A

0N/A- man pages

0N/A - Some of the man pages need to be updated for 2.0. At least

0N/A the httpd man page appears to be outdated, and perhaps other.

0N/A After this is done, the manual/programs/ versions can be

0N/A regenerated using the program in the site-tools repository.

0N/A

0N/A- MPM documentation

0N/A - Each MPM needs to have a documentation file in manual/mod/

0N/A which lists the directives it provides, and some details

0N/A about its operation.

0N/A Status: Initial outlines done. Much more details need to be

0N/A filled in.

0N/A - Non unix/windows MPMs still need to be completed.

0N/A - the perchild directives in threaded/worker need docs

0N/A

0N/A - Individual docs will need some cleanup.

0N/A Status: What docs still need to be touched here?

0N/A - misc/custom_errordocs.html needs to be updated to

0N/A essentially describe how the international error

0N/A docs included in 2.0 work

0N/A - misc/perf-tuning.html - needs major rewrite for 2.0

0N/A - misc/tutorials.html - mostly not relevant to 2.0

0N/A - misc/stopping.html

0N/A - misc/rewriteguide.html - needs cleaning in 1.3 and 2.0

0N/A - misc/known_client_problems.html - mostly ancient

0N/A

0N/A- New build process.

0N/A - install.html has had a first-pass rewrite, but many things have

0N/A changed in the build system since it was written.

0N/A

0N/A- Documentation of new features.

0N/A - This will probably require more input from new-httpd, since

0N/A not many people here follow the development process close

0N/A enough to know what is going on.

0N/A

0N/A- API documentation

0N/A Status: Ben Laurie has written some hooks documentation

0N/A

0N/A- Translations

0N/A There are several efforts underway to translate the documentation

0N/A into other languages. A detailed list of the currently known

0N/A translators (and the corresponding websites) can be found at

0N/A

0N/A http://httpd.apache.org/docs-project/translations.html

0N/A

0N/ANew User documentation

0N/A======================

0N/A

0N/A* Directory Handling (mod_dir/mod_autoindex/etc)

0N/A

0N/ADocumentation improvements

0N/A==========================

0N/A

0N/A* Improving the "security docs"

0N/A

0N/A - More content and better organisation.

0N/A

0N/A* General cleaning and improving of module docs

0N/A

0N/A* Making the directive definitions "less terse" (i.e., adding more

0N/A examples and details to the definitions of the directives)

0N/A

0N/A - We'll need to audit these and find out which ones need munging, as

0N/A some of it looks ok. --jsl

0N/A

0N/A* Making site-specific enhancements easier, including a documented

0N/A and robust way for 3P module docco to be added -- and have it

0N/A survive a server docco upgrade

0N/A

0N/A - This could be something a simple and hackish as a manual/extra/

0N/A directory (a la the 1.3 src/modules/extra/ directory) and a

0N/A script in the support directory that scans the files there and

0N/A updates the manual indices. (We do something like that now for

0N/A httpd.conf file with apxs [LoadModule, etc.].)

0N/A

0N/A* regex: We should at least document someplace what regex library we

0N/A are using and how to find more information about it

0N/A

0N/AXML Conversions

0N/A===============

0N/A

0N/AThe following files need to be converted to XML as described at

0N/A

ebcdic.html # Perhaps move to platform/

footer.html # delete after finishing manual/

header.html # delete after finishing manual/

index.html.en # leave in html?

howto/footer.html # delete after finishing howto/

howto/header.html # delete after finishing howto/

misc/custom_errordocs.html # obsolete?

misc/descriptors.html # obsolete?

misc/fin_wait_2.html # obsolete?

misc/footer.html # delete after finishing misc/

misc/header.html # delete after finishing misc/

misc/known_client_problems.html # obsolete?

misc/perf-tuning.html

misc/tutorials.html # obsolete?

mod/footer.html # delete after finishing mod/ directory

mod/header.html # delete after finishing mod/ directory

platform/footer.html # delete after finishing platform/

platform/header.html # delete after finishing platform/

ssl/footer.html # delete after finishing ssl/

ssl/header.html # delete after finishing ssl/

ssl/ssl_glossary.html # delete. replaced by ../glossary.html

vhosts/footer.html # delete after finishing vhosts/

vhosts/header.html # delete after finishing vhosts/

expand.pl # delete after finishing everything

# These will require manual.xsl changes

faq/footer.html

# Perhaps these should be left in html to allow the developers to

# play with them

# These are currently generated from nroff, but nobody is editting

# the nroff sources. Should we just convert to pure xml and forget

# about man pages?