The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Apache-PrettyPerl-2.10
River stage zero No dependents
++
/ Apache::PrettyPerl

NAME

Apache::PrettyPerl - Apache mod_perl PerlHandler for nicer output perl files in the client's browser.

DESCRIPTION

This is an Apache2 mod_perl2-handler that converts perl files on the fly into syntax highlighted HTML. So your perl scripts/modules will be look nicer. Also possibly download original perl file (without syntax highlight).

If you want to use Apache1 (and mod_perl1) you need to get Apache::PrettyPerl 2.00.

SYNOPSIS

You must be using mod_perl. See http://perl.apache.org/ for details. For the correct work your apache configuration would contain apache directives look like these:

  # in httpd.conf (or any other apache configuration file)
  
  <Files ~ "\.p[lm]$">
    SetHandler          perl-script
    PerlHandler         Apache::PrettyPerl

    # Below here is optional
    PerlSetVar          TabSize         8
    PerlSetVar          AllowDownload   On
  </Files>

This is only an example of an apache configuration. Most probably you should place the <Files> directive inside a <Directory> directive. Otherwise will be handled all perl files, including CGI and mod_perl scripts.

CONFIGURATION DIRECTIVES

All features of the this PerlHandler, will be setting in the apache confihuration files. For this you can use PerlSetVar apache directive. For example:

    PerlSetVar  TabSize 8   # inside <Files>, <Location>, ...
                            # apache directives
TabSize

Setting size of the tab (\t) symbol. Default is 8.

AllowDownload

If set to ``on'' a download link will be displayed which allows the unmodified file to be downloaded. Defaults to ``off''.

SEE ALSO

perl(1), mod_perl(3), Apache(3)

AUTHORS

Roman Kosenko, Florian octo Forster

Contact info

  Roman Kosenko:   ra(at)amk.lg.ua
  Florian Forster: octo(at)verplant.org

  Home page: http://amk.lg.ua/~ra/PrettyPerl/

Copyright (c) 2000 Roman Kosenko. Copyright (c) 2004, 2005 Florian Forster. All rights reserved. This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself.