home *** CD-ROM | disk | FTP | other *** search
Text File | 1993-03-01 | 41.8 KB | 1,046 lines |
-
-
-
-
- TreeMaster 1.21
-
- Copyright 1990 by New-Ware
-
- All Rights Reserved
-
- (tm) ┌─────────┐
- ┌─────┴───┐ │ MEMBER
- ───│ │ │────────────────
- │ ┌──────┴──┐ │ Association of
- │ │ ├──┘ Shareware
- └──┤ ■ │ Professionals
- ──────│ ║ │───────────────────
- └────╨────┘
-
-
-
-
-
-
-
-
-
- Contents
-
-
- INTRODUCTION . . . . . . . . . . . . . . . . . . . . 2
- PRODUCT REGISTRATION . . . . . . . . . . . . . . . . 3
- VERSION HISTORY . . . . . . . . . . . . . . . . . . . 4
- GENERAL PROGRAM DESCRIPTION . . . . . . . . . . . . . 5
- PROGRAM OPERATION . . . . . . . . . . . . . . . . . . 5
- STARTING TM . . . . . . . . . . . . . . . . . . . 5
- MAIN TM DISPLAY . . . . . . . . . . . . . . . . . 6
- THE CURSOR BAR . . . . . . . . . . . . . . . . . . 6
- 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 . . . . . . . . . . . . . . . . . . . . . 8
- F-6 KEY . . . . . . . . . . . . . . . . . . . . . 8
- F-7 KEY . . . . . . . . . . . . . . . . . . . . . 9
- F-8 KEY . . . . . . . . . . . . . . . . . . . . . 9
- F-9 KEY . . . . . . . . . . . . . . . . . . . . . 9
- F-10 KEY . . . . . . . . . . . . . . . . . . . . . 10
- OTHER TM COMMANDS . . . . . . . . . . . . . . . . 10
- INS KEY . . . . . . . . . . . . . . . . . . . . . 10
- DEL KEY . . . . . . . . . . . . . . . . . . . . . 10
- CTRL-END KEY . . . . . . . . . . . . . . . . . . . 11
- CTRL-HOME KEY . . . . . . . . . . . . . . . . . . 11
- TAB KEY . . . . . . . . . . . . . . . . . . . . . 11
- CTRL-M KEY . . . . . . . . . . . . . . . . . . . . 11
- CTRL-S KEY . . . . . . . . . . . . . . . . . . . . 12
- FILE BROWSE MODE . . . . . . . . . . . . . . . . . . 12
- DIRECTORY NAME SEARCH . . . . . . . . . . . . . . . . 12
- PROGRAM LIMITATIONS . . . . . . . . . . . . . . . . . 13
- ERROR HANDLING . . . . . . . . . . . . . . . . . . . 13
- CREDITS
- . . . . . . . . . . . . . . . . . . . . . . . 14
-
- 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 - Release 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
-
- 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.
-
- 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
-
-
-
-
- - 5 -
-
-
-
- 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 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.
-
- 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
-
-
-
- - 6 -
-
-
-
- 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
- F2 - Directory Data Display
- F3 - Change Drive
- F4 - Print Directory Tree
- 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.
-
-
-
-
-
-
- - 7 -
-
-
-
- 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
-
- A printout of the graphic directory tree can be obtained
- by pressing the F-4 key.
-
- 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. 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
-
-
-
- - 8 -
-
-
-
- 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.
-
- 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.
-
-
-
- - 9 -
-
-
-
- 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
- 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.
-
-
-
-
-
- - 10 -
-
-
-
- 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.
-
- 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.
-
-
-
-
-
-
- - 11 -
-
-
-
- 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,
- 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.
-
- 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
-
-
-
- - 12 -
-
-
-
- the tree. If a character key is pressed, TM will automatically search
- through the tree and position the cursor on the directory name whose
- 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 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"
-
-
-
- - 13 -
-
-
-
- are trapped and displayed to the user. Any time TM cannot perform a
- commanded function it will pop-up a window that informs the user of the
- nature of the error. Normal program operation then continues.
-
- 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.
-
- QEDIT, LIST, PKZIP, and SCAN are all Shareware products. New-Ware
- urges that those who use these products register them with their
- respective authors.
-
-
-
-
- - 14 -
-
-
-
- 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
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 15 -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 16 -
-
-
-
-
-
-
-
-
-
- Index
-
-
- A F-4 key 8
- add directory 10 F-5 key 8
- Alt-F1 key 8 F-6 key 8
- Alt-R 4 F-8 Key 9
- Alt-X 6 F-9 key 9
- ASP 2 F7 key 9
- ASP Ombudsman 2 file list window 7
- file mask 11
- B file search 8
- backspace key 13 function keys 7
-
- C G
- change drive 8 Genie 3
- color attributes 6
- Compuserve 3 H
- Ctrl-End key 11 Home key 6
- Ctrl-Home key 11
- Ctrl-M 11 I
- Ctrl-S 12 Ins key 10
- Ctrl-T 6
- cursor bar 6 L
- Left Arrow key 7
- D left button 7
- Del key 10
- 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 6
- E printout 8
- End key 6 PRODUCT LICENSE 2
- ENTER key 7 PROLOG 2
- errors 13
- Esc key 6 Q
- Quit and Save 10
- F
- F-3 8 R
- F-10 key 10 re-scan 12
- F-1 Key 8 register 2
- F-2 key 8 REGISTRATION 3
-
-
-
- - 17 -
-
-
-
- registration fee 3 T
- registration window 4 Tab Key 12
- remove directory 10 Tab key 6, 11
- rename a directory 8
- Right Arrow key 7 U
- right button 7 Up/Down Arrow 6
-
- S V
- Shareware 2 VENDOR.DOC 4
- Shareware Products BBS 3
- Shareware version 3
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 18 -
-
-
-