MKDoc with Apache 2
===================

This document explains what to change in the apache configuration files which
are generated by the MKDoc site installer so that MKDoc works under Apache 2 /
mod_perl 1.99.

Before you proceed make sure you install the latest CGI.pm and DBI.pm.


In httpd/httpd.conf
-------------------

* At the beginning of each <VirtualHost>, insert:

  PerlModule  Apache2
  PerlModule  Apache::compat
  PerlOptions +GlobalRequest
  PerlOptions +SetupEnv

* Change all SetEnv directives into PerlSetEnv directives

* Change all PerlInitHandler directives into PerlHeaderParserHandler directives


In httpd/httpd-env.conf
-----------------------

* Change all SetEnv directives into PerlSetEnv directives

* Remove duplicate PerlSetEnv directives


In httpd/httpd-mkdoc.conf
-------------------------

* Change Apache::Registry to ModPerl::Registry


Restart Apache 2
----------------

su
source <MKDOC_DIR>/mksetenv.sh
/usr/sbin/apachectl stop
/usr/sbin/apachectl start


EOF
