ActivePerl versions
===================

- ActiveState's Perl is _not_ binary compatible to other versions of Perl
  with respect to extensions. For this reason the same PDFlib library can
  _not_ be used with ActivePerl and other versions. The PDFlib binary
  distributions support the following versions of Perl:

  Windows: ActivePerl
  others, especially Linux and Solaris: "standard" Perl (not ActivePerl)


Compiling PDFlib for ActivePerl on Win32
========================================
(not relevant for users of the binary distribution)

The distribution is set up to be compiled with ActivePerl 5.6.

With some minor modification you can also compile with ActivePerl
versions older than 5.6 (the MSVC project contains an "oldperl" configuration
with all of this):

- Run the compiler in C++ mode (required by ActiveState). In MSVC++ 6 there
  doesn't seem to be a GUI option for C++ mode, but the compiler switch
  /Tp works.

- Change the Perl include and lib paths appropriately.

- Change perl56.lib to perlcore.lib.


MacPerl
=======

In order to build a PDFlib Perl extension on the Mac, the PDFlib shared
library must be linked against a library named PerlStub which is supplied
with the Perl source distribution.