Using PDFlib with Java
======================

This file collects information which is relevant for deploying PDFlib in
various Java environments.


Using the Java samples
======================

Ant
---
The Ant "build.xml" file can be used to compile and run all supplied
Java samples.


Eclipse
-------
In an existing or new Java project you can add a reference to the PDFlib
package as follows:

- In the Package Explorer right-click on the Java project and select
  "Java Build Path".
- Go to the "Libraries" tab, click "Add Library...", and select
  "Add External JARs..."
- Select "<pdflib-install-dir>/bind/java/pdflib.jar".
- While still in the "Libraries" tab, expand the "pdflib.jar" node and
  double-click "Native library location".
- In the dialog "Native Library Folder Configuration" click "External Folder..."
  and select the folder where the PDFlib native library is located (e.g.
  pdflib_java.dll).

After these steps you can explore the list of PDFlib methods under the node
"Referenced Libraries/pdflib.jar/com.pdflib/pdflib.class/pdflib"
in the Package Explorer view. When writing new Java code Eclipse will
assist with code completion and context-sensitive help for all PDFlib methods.


Makefiles
---------
For Unix platforms the supplied Makefile can be used to compile and
run the supplied samples.


Platform-specific Notes
=======================

Unix
----
On Unix/Linux platforms, after installing PDFlib it may help to update the
shared library cache via

ldconfig -v		(or similar command depending on your Unix version)
