/ 
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.