# DocFlex/Javadoc - Documentation - Installation / Configuration Files

1. Installation
2. Configuration Files
   - docflex.config
   - docflex.license
   - designer.config
   - generator.config

## 1. Installation

Installation of DocFlex/Javadoc is very simple:

1. Unpack the downloaded archive.
2. Copy the DocFlex license file `'docflex-javadoc.license'`, which you received by e-mail, into the `'lib'` directory. This file must be always near the DocFlex/Javadoc Java library (`docflex-javadoc.jar`) file!
3. Edit `generator.bat` and `designer.bat` to specify the `'JDK_HOME'` variable according to the location of JDK 7.x, 6.x, 5.x or 1.4.x installed on your system.

After that, you can start:

- `generator.bat` (e.g. to generate some demo JavaDoc)
- `designer.bat` to launch the Template Designer (e.g. to investigate JavadocPro templates)

To generate the real JavaDoc (for you project) you will need to specify in the `generator.bat` your Java packages/classes to document.

See also:

- Documentation | DocFlex Doclet | Running Doclet
- Documentation | FAQ | Troubleshooting | Cannot find doclet class
- The README file found in the downloaded archive

## 2. Configuration Files

File | Description
--- | ---
docflex.config | This is the DocFlex/Javadoc main configuration file. It contains: The locations of other configuration files used by DocFlex/Javadoc. Normally, all of them reside in the same `'config'` directory. The default template directory The default output directory An alternative location of docflex.license file The external system command to open a URL which is used to launch an external viewer for generated output files (see -launchviewer command line option). The main configuration file is used for reading only and never changed. Default Location: By default, the main configuration file is `'docflex.config'` and searched in the same directory where the DocFlex/Javadoc Java library `docflex-javadoc.jar` (or `docflex-doclet.jar`) is located. If not found, the `docflex.config` file is created automatically with the default settings. Alternative Location: Can be specified using -docflexconfig option both on Template Designer and Javadoc command line.
  docflex.license | The DocFlex/Javadoc license file, which you should receive by e-mail. Default Location: Searched near the DocFlex/Javadoc Java library file `docflex-javadoc.jar`.
  Note: | Since the version 1.5.4, the default DocFlex/Javadoc license file is `'docflex-javadoc.license'`. If this file is not found, the license is searched in `'docflex.license'` file.
Alternative Locations: Can be specified using -license option both on the Template Designer and Javadoc command line Can be assigned in the main configuration file (docflex.config)
designer.config | The Template Designer configuration file. It stores the designer configuration for the recently edited templates. This file is created and maintained automatically. Default Location: `config/designer.config` -- assigned in the main configuration file Alternative Location: Can be specified using -config option on the Template Designer command line.
generator.config | The generator configuration file; used by the Generator to obtain all settings not specified directly on the command line. This file is created and maintained automatically by the generator dialog. It contains: The last used templates The values of template parameters The output directory and file name The output format options The launch viewer setting (see -launchviewer option) When the generator dialog is invoked next time, those settings are restored from the generator config file, so you don't need to re-enter them again. The values of template parameters previously specified for one template will also be loaded into the equally named parameters of other templates. You can use the generator dialog to quickly prepare a config file with the specific settings you need and, then, provide only this file on the Javadoc command line (using -config option) instead of specifying all those settings directly. Default Location: `config/generator.config` -- assigned in the main configuration file Alternative Location: Can be specified using -config option on the Javadoc command line. See Also: Documentation | DocFlex Doclet | Handling Template Parameters | Using Doclet GUI to prepare parameters for command line

Copyright© 2003-2012 Filigris Works, Leonid Rudy Softwareprodukte. All rights reserved.
To contact us, please visit www.filigris.com or e-mail to: contact@filigris.com