/ 
Apache-PrettyPerl-2.00
River stage zero No dependents
/ Apache::PrettyPerl

NAME

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

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>

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

DESCRIPTION

This is apache 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).

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: octopus(at)verplant.org

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

Copyright (c) 2000 Roman Kosenko. Copyright (c) 2004 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.