README
1DMT Standalone manipulation tools:
2----------------------------------
3
4There are two tools provided here to manipulate DMT data/meta-data:
5
6convertMDF - this tool converts from the older text-based meta data
7 file (root.mdf) to the new binary format (root.bmdf).
8
9 It takes a single argument, for example:
10
11 convertMDF test.mdf
12
13 After completion, a file called 'test.bmdf' will be
14 created in this directory.
15
16generateDMT - This tool calls the necessary 'Gen tool' and python
17 script to build the data and meta-data for a DMT
18 represented by a .zip file. For more information on
19 on how to manipulate the Dmt.zip file, see the document
20 entitled 'DMTreeGeneration.doc' in the docs directory.
21
22 NOTE: This script requires that you set the environment
23 variable JAVA_HOME to the location where your Java
24 runtime is installed.
25
26 It takes one required and one optional argument, for example:
27
28 generateDMT ../path/to/Dmt.zip (this creates output dir 'treedata')
29
30 OR
31
32 generateDMT ../path/to/Dmt.zip /tmp (creates 'treedata' dir in /tmp)
33
34 Inside the 'treedata' directory are all of the wbxml files that
35 represent the DMT data (the source xml files are also included
36 for debugging), as well as the necessary support files (acl.txt,
37 fstab, root.bmdf). The text-based root.mdf is included for
38 debugging purposes.
39
40 NOTE: The fstab file included in this directory is a SAMPLE only.
41 Please edit this file (it must be named 'fstab') to suit
42 your own tree structure.
43
44 There is a subdirectory called 'docs' inside of 'treedata' which
45 contains the javadoc-style html documentation for the tree
46 schema.
47
48The other subdirectories in this directory (bin and lib) contain necessary support
49files/programs for the two tools above.
50