Enabling HTML::Mason examples
=============================

This package provides an example configuration file, CGI handler and
component tree. If you have Apache installed, these can be enabled to be
visible at http://localhost/mason_example/index.html by following a few
steps:

- copy the mason_example directory to /var/www/
- copy mason_apache2_example.conf to /etc/apache2/conf.d/

If you're running under mod_perl (package libapache2-mod-perl2), reload
Apache and you're done. To run as a CGI, you'll also need the following
additional steps:

- copy mason_example.cgi to /usr/lib/cgi-bin/
- make it executable with 'chmod +x /usr/lib/cgi-bin/mason_example.cgi'
- enable mod_actions with 'a2enmod actions'
- restart Apache with 'service apache restart'

You should then be able to see the components at

    http://localhost/mason_example/index.html

Note that the included server configuration files are intended to work
in many different scenarios, and thus are not intended for general
use. Further, they were created for an older version of Mason, and may
not reflect current best practices. For instructions on configuring
Mason for your webserver, please see the README.Debian in the main
libhtml-mason-perl package, as well as the HTML::Mason::Admin manual.
