Tilda Command Line Utilities: Docs

<-- Command-Line Utilities

Docs

This utility extracts HTML documentation and SQL scripts from an environment (via resources like JARs in the class path). The utility can take 1 or more parameters:

• A mandatory path to the folder where to put the documentation files from active Tilda schemas in the classpath.
• An optional path to a tilda.master.xxx.json file, or a list of schema names, to extract a subset of the documentation for specified schemas.

For example:

• Export docs and SQL for ALL the Tilda schemas found in the classpath
  • tilda.Docs C:\projects\docs\
• Export docs and SQL for the Tilda schemas listed in the master configuration file and their dependencies, grouped as defined, and found in the classpath.
  • tilda.Docs C:\projects\docs\ tilda.master.blah.json
• Export docs and SQL for the Tilda schemas Schema1 and Schema2 (and their dependencies), found in the classpath.
  • tilda.Docs C:\projects\docs\ Schema1 Schema2

The master configuration file is a JSON-based file:

The utility will export an HTML file TILDA___Docs.[schema_name].html and TILDA___[db_type].[schema_name].sql, and a master index file index.html. For example:

index.html
TILDA___Docs.SCHEMA1.html
TILDA___PostgreSQL.SCHEMA1.sql