Category : File Managers
Archive   : TM122.ZIP
Filename : TM.DOC

TreeMaster 1.22

Copyright 1990 by New-Ware

All Rights Reserved

(tm) ÚÄÄÄÄÄÄÄÄÄ¿
ÚÄÄÄÄÄÁÄÄÄ¿ ³ MEMBER
ÄÄij ³ ³ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
³ ÚÄÄÄÄÄÄÁÄÄ¿ ³ Association of
³ ³ ÃÄÄÙ Shareware
ÀÄÄ´ þ ³ Professionals
ÄÄÄÄÄij º ³ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
ÀÄÄÄÄÐÄÄÄÄÙ









Contents


INTRODUCTION . . . . . . . . . . . . . . . . . . . . 2
PRODUCT REGISTRATION . . . . . . . . . . . . . . . . 3
VERSION HISTORY . . . . . . . . . . . . . . . . . . . 4
GENERAL PROGRAM DESCRIPTION . . . . . . . . . . . . . 5
PROGRAM OPERATION . . . . . . . . . . . . . . . . . . 6
STARTING TM . . . . . . . . . . . . . . . . . . . 6
MAIN TM DISPLAY . . . . . . . . . . . . . . . . . 6
THE CURSOR BAR . . . . . . . . . . . . . . . . . . 7
MOUSE SUPPORT . . . . . . . . . . . . . . . . . . 7
FUNCTION KEY COMMANDS . . . . . . . . . . . . . . 7
F-1 KEY . . . . . . . . . . . . . . . . . . . . . 8
F-2 KEY . . . . . . . . . . . . . . . . . . . . . 8
F-3 KEY . . . . . . . . . . . . . . . . . . . . . 8
F-4 KEY . . . . . . . . . . . . . . . . . . . . . 8
F-5 KEY . . . . . . . . . . . . . . . . . . . . . 9
F-6 KEY . . . . . . . . . . . . . . . . . . . . . 9
F-7 KEY . . . . . . . . . . . . . . . . . . . . . 9
F-8 KEY . . . . . . . . . . . . . . . . . . . . . 10
F-9 KEY . . . . . . . . . . . . . . . . . . . . . 10
F-10 KEY . . . . . . . . . . . . . . . . . . . . . 10
OTHER TM COMMANDS . . . . . . . . . . . . . . . . 10
INS KEY . . . . . . . . . . . . . . . . . . . . . 10
DEL KEY . . . . . . . . . . . . . . . . . . . . . 11
CTRL-END KEY . . . . . . . . . . . . . . . . . . . 11
CTRL-HOME KEY . . . . . . . . . . . . . . . . . . 11
TAB KEY . . . . . . . . . . . . . . . . . . . . . 12
CTRL-M KEY . . . . . . . . . . . . . . . . . . . . 12
CTRL-P KEY . . . . . . . . . . . . . . . . . . . . 12
CTRL-R KEY . . . . . . . . . . . . . . . . . . . . 12
CTRL-S KEY . . . . . . . . . . . . . . . . . . . . 12
FILE BROWSE MODE . . . . . . . . . . . . . . . . . . 13
DIRECTORY NAME SEARCH . . . . . . . . . . . . . . . . 13
PROGRAM LIMITATIONS . . . . . . . . . . . . . . . . . 14
ERROR HANDLING . . . . . . . . . . . . . . . . . . . 14
CREDITS
. . . . . . . . . . . . . . . . . . . . . . . 15

Index 17






i


INTRODUCTION

The program author, John J. Newlin, is an active member of the
Association of Shareware Professionals (ASP). The ASP wants to make
sure that the Shareware principle works for you. If you are unable to
resolve a Shareware related problem with an ASP member by contacting the
member directly, ASP may be able to help. The ASP Ombudsman can help you
resolve a dispute or problem with an ASP member, but does not provide
technical support for members' products. Please write to the ASP
Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve
message via EASYPLEX to ASP Ombudsman 70007,3536.

DISCLAIMER

