PDFlib and different versions of Perl
=====================================

Since extensions for Perl depend on the specific version of Perl in
use, we deliver various binary flavors of the PDFlib binding for Perl.

In the binary packages you will find a separate directory for 
each supported version of Perl:

- perl5<n>	for Perl 5.<n>.x
- perl5<n>-nt	for Perl 5.<n>.x (compiled without USE_ITHREADS support)
- perl5<n>-64I  for Perl 5.<n>.x (32bit perl compiled with USE_64_BIT_INT)

i.e.
- perl518	for Perl 5.18.x
- perl518-nt	for Perl 5.18.x (compiled without USE_ITHREADS support)
- perl512-64I   for Perl 5.12.x (32bit perl compiled with USE_64_BIT_INT)

Note that not all versions are available for all platforms. Perl on
SunOS and FreeBSD normally does not have USE_ITHREADS support.


If you see the following message when trying to use the PDFlib binding
for Perl:

  Unresolved symbol: Perl_Gthr_key_ptr (code)

you are using a version of PDFlib which has been built with USE_ITHREADS
support, but have a Perl binary without USE_ITHREADS support. To solve
this you must use the "-nt" build of PDFlib.

ActiveState Perl distributions work with the PDFlib bindings for Perl,
i.e. those with USE_ITHREADS support (and not the "-nt" version).

Since perl 5.18 we support ActiveState Perl and Strawberry Perl on
Windows.
