==========================================================================
Aspose.Words for Java
==========================================================================

Aspose.Words enables Java applications to read, modify and write Microsoft Word 
documents without utilizing Microsoft Word. 



Download Contents
===============================

This distribution contains the following directories:

- lib           : The jars, compiled and ready to use.
- demos   : The demo projects.
- apidoc   : The documentation in JavaDoc format.


The lib directory contains the following jar archives:

- Aspose.Words.jdk14.jar : Aspose.Words for Java compiled for use under JDK 1.4
- Aspose.Words.jdk15.jar : Aspose.Words for Java compiled (and optimized) for use under JDK 1.5
- Aspose.Words.jdk16.jar : Aspose.Words for Java optimized for use under JDK 1.6.
- \demos-only-libs\itext-xxx.jar : Used by the demos to generate simplified PDF.
- \demos-only-libs\testng-xxx.jar.jar : Used to conveniently launch the Examples demo under IntelliJ IDEA.



The demos directory contains:

- Java source code of the demo projects.
- MS Word documents and MS Access database, used by the demo projects.
- (optional) IntelliJ IDEA 8.x project, module and workspace files for the demo projects



Required and optional Software and Libraries
===============================

- JDK 1.6.x or JDK 1.5.x or JDK 1.4.x is required.

- No external libs required for launching Aspose.Words for Java.

- IntelliJ IDEA 6.x, 7.x or 8.x if you want to instantly run the demo project.

- Apache Tomcat servlet container if you want to run the web demo project.

- iText library if you want to launch the demo part that generates simplified PDF. The jar is included in the Aspose.Words for Java download.

- TestNG library Used to conveniently launch the Examples demo under IntelliJ IDEA.. The jar is included in the Aspose.Words for Java download.


Demo projects
======================

For examples how to use Aspose.Words for Java, see the demo projects source code in the demos folder.
To instantly run the demo projects you need:

- JDK 1.6.x or JDK 1.5.x or JDK 1.4.x;

- IntelliJ IDEA  8.x, 7.x or 6.x;

- MS Access ODBC data source driver (installed in almost all Windows PC).

- Apache Tomcat servlet container if you want to run the web demo project.



There are four IntelliJ IDEA projects in the demos folder:

- Aspose.Words.Demos\Aspose.Words.Demos.14.ipr (with corresponding module file Aspose.Words.Demos.14.iml 
  and workspace file Aspose.Words.Demos.14.iws) - runs demos using Aspose.Words.jdk14.jar and JDK 1.4.x.

- Aspose.Words.Demos\Aspose.Words.Demos.15.ipr (with corresponding module file Aspose.Words.Demos.15.iml 
  and workspace file Aspose.Words.Demos.15.iws) - runs demos using Aspose.Words.jdk15.jar and JDK 1.5.x.

- Aspose.Words.Demos\Aspose.Words.Demos.16.ipr (with corresponding module file Aspose.Words.Demos.16.iml 
  and workspace file Aspose.Words.Demos.16.iws) - runs demos using Aspose.Words.jdk15.jar and JDK 1.6.x.

- Aspose.Words.Demos.Web\Aspose.Words.Demos.Web.ipr (with corresponding module file Aspose.Words.Demos.Web.iml 
  and workspace file Aspose.Words.Demos.Web.iws) - runs demos using Aspose.Words.jdk14.jar, JDK 1.4.x and 
  Apache Tomcat servlet container. For further references about launching the web demo project see file
  demos\Aspose.Words.Demos.Web\How to Tomcat.txt.

- DocumentExplorer\Aspose.Words.DocumentExplorer.ipr (with corresponding module file Aspose.Words.DocumentExplorer.iml 
  and workspace file Aspose.Words.DocumentExplorer.iws) - runs demos using Aspose.Words.jdk15.jar, JDK 1.5.x
  and itext-1.4.2.jar library.

- Examples\Examples.Java.ipr (with corresponding module file Examples.Java.iml  and workspace file Examples.Java.iws)
  - instantly runs javadoc's examples using Aspose.Words.jdk15.jar, JDK 1.5.x and TestNG library.


Documentation
======================

- For the Aspose.Words for Java API Reference in the JavaDoc format see apidoc\index.html.

- http://www.aspose.com/Products/Aspose.Words/Api/ is the home page for Aspose.Words Product Documentation
that includes Getting Started, Programmer's Guide and other articles.



http://www.aspose.com/

Copyright (c) 2006-2009 Aspose Pty Ltd. All Rights Reserved.
