httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: httpd-2.0/docs STATUS
Date Sun, 15 Sep 2002 18:59:14 GMT
slive       2002/09/15 11:59:14

  Modified:    docs     STATUS
  Some status updates, including:
  - a bunch of idea for improving the xml/xslt; feel free to
    add or subtract.
  - remove all the head.html/foot.html from the list of files
    to convert to xml.  We may need to keep those around for
    a while to support translations.  We'll look at it later.
  - general cleanup.
  Revision  Changes    Path
  1.40      +35 -46    httpd-2.0/docs/STATUS
  Index: STATUS
  RCS file: /home/cvs/httpd-2.0/docs/STATUS,v
  retrieving revision 1.39
  retrieving revision 1.40
  diff -u -d -b -u -r1.39 -r1.40
  --- STATUS	15 Sep 2002 02:29:07 -0000	1.39
  +++ STATUS	15 Sep 2002 18:59:14 -0000	1.40
  @@ -3,7 +3,7 @@
   If you are interested in helping accomplish some of the tasks on this
   list or otherwise improving the documentation, please join the
  -apache-docs mailing list by mailing to
  +apache-docs mailing list by mailing to
   For more information on how to contribute to the Apache Documentation
   Project, please see, and
  @@ -24,22 +24,17 @@
       - mod_example: updates for 2.0
   - man pages
  -    - Some of the man pages need to be updated for 2.0.  At least
  -      the httpd man page appears to be outdated, and perhaps other.
  -      After this is done, the manual/programs/ versions can be
  -      regenerated using the program in the site-tools repository.
  +    - Some of the man pages need to be updated for 2.0. 
  +      Presently, these are generated from nroff man pages using
  +      the program in the site-tools repository, but nobody seems
  +      willing to update the nroff files at the moment.
  +      What should we do?
   - MPM documentation
  -   - Each MPM needs to have a documentation file in manual/mod/
  -     which lists the directives it provides, and some details
  -     about its operation.
  -        Status: Initial outlines done.  Much more details need to be
  -          filled in.
             - Non unix/windows MPMs still need to be completed.
             - the perchild directives in threaded/worker need docs
  -   - Individual docs will need some cleanup. 
  -        Status:  What docs still need to be touched here?
  +- Individual docs will need some cleanup. 
                    - misc/custom_errordocs.html needs to be updated to
                      essentially describe how the international error
                      docs included in 2.0 work
  @@ -53,11 +48,6 @@
       - install.html has had a first-pass rewrite, but many things have
         changed in the build system since it was written.
  -- Documentation of new features.
  -   - This will probably require more input from new-httpd, since
  -     not many people here follow the development process close
  -     enough to know what is going on.
   - API documentation
       Status: Ben Laurie has written some hooks documentation
  @@ -76,6 +66,22 @@
   Documentation improvements
  +* Enhancements to the DTD/XSL:
  +  - <glossary> tag that links to the glossary and uses some special 
  +    style in the css.
  +  - <parentdocument href="...">...</parentdocument> tag to give some
  +    more structure for the cookie-crumbs, etc.
  +  - New index: directives by context, including listing which directives
  +    are available for each AllowOverride setting.
  +  - Add more information to the directives.html index (description,
  +    syntax, context, ...) or perhaps add a quickreference.html
  +    that contains this info.
  +  - Use a tag like <replaceable> (but not that long) in place of
  +    <em> for things like the <syntax> listing.
  +  - Use the sitemap.xml in place of allmodules.xml to generate the
  +    directives.html and mod/index.html.
  +  - Handle more levels of sub<section>s.
   * Improving the "security docs"
     - More content and better organisation.
  @@ -98,9 +104,6 @@
       updates the manual indices.  (We do something like that now for
       httpd.conf file with apxs [LoadModule, etc.].)
  -* regex: We should at least document someplace what regex library we
  -  are using and how to find more information about it
   XML Conversions
  @@ -108,34 +111,22 @@
   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/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/
  @@ -144,8 +135,6 @@
  -vhosts/footer.html                 # delete after finishing vhosts/
  -vhosts/header.html                 # delete after finishing vhosts/

View raw message