FOP: Downloading A Distribution

Most FOP users will want to download the latest binary distribution, which is ready to run "out of the box." However, a source distribution will be preferable if you fall into one of the following categories:

• You wish to modify FOP.
• You wish to use a version more recent than the latest release. For example, if you have read on the user mailing list that a bug has been fixed or a feature added that you are eager to try, you might download a source distribution from the CVS repository so that you don't have to wait for the next release.
• You wish to build a local copy of the API documentation (javadocs).

Binary distributions include "-bin" in their names, and can be downloaded from the FOP Distribution directory.

You must first determine which of the two main development branches you wish to download, "maintenance" or "redesign". See Development Introduction for more details on the choices, and for the CVS tags to use when downloading the "maintenance" branch.

There are three ways to obtain a source distribution. Please note that they are listed from least current to most current:

• Download a released version from the FOP Distribution directory. Source distributions include "-src" in their names. Please note that official releases currently are only made from the "maintenance" branch.
• Download a CVS snapshot from the cvs files here. These snapshots are built approximately every six hours, and have the GMT of their creation time embedded in their names. Please note that CVS snapshots are made only for the "redesign" branch.
• Download directly from the CVS repository. Anyone can do this using the Anonymous CVS Server. By default, the CVS code is up-to-the-minute, the same code that the developers are modifying. See the CVS section of Developer Tools for more information on using CVS.

With any source distribution, you will need to Build FOP from the source files.