Big Faceless Report Generator                   Version 1.1.54      2012-08-20
------------------------------------------------------------------------------

0. PRODUCT INFORMATION
----------------------
The Report Generator is an XML to PDF converter, written entirely in Java.
The homepage for the product is http://bfo.com/products/report


1. MANIFEST
-----------
You should have received the following files with this distribution:

   README.txt		- This file
   bforeport.jar	- The JAR file containing the Java classes
   bforeport-14.jar	- Java 1.4 compatible version of the JAR file
   userguide.pdf	- The userguide for this product
   docs/api/		- Directory containing the JavaDoc API documentation
   docs/report-1.1.dtd	- The DTD for the XML files parsed by the generator
   docs/report-1.1.css	- The default CSS stylesheet used by the generator
   docs/CHANGELOG.txt	- The list of changes from previous versions
   docs/LICENSE.txt	- The license and warranty for this product
   docs/extra		- Additional information for developers
   example/		- Directory containing sample programs
   example/samples/	- Directory containing sample XML files.
   example/dynamic/	- Directory containing dynamic samples as JSPs.


2. REQUIREMENTS
---------------
To use the library, you'll need:

* JDK 1.4 or higher installed and running, although we recommend Java 5 or
  later for full functionality. Java 1.4 requires the use of the
  "bforeport-14.jar" Jar rather than the regular "bforeport.jar".

* For servlet use, a Servlet 2.2 or newer engine is required, although we
  recommend one supporting at least the Servlet 2.3 specification.

* For viewing the generated PDF's, you will need a PDF viewer such as Acrobat.


3. DOCUMENTATION
----------------
The two main sources of documentation are the "userguide.pdf", in the same
directory as this README, and the Element and Attribute reference, available
online at http://bfo.com/products/report/docs/tag

The XML syntax is very close to HTML, and we use CSS Level 2 to style the
elements. Other useful sources of information are:

  * http://www.w3.org/TR/REC-CSS2
  The CSS2 spec. Most of it is relevant, although we don't support it all.

  * http://www.htmlhelp.com/reference/css
  This is quite a good guide to the layout of CSS stylesheets, although
  it covers CSS1 only.

  * Your favorite HTML guide
  Most tags we use are HTML tags, and behave in basically the same way.

  * http://bfo.com/products/pdf/docs
  If there's a PDF term you don't recognize, it may be covered in the PDF
  library documentation. This is written in XML and supplied with this
  package.

  * http://bfo.com/products/graph/docs
  For information on the various options available for the graphs, and
  some more samples of what they look like.


4. BUG REPORTS AND SUPPORT
--------------------------

Bug Reports can be submitted to support@bfo.com. Please include
the following information:

* The platform and JDK version you are running on
* The version number of the library and of the SAX library being used.
* The version and platform of the viewer software (if applicable)
* The error message reported by the library (if applicable)
* If possible, attach the XML and the resulting PDF document.

Commercial support is available from the Big Faceless Organization. Details
and current pricing is available from the package homepage. 

------------------------------------------------------------------------------
Copyright (c) 2001-2012 The Big Faceless Organization. All Rights Reserved.
This package may also contain code copyright by third parties - see the
LICENSE.TXT file for more information
------------------------------------------------------------------------------
