You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pdfbox.apache.org by ju...@apache.org on 2008/09/18 19:14:39 UTC
svn commit: r696722 - in /incubator/pdfbox/trunk: LIMITATIONS.txt README.txt
Author: jukka
Date: Thu Sep 18 10:14:38 2008
New Revision: 696722
URL: http://svn.apache.org/viewvc?rev=696722&view=rev
Log:
README.txt: Added build instructions and merged the content of LIMITATIONS.txt.
Removed:
incubator/pdfbox/trunk/LIMITATIONS.txt
Modified:
incubator/pdfbox/trunk/README.txt
Modified: incubator/pdfbox/trunk/README.txt
URL: http://svn.apache.org/viewvc/incubator/pdfbox/trunk/README.txt?rev=696722&r1=696721&r2=696722&view=diff
==============================================================================
--- incubator/pdfbox/trunk/README.txt (original)
+++ incubator/pdfbox/trunk/README.txt Thu Sep 18 10:14:38 2008
@@ -4,6 +4,35 @@
PDFBox is an open source Java library for working with PDF documents.
+You need Apache Ant <http://ant.apache.org/> to build PDFBox. Once you
+have installed Ant, you can build the sources by running "ant" in
+this directory.
+
+The Ant build will create a Checkstyle report if you have Checkstyle
+<http://checkstyle.sourceforge.net/> installed. Set the checkstyle.home.dir
+property in a build-local.properties file to enable the report.
+
+The Ant build will build the PDFBox web site if you have Apache Forrest
+<http://forrest.apache.org/> installed. Set the FORREST_HOME environment
+variable to enable the web site build.
+
+Known Limitations and Problems
+==============================
+
+1. You get text like "G38G43G36G51G5" instead of what you expect when you are
+ extracting text. This is because the characters are a meaningless internal
+ encoding that point to glyphs that are embedded in the PDF document. The
+ only way to access the text is to use OCR. This may be a future
+ enhancement.
+
+2. You get an error message like "java.io.IOException: Can't handle font width"
+ this MIGHT be due to the fact that you don't have the Resources directory
+ in your classpath. The easiest solution is to simply include the
+ apache-pdfbox-x.x.x.jar in your classpath.
+
+See the issue tracker at https://issues.apache.org/jira/browse/PDFBOX for
+the full list of known issues and requested features.
+
Disclaimer
==========