New-Ware hereby disclaims all warranties relating to this product,
whether express or implied, including without limitation any implied
warranties of merchantability or fitness for a particular purpose. New-
Ware cannot and will not be liable for any special, incidental,
consequential, indirect or similar damages due to loss of data or any
other reason, even if New-Ware or an authorized New-Ware agent has been
advised of the possibility of such damages. In no event shall the
liability for any damages ever exceed the price paid for the license to
use software, regardless of the form and/or extent of the claim. The
user of this program bears all risk as to the quality and performance of
the software.

PRODUCT LICENSE

TreeMaster is a Shareware product. As such, it is made available
to the general computing public for evaluation. Users are licensed to
operate TreeMaster on their personal computers for the purpose of test
and evaluation on a trial basis for a limited trial period. It is not
possible to reasonably define any definitive limits of a fair and
equitable time period for evaluation, therefore it is left to the user's
judgment and sense of fair play as to the time required to make a
decision as to its usefulness. If the user decides the program is not
of sufficient merit to warrant purchase through registration with New-
Ware, the program should be removed from their personal computer.
Otherwise, if the program is deemed useful and is in regular use on the
user's personal computer system, registration with New-Ware is required.

Registered users are those users that elect to pay for TreeMaster
and register that payment with New-Ware. By virtue of registration and
payment for the program, registered users are granted a license to
continue to utilize the program on their personal computer for as long
as they choose. This license authorizes the user to use the program on
any personal computer system he or she may own so long as the program is
operated on only one computer system at a time.





- 2 -



PRODUCT REGISTRATION

TreeMaster is sole property of New-Ware Shareware Products. The
Shareware version, and ONLY that version, may be freely copied and
transferred to individual parties for evaluation purposes. The
Shareware version, and ONLY that version, may be posted on Bulletin
Board systems (BBS) for electronic access as long as NO FEE is charged
for its distribution except for private BBS operations that charge a
regular user subscription fee. Computer information services such as
Compuserve (CIS) and Genie, etc., are authorized to post this product
for subscriber access. The Shareware version of TreeMaster may NOT be
distributed on diskette by any disk distributor/vendor that charges more
than $12.00 for the diskette upon which the program and attendant files
are recorded without written consent from New-Ware.

TreeMaster is a fully functional Shareware product. Shareware is a
computer program distribution/marketing method that permits potential
buyers to thoroughly try the program prior to purchase. It is NOT free
and it is not in the Public Domain. If, after evaluating the program,
you find it to be useful enough to use it on a regular basis, you are
expected to pay for it by registering with New-Ware. The registration
fee is $25.00 and the registered version, which is NOT distributed as
Shareware, will not contain the opening Shareware screen nor the closing
messages.

You may register TreeMaster in one of three ways:

1) By mail with check or money order to:

New-Ware
8050 Camino Kiosco
San Diego, CA 92122-1820

2) By telephone with Visa/Mastercard to:

New-Ware
(619) 455-6225

3) Electronically through the New-Ware BBS:

New-Ware Shareware Products BBS
Running Wildcat! version 2.10p

(619) 450-3257 - Node #1 1200/2400/9600 (HST)
455-5226 - Node #2 1200/2400

The New-Ware Shareware Products BBS operates 24 hours per day, 7
days per week. Node #1 is dedicated to registered users only. Nodes #2
is open to all callers. Users registering via the BBS receive access to
the latest registered version within 1 day after leaving their credit



- 3 -



card data. Users who register by mail or phone may also access the
registered version by BBS, but you MUST log on and leave a comment to
the sysop to the effect that you are a registered user and desire
access. The author can also on CIS via PPN 71535,665 (please use
EASYPLEX).

This Shareware version of TreeMaster may be freely copied and
passed on to other individual users for their evaluation. Disk vendors
and/or distributors that desire to distribute TreeMaster must adhere to
the guidelines presented in the file VENDOR.DOC.

Press Alt-R from the opening Shareware screen or the main
TreeMaster display to activate the registration window. Prompts will be
issued for the pertinent information and you will have the option of
printing the registration form when the form is completed. The
Shareware version is completely functional. The only differences
between it and the version a registered user receives is the opening
Shareware screen and the ability to print the registration form.

