README for dwww
                              ``To boldly go where no doc has gone before''
---------------------------------------------------------------------------

dwww is a web interface to all on-line documentation on a
Debian system.  It builds some web pages that list all installed
documents, and converts all documents to HTML. The conversion
is done when the user requests the document. 

dwww requires running a web server with CGI support (i.e. apache,
boa, roxen, wn, etc., but NOT dhttpd or fnord.)
Sorry.

The CGI script capability of a web server may be disabled by default for
the security consideration.  You need to enable its CGI script
capability manually.  For apache2, do something along the following:

  $ sudo a2enmod cgid
  $ sudo systemctl restart apache2

The default for the HTTP/CGI access is limited to the local user for the
security consideration. 

For more information, read the manual page dwww(7), and the other
manual pages it refers to.



  Automatic fancy index of documents
--------------------------------------

Debian now has a "doc-base" package that provides a uniform way of
registering documentation; it supports other documentation systems besides 
dwww. Please read install-docs(8) for further reference.


         _                                    _
        |                                      |
            dwww is still under development!
        |_                                    _|


dwww is already quite usable, however.  Please use it, and report
bugs via the Debian bug tracking system so that they can be fixed.


vim:ts=4:et:ai