Usage: mktree [-hxu#idz] [files...]

Create a Treepad file from an indented text file. The indentation
level indicates the Treepad nesting level.

Most lines are considered to be Treepad items.  However,  if a
line consists of a single dash ("-") and white space the program
considers all subsequent lines until the next single dash to be a
note associated with the preceeding outline item.
Unless the "-i" option is specified, indentation is preserved in the note.
Indentation is relative to the first line of the note , however, and
leading tabs are converted to spaces.

When creating a treepad file, the indentation size is determined as follows:
when the first line is read that is more indented than its predecessor,
that indentation difference is the indentation size. For example, since tab
characters are considered to occur every 8 characters, if the first line
starts in the first column and the second line starts with a tab character
(and is not a single dash), the indentation size will be 8 in this case.

When de-converting a treepad file into an indented file, each indent level
is represented by a single tab character.

Tabstops are considered to occur every 8 character positions.
Blank lines are discarded, except inside a note.

-#, (# is a number > 0), forces all items indented more than # to be notes.
-0 forces the entire file to be treated as a note, node is the current day

The top level node name will be the file name.
The first level node name under that will be the current date and weekday.

Lines with single dashes ("-") are never copied to the treepad file.

If the first non-blank line of the file is a note delimiter ("-"),
the file is treated as if -0 had been specified

Specifying -u causes -# to be ignored.

The -x option is a quick and dirty way to convert from a treepad file
to Pilot memos suitable for import into the Pilot Thought Manager
outliner application.
To import a treepad file into Thought Manager follow these steps.
1. Run the treepad file through this filter, creating a temporary file,
   e.g. "mktree MyFile.hjt Myfile.tmp".
2. In the Palm Pilot Desktop application import this temporary file into
   the memopad as memos (use the .csv format). If the treepad outline is
   big there may be several memos named Outline, Outline-2, Outline-3, and
   so on, where Outline is the root node name of the treepad w=file.
3. In the Thought Manager application on the Palm Pilot import the first
   of these new memos (the one without -number at the end of its name) as a
   new outline. All the new memos will be combined to create a
   new Thought Manager outline.
This  option will be made obsolete in a forthcoming utility that converts
indented ascii files directly into Thought Manager databases.

Options :
        -h      Display this message and terminates
        -u      DeConvert from an Treepad file into a tab-delimited file
        -x      DeConvert from an Treepad file into an input file for
                Palm Pilot Thought Manager input format
        -[0-9]+ lines indented greater than the number are considered notes
        -i      Do not preserve indentation (leading white space) in notes
        -d      Second node is current date (implies >1 node zeroes)
        -d#     Second node is current date + or - # days
        -t      Second node is current date and time (implies >1 node zeroes)
        -z      First user node is node level zero (implies >1 node zeroes)

If -d, -t, or -z is specified, two (or more) nodes at level zero will be
produced.  This is not a legitimate treepad file, but it can be conveniently
imported into an existing treepad file.

The  "files"  argument  indicates the names of files to be converted. If no
files are specified or if the filename is a single '-', standard  input  is
converted.

Converted   output is  always  written to  single  standard  output  stream
(which may be redirected to a file).

On specifying options:
    Option  letters  are case-insensitive,  e.g.  -h and -H are equivalent.

    Options must  occur before  filename  arguments  and start  with a dash
    ('-')  immediately followed by an  option character. 

    For options that take values  (example: -t#),  the value may optionally
    be separated from the option letter by white space.