CALIFORNIA RESIDENTS MUST INCLUDE 7.25% STATE SALES TAX!

I support my software. One of the great strengths of the Shareware
concept is the interaction between the program author and the users.
Many of the features contained in TreeMaster are the result of user
input. If you have a problem evaluating this program or desire to make
a suggestion or comment (or even a complaint), please do not hesitate to
contact me. Even if you register TreeMaster, if you later determine
that it is unsuitable for your use, you may contact me for a refund. It
is not necessary that you be a registered user to contact me for
technical support. Technical support will be available through the U.S
mail, telephone, or the New-Ware BBS.

VERSION HISTORY

1.00 - Released 05-05-90

1.10 - Released 05-08-90
- Minor bug fixes.
- Removed beeps during file search.
- Added directory memo editor.
- Added context sensitive on-line help.
- Added capability to LIST non-executable files.

1.20 - Released 05-11-90
- Complete revision of file browsing. Added full
browsing of sorted file list found through the search
function or in a specific directory.
- Added mouse support.
- Added capability to call ArcMaster.
- Added capability to edit a file with QEDIT.



- 4 -



1.21 - Released 05-15-90
- Improved the speed of the nested (filename/ext) sort
by a factor of 10.
- Added Kim Kokkonen's (TurboPower Software) EMS/Disk
swapping unit for use in calling external programs.
- Added support for calls to the following programs:
> PKZIP/PKUNZIP from PKWare
> VirusSCAN from McAfee
> LZESHELL from Pete Petrakis

1.22 - Released 05-20-90
- Added directory listing of ARC and ZIP files.
- Added LISTing compressed files inside ARC or ZIP
files.
- Added removal of a complete subtree structure.
- Added capability to automatically adjust to monitors
in extended line (above 25 lines) mode.

GENERAL PROGRAM DESCRIPTION

TreeMaster, hereinafter referred to as TM, is a powerful, full-
featured hard disk directory manager. With the advent of DOS 2.0, a
hierarchical directory tree structure was implemented to facilitate the
organization of files. Unfortunately, this tree structure can be very
clumsy to utilize from the DOS prompt level with such commands as CHDIR
and DIR. In fact, there is no intrinsic DOS command that displays the
current directory tree structure. Trying to remember the tree,
especially if it is large, can be a real pain and an even worse pain is
all the typing required to access directories that are more than one
level deep on the tree.

TM is designed to make navigation of a hard disk and its attendant
directory tree structure a snap. TM displays the directory structure as
a graphic tree, twenty directories per page and all the directories are
alphabetically sorted within tree levels of depth. Through the use of a
movable cursor bar and function key commands, the user may accomplish a
great deal of directory management functions quickly and easily. For
example, directories may be added, deleted, purged, or renamed with just
a few keystrokes. And the auxiliary disk information and file windows
keep the user fully informed as to the current status of the directory
organization.

There's much, much more to TM. It is very intuitive and quite easy
to use, but it is recommended that the remainder of this document be
perused before running this excellent utility.








- 5 -



PROGRAM OPERATION

STARTING TM

Starting and running TM is simple. It accepts only one
command line parameter. If started with no parameter, TM will
operate on the currently active drive. If the user desires to
operate on another drive, simply add the drive letter (upper or
lower case, no colon) as a command parameter. For example:

TM d

In this example, TM will load and begin operation on drive D.

As distributed, TM is configured to automatically detect and
utilize either monochrome or color monitors. Some monitors,
however, report themselves as color monitors but do not fully
support the standard color attributes. Laptop computers are
typical of this group. If the display problematic for this reason,
press Ctrl-T to activate the TM configuration window, press the "C"
key to toggle TM to the "Force mono mode", and then save the
configuration to disk. The next time TM is run, it will go into a
monochrome mode, which is much more readable on a laptop monitor.
TM will recognize and adjust to special monitor modes that display
greater than 25 lines per screen such as the EGA/VGA 43/50 line
mode.

