Notes on the PDFlib Tcl binding:

Unix
====

- You may have to change the name of the tclsh binary in the
  example scripts if you want to run them directly. Alternatively,
  you may want to create a symbolic link pointing to the installed
  version of tclsh.


Mac OS X
========

- The default build procedure for the PDFlib Tcl wrapper does not
  work on OS X. You can build it by applying the following changes:
  - disable "#define USE_TCL_STUBS" in pdflib_tcl.c
  - In the Makefile add "-ltcl8.3" at the end of PDFLIBCONVENIENT.

- You must manually rename the PDFlib library for Tcl before you can
  use it:

  cd bind/tcl/.libs
  cp libpdflib_tcl.dylib pdflib_tcl.bundle

- Unfortunately, "make install" will not work by default.


Windows
=======

A few special steps are required in order to build the PDFlib wrapper
for Tcl on Windows:

  - integrate the pdflib_crtdll project into the PDFlib workspace
  - delete the pdi.lib dependency from the pdflib_crtdll project
  - delete the HAVE_PDI preprocessor definition in the pdflib_crtdll project
  - manually build the flate, png, tiff, and pdflib_crtdll projects
    (in this order) with the pdflib_crtdll configuration
  - build the Tcl project


How to build the PDFlib wrapper for Tcl 8.0 or 8.1
==================================================

The precompiled versions of the PDFlib wrapper for Tcl require Tcl 8.2 or
above. The wrapper code can also be compiled with Tcl 8.0 or 8.1, although
is is not supported by the configure and Makefile process.
Do the following for building PDFlib with Tcl 8.0 or 8.1:

- #undef USE_TCL_STUBS in pdflib_tcl.c

- Add -ltcl to the linker command, and an appropriate -L option.