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 (32-bit Perl compiled with USE_64_BIT_INT)

For example:
- perl540	for Perl 5.40.x
- perl540-nt	for Perl 5.40.x (compiled without USE_ITHREADS support)
- perl540-64I   for Perl 5.40.x (32bit perl compiled with USE_64_BIT_INT)

Note that not all versions are available for all platforms.


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.

We support Strawberry Perl on Windows.

ActiveState Perl distributions need the PDFlib bindings with
USE_ITHREADS support (i.e. not the "-nt" version).