TM may be operated from any drive:\directory in a system
providing that the directory in which it resides is identified in
the DOS PATH statement. Please see the file PATHINFO.TXT for an
explanation of how to utilize the DOS PATH capability. To exit
from TM and remain in the directory from which it was loaded, press
the Esc key or press Alt-X. Pressing the Esc key to exit affords
the user the opportunity to confirm the intention to quit the
program.

MAIN TM DISPLAY

The main display of TM is designed to provide the maximum
amount of information without cluttering up the screen. The
graphic tree is contained in a window which occupies the full left
side of the screen. The upper right hand corner of the screen is
occupied by a window that shows information pertinent to the
currently active drive. A window in the lower right hand of the
screen will display up to ten files from the directory that is
currently highlighted by the cursor bar. Each time the cursor is
moved, the file list window is updated. This window also has a
functional use in support of executing programs, which will be
described later.




- 6 -



THE CURSOR BAR

Operation of TM is primarily based upon use of the cursor bar
in a "point-and-shoot" manner. The Up/Down arrows, PgUp/PgDn, and
Home/End keys are used to move the cursor. Pressing the Home key
positions the cursor at the first directory on the tree. The End
key moves the cursor to the last directory on the tree. PgUp and
PgDn can be used to page through a tree that has more than twenty
directories.

Operation of the Up/Down Arrow keys may seem a bit confusing
at first, but most users will eventually appreciate the flexibility
inherent in this design. In the default cursor movement mode,
these keys move the cursor up and down one directory at a time,
regardless of level. The Tab key is used to toggle the movement
mode. Thus the Up/Down arrow keys can be set to move up and down
one directory at a time regardless of level or can be set to move
up and down at the same level only. Regardless of the current
setting, the Right Arrow key will always move the cursor down to
the next directory regardless of level and the Left Arrow key will
always move the cursor up in the same manner.

As the cursor bar is moved, TM performs several ancillary
functions. One of these functions is to display a subset of the
files (10 files at a time) found in the directory currently
highlighted by the cursor bar. Up to 10 files (first 10 found by
DOS) can be displayed in the file list window, which is located in
the bottom right portion of the main TM display. A major function
of the cursor bar is to facilitate changing the active directory.
All the user need do is position the cursor over the desired
directory and press the ENTER key. When this occurs, TM will
change to the target directory and terminate, leaving the user in
the new directory.

MOUSE SUPPORT

TM will automatically detect the presence of a system mouse
drive and activate the mouse if one is present. The directory tree
cursor bar can be moved by moving the mouse up and down or right
and left. The mouse left button emulates the Enter Key, the right
button emulates the Esc Key, and pressing both left and right
buttons together calls help. The mouse is not active while in the
directory memo editor.

FUNCTION KEY COMMANDS

The majority of functions provided by TM can be accessed via
one of the ten function keys.

F1 - On-line Help



- 7 -



F2 - Directory Data Display
F3 - Change Drive
F4 - Remove Subtree
F5 - Search for File
F6 - Rename Directory
F7 - Edit Directory Memo
F8 - Toggle File List ON/OFF
F9 - Browse Files in Directory
F10 - Configure TM

Each of these functions will be explained in greater detail in the
following subsections.

F-1 KEY

The F-1 Key is used to access the on-line context
sensitive help system incorporated into TM. When pressed
while the tree cursor is active, the main help index will be
displayed. If pressed while in any other TM function, help
for the active function is displayed. The Alt-F1 key can be
used to return to the last help topic displayed while in the
help system. Mouse users may press the LEFT and RIGHT mouse
buttons to invoke the help function.

F-2 KEY

The F-2 key activates a window that contains much
interesting information about the contents of the directory
currently under the cursor bar. This drive information
display will show the total number of files, number of files
with hidden/read-only/system attributes, the largest and
smallest files, the oldest and newest files, and other
information.

F-3 KEY

The F-3 key is used to change drives. Any valid drive in
the system may be accessed by simply pressing the letter key
that corresponds to the DOS drive letter. If the selected
drive is not valid or the drive is not ready, an error message
will appear in an error window.

