The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

INSTALLATION

UNIX

- Unpack the archive

- perl Makefile.PL

You will be asked if you want to compile in support for Apache mod_perl. If you say yes, the source of Apache is searched (for headerfiles). If it can't found, please specify the basepath. Please make sure mod_perl is already installed. If you have installed mod_perl-0.96 or higher, Makefile.PL automatically suggests the same source path as was used to build mod_perl.

- make

- make test

- make install

WIN 32

I have tested the offline mode on Windows 95 with a Microsoft Visual C++ 4.2 compiler and I have succesfully run Embperl with apache_1.3b5-1.3.1 / mod_perl-1.12-1.14 / perl5.004_04-perl5.005 (without threads) on Windows NT with VC++ 5.0.

NOTE: It was necessary for me to compile perl5.004_04 with the VC++ on my own to get it to run with Apache and mod_perl, while I was able to use the binary distribution (/authors/id/GSAR/perl5.00402-bindist04-bc.tar.gz) of Perl for offline testing under Win 95.

NOTE: If you use mod_perl <= 1.11 you should apply the win32.patch, otherwise you will get a deadlock.

On Windows 95/NT you have to do the following:

perl Makefile.PL

nmake (you must have the c compiler in your path)

you will get an error about compiling Embperl.c. Edit Embperl.c and change

-#line "Embperl.xs"

to

+#line 1 "Embperl.xs"

now re-run nmake and it should compile.

nmake test

NOTE: nmake test needs libwin32, libwww and HTML::Parser installed to work

nmake install

Further Documentation

See "perldoc Intro" for an step by step introduction to Embperl.

See "perldoc Embperl" for complete documentation.

See the "eg/" directory for examples.

See "perldoc Faq" for Frequently Asked Questions.

1 POD Error

The following errors were encountered while parsing the POD:

Around line 70:

alternative text '"eg/"' contains non-escaped | or /