*****************************************************************************
*                                                                           *
* PDFUnit - Automated PDF Tests                                              *
*                                                                           *
* Copyright (C) 2015 PDFUnit.com                                            *
*                                                                           *
* This file is part of the commercial library PDFUnit.                      *
*                                                                           *
* Legal information__: http://www.pdfunit.com/en/licensing.html             *
* Manual_____________: http://pdfunit.com/en/documentation/                 *
* Contact for license: license[at]pdfunit.com                               *
*                                                                           *
*****************************************************************************

Description: 
------------

  PDFUnit is a tool to verify visible and invisible content of PDF documents.
  Also the layout can be validated. It provides a fluent API. 
  
  Internally it uses the features of JUnit, iText and some other products.
  
  PDFUnit is available for Java and XML (07/2012).
  An implementation in C# is started.
  The integration in other languages are intended. 


Homepage: 
---------
  See www.pdfunit.com


Installation:
-------------
  Extract the file pdfunit-<version>_<date>.zip into a folder,
  for example into PROJECT_HOME/lib/pdfunit-<version>. In the following 
  description this folder is called "INSTALLATION".
    
  If you received a license key file, copy it to the same directory.
  Don't change the name of the license key file.
    
  Extend your CLASSPATH: 
  - INSTALLATION/pdfunit-<version>.jar
  - INSTALLATION/lib/*.jar
  - INSTALLATION     (the folder is needed, to read the license key file)

  Here an example for ANT:
   <path id="project.classpath">
      <pathelement location="${dir.external.tools.pdfunit}"/>
      <fileset dir="${dir.external.tools}">
        <include name="**/*.jar"/>
      </fileset>
      <pathelement location="${dir.build.classes}" />
    </path>
    
  You need the jar's of iText version 5.x. 
  Normally they are not distributed.
  Extend your CLASSPATH with the iText installation folder.
  
Update:
--------
  When you install a new version, you have to do the same steps, as with
  the first installation. License key file and pdfunit-<version>.jar are
  corresponding to each other. You can't use a new license key file with
  an older pdfunit-<version>.jar.
  
License:
--------
  PDFUnit is a commercial product. You can evaluate it as long as you want,
  but during the evaluation you have to answer a little math question.
  When using the license key file that question will not appear.
    
  When you give a wrong answer to the math question, all test end with
  the exception 'com.pdfunit.internal.errors.PDFUnitLicenseError' 
    
  You can ask for a license here:  license[at]pdfunit.com

    
Configuration:
--------------    
  PDFUnit comes with one config file: 'config.properties'.
  Only a few congurations are possible:
  - 'dateformat'
    When your PDF processor creates an individual date format and
    you want to write tests against this date, then you can place
    your format pattern according to java.text.SimpleDateFormat.
  - Namespaces when dealing with XMP data.
    See the samples in 'config.properties' for more information.
  - At last, the implementation of another service provider is possible.
    Currently, the only one is iText.
  
  When the config file could not be found in the CLASSPATH, all
  tests end with 'junit.framework.AssertionFailedError'.
  
    
Technical Infos:
----------------
  The project was developed with Eclipse.
  Java 1.7+ is required.
  PDFUnit runs under Windows and Linux and other JDK's, 
  not only SUN's (Oracle's). But not all JDK's are tested.


Feedback:
---------
  feedback[at]pdfunit.com
