HTML::Mason examples Debian package
===================================

This package provides an example configuration file, CGI handler and
component tree. If you have Apache installed, these can be
automatically enabled to be visible at
http://localhost/mason_example/. You should have been asked about this
as the package got installed-- if not, try "dpkg-reconfigure
libhtml-mason-perl-examples".

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.

If you have mod_perl enabled in your server, you should be able to see
the same components at two different locations:

    http://localhost/mason_example/
    http://localhost/mason_example_cgi/

The second location works by redirecting all requests via a CGI. This
lets you get a feel for the speed difference. You can also try
installing speedy-cgi-perl, and changing the shebang (first) line of
/usr/lib/cgi-bin/mason_example.cgi to "#!/usr/bin/speedy".

In order to get this second location available, you need mod_rewrite
enabled in your server. The install script will *NOT* do this
automatically for you. Try:

    modules-config apache$VARIANT enable mod_rewrite

with Apache 1*, or

    a2enmod rewrite

for Apache 2.

If you do not have mod_perl installed, you will only have
"http://localhost/mason_example/" available via CGI. Even for this,
you need mod_actions enabled-- the install script will *NOT* do this
automatically for you. Try:

    modules-config apache$VARIANT enable mod_actions

with Apache 1, or

    a2enmod actions

for Apache 2.

*: for "apache$VARIANT", you need to write "apache-perl" if you have
the "apache-perl" package loaded rather than using apache and
libapache-mod-perl.

 -- Steve Haslam <araqnid@debian.org>, Mon Mar  8 12:41:52 2004