F-4 KEY

TM has the capability to remove a complete subtree
structure. When the F4 Key is pressed, TM will display a
window that will issue TWO confirmation prompts before
proceeding to remove ALL subdirectories and ALL files therein
from the subtree attached to the directory under the cursor
bar when F4 was pressed. Use this feature with CAUTION. It



- 8 -



will remove ALL files in each subdirectory to be removed,
including those marked as read-only, system, or hidden.

F-5 KEY

TM provides a very rapid file search of the entire active
drive for a specified file name. To search for a file, press
the F-5 key and then enter the file name as prompted for in
the file search window that will appear. DOS wild cards ("*"
and "?") are permitted. TM will gather all files found on the
current drive that match the entered file specification and
present the list in the file browse mode. Using the global
mask "*.*" permits browsing all files on the current drive.
See the File Browse Mode section for further details.

F-6 KEY

TM makes it very easy to rename a directory. Pressing
the F-6 key will activate a window that will prompt for the
new name of the directory under the cursor bar. Any legal DOS
directory name may be entered. This includes names that
contain a period, as in LONGNAME.DAT. If the entered name is
the same as the name of a directory at the same level, an
error window will appear, otherwise the directory will be
renamed. The graphic tree is resorted after the renaming of a
directory.

F-7 KEY

TM supports maintenance of a small ASCII text memo file
for each directory. The memo file serves to provide the user
with a means of keeping comments or other data pertinent to
specific directories. To edit or create a memo file, press
the F7 key. A window will appear that supports a full-
featured text editor. Up to 12 lines, 40 characters each, may
be entered into the text buffer. Standard WordStar style
commands are employed while in the buffer. A status line at
the top of the editor window shows column number, line number,
Insert key status, and percent of buffer space used. Press F1
while in the editor for a list of basic editor commands.

To save the memo, press F10 when entry of the desired
information is complete. A file named DIRMEMO.TM will be
created in the directory highlighted by the tree cursor when
F7 was pressed. Press Esc to exit the editor without creating
or updating the file. If a file named DIRMEMO.TM exists in
the directory under the cursor bar when F7 is pressed, TM will
read that file into the buffer for examination and editing.
Note that the mouse is not active while the memo editor is
active.



- 9 -



F-8 KEY

TM will normally display the first 10 files found in each
directory as the cursor bar is moved through the tree. This
slows down the cursor movement a bit due to the requirement to
access the disk, especially on slower drives. Pressing F-8
Key toggles this feature on and off. When toggled off, TM
does not access the disk to get the first 10 files and the
message "File List Disabled" appears at the top of the file
list window. The file list will automatically turned on
during a file search if the target file is found and the user
elects to stop the search normally.

F-9 KEY

The F-9 key is used to browse all files in the directory
under the tree cursor bar that match the current file mask.
The file mask can be changed with the Ctrl-M command. See the
File Browse Mode section for further details.

F-10 KEY

Pressing the F-10 key brings up a sliding bar menu that
permits configuring TM. Pressing the Enter Key will alter the
setting of the item under the cursor bar. If Quit and Save is
selected, TM will save the configuration file TMCONFIG.BIN to
the directory that TM.EXE resides in providing that this
directory is on the DOS PATH. If it is not, TM will save
TMCONFIG.BIN to the current directory. When TM loads and
executes, it searches the DOS path for TMCONFIG.BIN and reads
it if TMCONFIG.BIN is found on the DOS PATH. Therefore, a
copy of TMCONFIG.BIN must reside in a directory that is on the
PATH in order for the saved configuration to be active when TM
starts.

OTHER TM COMMANDS

TM provides other important functions through command
keys as described below.

INS KEY

