SampleAPI Generator for javadoc

1. General description

    The primary goal is to provide one or more data sets to be used as input

to the javadoc tool, such that it can be used to generate representative samples

of all the different content on all the different types of pages that can be

generated by javadoc.

    The tool is implemented as generator based on xml descriptions of data sets.

The xml description of data set provides top level entities (class, interface,

enum, annotation) with all possible content. Desired output parameters (fields,

methods, inner/nested classes) are also described in xml as lists of modifiers,

types and annotations. The generator "multiply" the entities from the lists

providing the set of all possible combinations.

    After the api generation the tool connects the javadoc style comments to

the generated entities with full possible sets of supported tags.

2. Tool structure

    Sources:

        test/tools/javadoc/sampleapi/lib - generator sources

        test/tools/javadoc/sampleapi/res/xml - sample data sets in xml

        test/tools/javadoc/sampleapi/res/txt - sample texts for doc comments

3. Public API

3.1 Command line runner

  * test/tools/javadoc/sampleapi/lib/sampleapi/SampleApiDefaultRunner.java

    class sampleapi.SampleApiDefaultRunner

  Options: [-?|-h|--help] [-o:<dir>|--outdir:<dir>]

    -?|-h|--help             - print help

    -o:<dir>|--outdir:<dir>  - set <dir> to generate output

3.2 Programmatic access

  * test/tools/javadoc/sampleapi/lib/sampleapi/SampleApi.java

    class sampleapi.SampleApi

    public void generate(File dir)

    public void generate(Path dir)

    public void generate(String dir)

3.3 How to run other xml data set description

  Put data set xml description into res/xml directory

  * test/tools/javadoc/sampleapi/lib/sampleapi/generator/PackageGenerator.java

    class sampleapi.generator.PackageGenerator

    public void processDataSet(String dsName)

    public void generate(File outDir)