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
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.
-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 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.