The Ins key is used to invoke the add directory function
that adds a directory to the current drive. A window will
appear that prompts for the name of the directory to be
created. It is important to note the position of the tree
cursor bar when invoking this function. If it is desired to
add the directory to the root directory, type a DOS backslash
character ("\") as the first character in the name. For
example, to add a directory named ARCM directly to the root



- 10 -



directory, type in \ARCM and press enter. If however, it is
desired to append a subdirectory to the directory highlighted
by the cursor bar, do NOT precede the entry of the name with
the backslash character. If the entered name is valid and if
another directory of the same name at the same level does not
exist, the directory will be created and added to the tree.
Note that the tree is resorted following the addition of a
directory.

DEL KEY

Directories may be removed in TM by pressing the Del key
with the cursor bar over the target directory. The remove
directory function will remove the directory from the drive
and from the tree. Remember, the directory must not contain
any files or subdirectories
or an error will occur. The target directory will be removed
from the drive and from the tree if the action is successful.

CTRL-END KEY

TM provides a fast, powerful method of cleaning up hard
disks through the directory purge function. The entire
contents of a directory may be purged by pressing the Ctrl-End
key combination. Not to worry, the user must confirm TWICE
before the action actually takes place and it is not possible
to purge the root directory while in TM. A user might do a
lot of damage through negligent use of this function, so BE
CAREFUL! Press the Ctrl-End key combination with the tree
cursor bar highlighting the target directory. A window will
appear that will issue two separate prompts for user
confirmation of the purging action. Please note that when TM
cleans out a directory, it takes with it ALL files, regardless
of attribute. This means that hidden, read-only, system files
et al will be deleted. After the purging action, a message
informing the user of success or failure will appear.
Directories containing subdirectories may be purged without
effecting the child subdirectories or their contents.

CTRL-HOME KEY

Normally, changing directories is effected by moving the
cursor bar to the target directory and pressing return. But
the root directory does not appear on the tree. To change to
the root directory, press the Ctrl-Home key.








- 11 -



TAB KEY

Pressing the Tab key toggles the functionality of the
up/down arrow keys as pertains to the movement of the cursor
bar from level to level.

CTRL-M KEY

As distributed, TM uses a file mask of "*.*" (all files)
for retrieving file names from DOS for display in the file
list window. This default can be changed through the use of
the Ctrl-M command. A window will appear that prompts for
entry of the new file mask. Any valid DOS file mask may be
entered. After the mask is changed, only those files matching
the file mask will be displayed in the file list window.
Please note that the total file value that appears on the
window header will still show the total number of "*.*" files
in that directory. Also note that the current file mask
setting will be saved to disk along with the other
configurable items when the user elects to reconfigure TM.

CTRL-P KEY

A printout of the entire tree structure is available via
the Ctrl-P Key. Please note that if the attached printer does
not support IBM line drawing characters, the resultant
printout will appear rather garbled. A warning will be
issured if TM detects that the printer is not ready. This
warning can be bypassed in those cases where the not ready
indication is false.

CTRL-R KEY

The Ctrl-R Key is only active in the Shareware
distribution version of TM. When pressed, Ctrl-R will cause a

window to appear that prompts the user for Registration
information. When the form is complete, the user has the
option of printing the form for mailing to New-Ware.

CTRL-S KEY

In consonance with the design employed in ArcMaster and
SCOUT, TM employs a directory catalog strategy. This strategy
entails the storage of directory tree information in a small
file named NEW-WARE.LOG in the root directory of each drive
accessed. Using this strategy greatly speeds up operation of
the program because it is not necessary to scan the entire
disk through DOS each time a drive is accessed. The only
drawbacks to this strategy are minor and are far outweighed by
the increased performance. If a directory is created,



- 12 -



renamed, or removed other than by TM, ArcMaster, or SCOUT, it
will be necessary to re-scan the drive to update the catalog.
This is accomplished by pressing the Ctrl-S. Catalog
maintenance by TM is mostly automatic and re-scanning should
be a rare necessity.

FILE BROWSE MODE

The TM file browse mode is active when either the file search (F5
Key) or the directory browse (F9 key) functions are activated. Files
are displayed in two columns of 21 files per column. All files matching
the user-provided file specification will be listed and a movable cursor
bar is available to browse through the file list. Up/Down arrow,
PgUp/PgDn, Home/End, Ctrl-PgUp/Ctrl-PgDn keys are can be used to move
through the list. Files can be sorted in any one of five ways and the
sort may be changed at any time while in the browse mode. The Tab Key
is used to toggle the direction of the sort to ascending or descending.
The F1 key provides information on all the commands available while in
the browse mode. Individual files may be LISTed, EDITed, SCANed, or
executed from the browse mode. In addition, ArcMaster may be called and
passed the file name under the cursor bar.

TM provides a fast, easy method of finding a file name while in the
browse mode. Pressing any key associated with a legal DOS file name
character will cause TM to search the entire browse list for a file name
beginning with that character. If it finds one, the cursor will jump to
that file name and the first character typed will appear on line 23 of
the display. TM will continue the search and build the search string
with each character pressed. The backspace key may be used to delete
characters from the string and the string will be cleared any time a
cursor pad key (Down arrow, PgUp, Home, etc.) is pressed. This feature
works best, of course, when the list is sorted by name in ascending
order.

Compressed ARC and ZIP file directories may be viewed while in the
browse mode. To view the contents of an ARC or ZIP file, press ENTER
with the cursor bar over the target file. TM can also call Buerg's LIST
program to view compressed files. Pressing ENTER with the cursor over a
file listed in an ARC or ZIP directory will cause TM to decompress the
file and pass it to list. Note that either ARC.EXE, ARCE.COM, PAK.EXE,
PKUNPAK.EXE, (for .ARC files) or PKUNZIP.EXE (for .ZIP files) must be in
the DOS PATH for this feature to be operable.

DIRECTORY NAME SEARCH

Some users may have a large number of directories in a graphic tree
for a particular drive. TM offers a quick method of moving the cursor
to a desired directory name that might be several display pages down in
the tree. If a character key is pressed, TM will automatically search
through the tree and position the cursor on the directory name whose



- 13 -



first character matches the pressed key. If a second character key is
immediately pressed, TM continues the search by searching for directory
names that match the two characters. Subsequent character key presses
add to the search string and the cursor bar is moved each time a new
match is found. The currently active search string is displayed at the
bottom of the tree. The backspace key can be used to delete characters
from the string. If any key other than an alphabetical character or
legal directory name character key is pressed, the search string is
cleared.

PROGRAM LIMITATIONS

TM is designed to operate on IBM PC/XT/AT/PS2 and compatible
computers. It requires approximately 120K of free RAM at runtime.
Hercules, MDA, CGA, EGA, and VGA monitors are supported.

TM supports up to 500 directories per drive. The total number of
files that can be listed while in the browse mode is limited to 4000.
Since a 20 megabyte disk partition will contain an average of
approximately 1000 files, this limit should be adequate. A warning
message will be displayed if the number of files TM can handle is
exceeded. Please note that if a drive is searched using the global file
specification of "*.*" and the number of files on the drive exceeds
memory capacity, TM will terminate the find function before all files on
the disk are placed on the list. Similarly, in the unlikely event that
TM is used on a drive that contains more than 500 directories, not all
available directories will appear on the tree. Both of these
limitations are quite reasonable and should not hinder the majority of
users from exploiting the power of TreeMaster.

While TM will operate perfectly well on 5 1/4" and 3 1/2" floppy
drives, it is designed for maximum efficiency on a hard drive. Turning
off the file list display (F8) will speed up operations on a slow drive.

The graphic tree printout functions sends IBM line drawing
characters to the printer. Some printers do not directly support these
characters and may substitute non-line characters thus reducing the
quality of the resultant printout.

The width of the window that contains the graphic tree display is
great enough to support at least 5 levels of directories with each
directory name eight characters in length. Directory tree levels
greater than five with extended length names may overrun the right edge
of the display.

ERROR HANDLING

TM incorporates extensive error handling. DOS critical errors such
as "Drive not ready" and "Attempt to write to a write-protected disk"
are trapped and displayed to the user. Any time TM cannot perform a



- 14 -



commanded function it will pop-up a window that informs the user of the
nature of the error. Normal program operation then continues. If a
fatal error occurs that prevents continuation of normal program
operation, a special error window will appear that explains the nature
of the error and then TM will be terminated. Please report fatal errors
to New-Ware.

CREDITS

TM employs special code swapping software developed by Kim Kokkonen
of TurboPower Software. This unit permits TM to swap most of its
resident code to expanded memory (EMS) or to disk when shelling out to
call external programs such as LIST or QEDIT. If sufficient EMS memory
is available for the swap, the swap will be almost instantaneous. If no
EMS is available, the swap will be made to a temporary disk file named
TMSWAP.$$$. In this case there will be a noticeable delay during the
swap, especially if operating on a slow hard disk. It is recommended
that swapping be kept OFF unless adequate EMS memory (350K+) is
available for swapping or a very fast hard disk system is in use.

New-Ware strongly recommends Sammy Mitchell's (Sem-Ware)
outstanding text editor QEDIT. TM supports calling QEDIT to edit files
on the browse list if a copy of QEDIT is named QEDIT.EXE and QEDIT.EXE
resides in a directory that is identified in the DOS PATH.

TM supports LISTing files with Vernon Buerg's famous LIST program.
LIST must be named LIST.COM and reside on the DOS PATH.

TM supports scanning full directories or selected files using John
McAfee's VirusSCAN program. SCAN must be named SCAN.EXE and exist on
the DOS PATH.

TM supports compressing or decompressing selected files using
PKWare's PKZIP and PKUNZIP. These files must be named PKZIP.EXE and
PKUNZIP.EXE and reside on the DOS PATH.

TM supports invocation of Pete Petrakis' free utility, LZESHELL
version 3.0. LZESHELL is the ideal companion for LZEXE, which is a
marvelous utility that compresses .EXE and converted .COM files and
allows them to be executed in compressed form. Be sure to read
LZESHELL.DOC for further information.

TM also supports calling New-Ware's ArcMaster and passing it a
specified file name. ArcMaster must be named AM.EXE and reside on the
DOS PATH.

Portions of this software are taken from Turbo Pascal Express,
Revised by Robert Jourdain and are copyright 1987 by Robert Jourdain.





- 15 -



QEDIT, LIST, PKZIP, and SCAN are all Shareware products. New-Ware
urges that those who use these products register them with their
respective authors.

TurboPower Software provides outstanding support for Turbo Pascal
programmers. New-Ware strongly recommends TurboPower products to all
Pascal users.

Copyright 1990, All Rights Reserved
New-Ware
8050 Camino Kiosco
San Diego, CA 92122-1820
(619) 455-6225









































- 16 -









Index


A F-1 Key 8
add directory 10 F-2 key 8
Alt-F1 key 8 F-5 key 9
Alt-R 4 F-6 key 9
Alt-X 6 F-8 Key 10
ASP 2 F-9 key 10
ASP Ombudsman 2 F4 Key 8
F7 key 9
B file list window 7
backspace key 14 file mask 12
file search 9
C function keys 7
change drive 8
color attributes 6 G
Compuserve 3 Genie 3
Ctrl-End key 11
Ctrl-Home key 11 H
Ctrl-M 12 Home key 7
Ctrl-P Key 12
Ctrl-R Key 12 I
Ctrl-S 13 Ins key 10
Ctrl-T 6
cursor bar 7 L
Left Arrow key 7
D left button 7
Del key 11
directory catalog 12 N
directory purge 11 New-Ware 3
DISCLAIMER 2
DOS PATH 6 P
drive information 8 PATHINFO.TXT 6
PgUp and PgDn 7
E PRODUCT LICENSE 2
End key 7 PROLOG 2
ENTER key 7
errors 14 Q
Esc key 6 Quit and Save 10

F R
F-3 8 re-scan 13
F-10 key 10 register 2



- 17 -



REGISTRATION 3 Shareware version 3
registration fee 3
registration window 4 T
remove directory 11 Tab Key 13
rename a directory 9 Tab key 7, 12
Right Arrow key 7
right button 7 U
Up/Down Arrow 7
S
Shareware 2 V
Shareware Products BBS 3 VENDOR.DOC 4










































- 18 -