1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107
|
<?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html>
<head>
<title>codadd</title>
<link rel="stylesheet" href="../css/codadoc.css" type="text/css" />
</head>
<body>
<div class="main">
<h1>codadd</h1>
<p>This documentation describes the functionality of the codadd tool which is part of CODA.</p>
<h2 id="general">General description</h2>
<p>The codadd tool is a support tool for the CODA Product Format Definition (.codadef) files. It is able to verify and inspect the .codadef contents, it allows generation of HTML documentation for the product format definitions, and provides conversion functions for format definitions.</p>
<pre>
codadd [-D definitionpath]
Try to read all product definitions and report any problems
codadd [-D definitionpath] doc <directory>
Generate HTML product format documentation in the specified directory
codadd [-D definitionpath] list [<list options>]
[<product class> [<product type> [<version>]]]
Gives an overview of available product definitions
When all of product class, product type, and format version are provided
an overview of the product content for the specified product definition
is given
List options:
-e, --expr
show expressions for dynamic array sizes
-q, --quote_strings
put "" around string data and '' around character data
-s, --column_separator '<separator string>'
use the given string as column separator (default: ' ')
-t, --type
show basic data type
-u, --unit
show unit information
--description
show description information
--hidden
show record fields with 'hidden' property
--parent-types
show additional lines for records and arrays
--attributes
show additional lines for attributes
--no_special_types
bypass special data types from the CODA format definition -
data with a special type is treated using its non-special
base type
codadd [-D definitionpath] xmlschema [<xmlschema options>]
<product class> <product type> <version>
Create an XML Schema file for a single product definition
Note that this will only work if the product class/type/version points
to a product definition for an XML file
XML Schema options:
-o, --output <filename>
write output to specified file
codadd [-D definitionpath] definition [<definition options>] <product file>
Create a CODA definition XML file with the format definition of a
product. The XML file is a standalone definition file similar to those
used within .codadef files.
Definition options:
-o, --output <filename>
write output to specified file
codadd [-D definitionpath] dtree <format>
Shows the product recognition detection tree for the given file format.
Note that ascii and binary formatted products use the same detection
tree
codadd -h, --help
Show help (this text)
codadd -v, --version
Print the version number of CODA and exit
CODA will look for .codadef files using a definition path, which is a ':'
separated (';' on Windows) list of paths to .codadef files and/or to
directories containing .codadef files.
By default the definition path is set to a single directory relative to
the tool location. A different definition path can be set via the
CODA_DEFINITION environment variable or via the -D option.
(the -D option overrides the environment variable setting).
</pre>
<div class="footer">
<hr />
<p>Copyright © 2007-2022 <b>s<span class="soft-red">[</span>&<span class="soft-red">]</span>t</b>, The Netherlands.</p>
</div>
</div>
</body>
</html>
|