You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pdfbox.apache.org by ja...@apache.org on 2015/05/08 10:28:29 UTC
svn commit: r1678304 - in /pdfbox/cmssite/trunk:
content/1.8/dependencies.mdtext content/2.0/dependencies.mdtext
content/building.mdtext templates/skeleton.html
Author: jahewson
Date: Fri May 8 08:28:29 2015
New Revision: 1678304
URL: http://svn.apache.org/r1678304
Log:
Better dependency information for 2.0, add examples and getting started pages
Modified:
pdfbox/cmssite/trunk/content/1.8/dependencies.mdtext
pdfbox/cmssite/trunk/content/2.0/dependencies.mdtext
pdfbox/cmssite/trunk/content/building.mdtext
pdfbox/cmssite/trunk/templates/skeleton.html
Modified: pdfbox/cmssite/trunk/content/1.8/dependencies.mdtext
URL: http://svn.apache.org/viewvc/pdfbox/cmssite/trunk/content/1.8/dependencies.mdtext?rev=1678304&r1=1678303&r2=1678304&view=diff
==============================================================================
--- pdfbox/cmssite/trunk/content/1.8/dependencies.mdtext (original)
+++ pdfbox/cmssite/trunk/content/1.8/dependencies.mdtext Fri May 8 08:28:29 2015
@@ -12,6 +12,9 @@ The three PDFBox components are named ``
### Minimum Requirement
+- Java 1.5
+- [commons-logging](http://commons.apache.org/logging/)
+
The main PDFBox component, pdfbox, has a hard dependency on the [commons-logging](http://commons.apache.org/logging/) library.
Commons Logging is a generic wrapper around different logging frameworks, so you'll either need to also use a logging library like [log4j](http://logging.apache.org/log4j/)
or let commons-logging fall back to the standard [java.util.logging API](http://java.sun.com/j2se/1.4.2/docs/guide/util/logging/overview.html)
Modified: pdfbox/cmssite/trunk/content/2.0/dependencies.mdtext
URL: http://svn.apache.org/viewvc/pdfbox/cmssite/trunk/content/2.0/dependencies.mdtext?rev=1678304&r1=1678303&r2=1678304&view=diff
==============================================================================
--- pdfbox/cmssite/trunk/content/2.0/dependencies.mdtext (original)
+++ pdfbox/cmssite/trunk/content/2.0/dependencies.mdtext Fri May 8 08:28:29 2015
@@ -6,7 +6,7 @@ Title: Dependencies
PDFBox has the following basic dependencies:
-- Java 1.6 (or later)
+- Java 6
- [commons-logging](http://commons.apache.org/logging/)
Commons Logging is a generic wrapper around different logging frameworks, so you'll either need to also use a logging library like [log4j](http://logging.apache.org/log4j/)
@@ -32,7 +32,7 @@ Maven dependencies for these components
### Encryption and Signing
-Encrypting and sigining PDFs requires the bcprov and bcmail libraries from the [Legion of the Bouncy Castle](http://www.bouncycastle.org/). These can be included in your Maven project using the following dependencies:
+Encrypting and sigining PDFs requires the *bcprov* and *bcmail* libraries from the [Legion of the Bouncy Castle](http://www.bouncycastle.org/). These can be included in your Maven project using the following dependencies:
<dependency>
<groupId>org.bouncycastle</groupId>
@@ -46,19 +46,10 @@ Encrypting and sigining PDFs requires th
<version>1.51</version>
</dependency>
-#### Java Cryptography Extension (JCE)
+### Java Cryptography Extension (JCE)
256-bit AES encryption requires a JDK with "unlimited strength" cryptography, which requires extra files to be installed. For JDK 7, see [Java Cryptography Extension (JCE)](http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html).
This is required for building PDFBox. If these files are not installed, building PDFBox will fail the following test:
TestPublicKeyEncryption.setUp:70 JCE unlimited strength jurisdiction policy files are not installed
-
-## Building with Ant
-
-The above instructions expect that you're using [Maven](http://maven.apache.org/) or another build tool like [Ivy](http://ant.apache.org/ivy/) that supports Maven dependencies.
-If you instead use tools like [Ant](http://ant.apache.org/) where you need to explicitly include all the required library jars in your application, you'll need to do
-something different.
-
-The easiest approach is to run ``mvn dependency:copy-dependencies`` inside the pdfbox directory of the latest PDFBox source release. This will copy all the required and optional
-libraries discussed above into the pdfbox/target/dependencies directory. You can then simply copy all the libraries you need from this directory to your application.
Modified: pdfbox/cmssite/trunk/content/building.mdtext
URL: http://svn.apache.org/viewvc/pdfbox/cmssite/trunk/content/building.mdtext?rev=1678304&r1=1678303&r2=1678304&view=diff
==============================================================================
--- pdfbox/cmssite/trunk/content/building.mdtext (original)
+++ pdfbox/cmssite/trunk/content/building.mdtext Fri May 8 08:28:29 2015
@@ -64,4 +64,13 @@ In order to apply patches from 'trunk' t
- checkout the branch
- cd to the branch directory
- merge some changes from the trunk using "svn merge -cREV1,REV2,REV3... https://svn.apache.org/repos/asf/pdfbox/trunk"
-- commit the changes
\ No newline at end of file
+- commit the changes
+
+## Building with Ant
+
+The above instructions expect that you're using [Maven](http://maven.apache.org/) or another build tool like [Ivy](http://ant.apache.org/ivy/) that supports Maven dependencies.
+If you instead use tools like [Ant](http://ant.apache.org/) where you need to explicitly include all the required library jars in your application, you'll need to do
+something different.
+
+The easiest approach is to run ``mvn dependency:copy-dependencies`` inside the pdfbox directory of the latest PDFBox source release. This will copy all the required and optional
+libraries discussed above into the pdfbox/target/dependencies directory. You can then simply copy all the libraries you need from this directory to your application.
Modified: pdfbox/cmssite/trunk/templates/skeleton.html
URL: http://svn.apache.org/viewvc/pdfbox/cmssite/trunk/templates/skeleton.html?rev=1678304&r1=1678303&r2=1678304&view=diff
==============================================================================
--- pdfbox/cmssite/trunk/templates/skeleton.html (original)
+++ pdfbox/cmssite/trunk/templates/skeleton.html Fri May 8 08:28:29 2015
@@ -102,8 +102,10 @@
<li class="sidebar-header">Documentation</li>
<li class="sidebar-node" id="v2-0">
- <a href="#">2.0.0 (SVN trunk)</a>
+ <a href="#">2.0.0 (trunk)</a>
<ul>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
<li><a href="/2.0/dependencies.html">Dependencies</a></li>
<li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
</ul>