Manual Reference Pages - PERL2HTML (1)
perl2html - generates highlighted html-files from Perl source
Installing as a CGI program
<B>perl2htmlB> [options] [filename...]
This manual page
documents how to use
<B>perl2htmlB>. If no arguments are given on the command line of
reads from stdin and writes to stdout.
If invoked with filenames as arguments
<B>perl2htmlB> will write its output into new files. Names of output
files are generated by appending ".html" to the
corresponding input filename.
Installing as a CGI program
<B>perl2htmlB> can be installed as a CGI program and convert source files on the
fly. In order to set this up for apache the webmaster has to add the
AddType text/x-perl .pl .pm
Action text/x-perl /cgi-bin/perl2html
to the webserver configuration file.
<B>perl2htmlB> depends on the webserver properly setting environment variable
PATH_TRANSLATED to the pathname of the source file.
<B>perl2htmlB> has been compiled with option -DCOMPRESSION=1 then it will invoke
<B>gzipB> to compress the generated HTML before sending it to the requesting
browser. Of course
<B>perl2htmlB> takes care to check if the browser accepts gzip encoding.
Interpret all following arguments on the command line as filenames.
This is useful, if you want to convert files beginning with a -.
-b filename |
Insert the file filename after converted data and before
HTML footer. See also the
Turns off CGI-script detection and HTTP header generation.
This is needed to use
<B>perl2htmlB> as a subcommand in another CGI script.
-h filename |
Insert the file filename after the HTML headers and before
the converted data. See also the
Number lines and label them with line followed by the line
number. Empty lines get no label, but the linecounter will count
them nevertheless. With this feature you can refer to special
lines of code from other parts of the generated file
or from external files with a line like this:
<A HREF="foo.pl.html#line301">Go to line 301</A>
With this option you can suppress the generation of HTML headers.
This is especially useful together with options
-b file and
-t title |
Set the title to title. The default is the filename you
converted or "stdin" if reading from stdin. This option is only
-s is not set.
Print usage information.
-w width |
sets the WIDTH attribute for HTML tag <PRE>. If this option is not
used a default of 80 is assumed. (Currently most browsers are
ignoring this attribute).
reports the version number of
<B>perl2htmlB> returns 0 on success, 1 if input files are not existing/readable, 2 if
output files are not creatable/writable, 3 if invoked with illegal
options and 4 if
<B>gzipB> cannot be invoked.
Florian Schintke <email@example.com>
Martin Kammerhofer <firstname.lastname@example.org> wrote the CGI feature.
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.