Shareware Gold 1/The_Golden_ROM_Series_-_Shareware_Gold_Volume_1_Number_11_-_SK_89-301_-_1989.iso/LIB028/TV.DOC

Text File | 1988-11-12 | 99KB | 2,601 lines

                 Treeview (TM)


           A Hard Disk and File Maintenance Utility









                  Version 1.0




                USERS'  MANUAL












                Magee Enterprises Inc.

                 Post Office Box 1587

                Norcross GA  30091    USA

                 404  446-6611

                   404 446-6650 BBS






          TREEVIEW(TM), A HARD DISK FILE MAINTENANCE UTILITY









ISBN 0-938167-01-4

(C) Copyright 1988 Magee Enterprises, Inc.
All rights reserved worldwide.
A product of the United States of America.


Treeview(TM) is a trademark of Magee Enterprises, Inc. All trademarks
referenced within this document are the property of their respective owners.


MAGEE ENTERPRISES, INC.
POST OFFICE BOX 1587
NORCROSS, GEORGIA 30091  USA


Sales

      404-446-6611         9 AM - 5 PM Eastern Time
      800-662-4330         Orders Only
      404-368-0719         FAX


Technical Support

      404-662-5387         Voice 9 AM - 5 PM Eastern Time
      404-446-6650         BBS (24 Hours/7 Days)
      76004,1541 or 70167,2200     CompuServe



Documentation by Mark Strelecki, Swati Mahajan, Randal DePriest and Marshall
Magee.


This manual was developed using WordPerfect 5.0.



November 1988 Release

                   TABLE OF CONTENTS
Section       Title

License Agreement

1          Introduction
1-1           Features of Treeview
1-2           Documentation Conventions


2          Installation
2-1           System Requirements
2-2           Installing Treeview


3          Getting Started
3-1           Command Line Parameters
3-2           Menu Bar
3-3           The Header Area
3-4           The File Name Area
3-5           The Status Line


4          Important Keys Within Treeview
4-1           Alternate Key Usage
4-2           Control Key Usage
4-3           Function Key Usage
4-4           The Escape Key
4-5           Other Important Keys
4-6           The Mouse
4-6.1           Mice - Generally Speaking
4-6.2           Executing Files With the Mouse
4-6.3           Tagging Files With the Mouse
4-6.4           Scrolling Around With the Mouse
4-6.5           Viewing Files With the Mouse
4-6.6           Dragging the Mouse


5          Elements of Treeview
5-1           The Directory Tree
5-2           Extra File Information
5-2.1           File Sorting
5-3           File Selection Attributes
5-4           Find File Name
5-5           Show-All and Show-Sub Modes
5-6           Subdirectories
5-7           Terminate and Stay Resident Utilities
5-8           Update Target Directory

                   TABLE OF CONTENTS
Section       Title

5-9           Window Commands
5-10           Interrupting Tagged File Operations
5-11           Editing Responses
5-12           External Functions of Treeview
5-13           File Oriented Operations
5-13.1           Copying Files
5-13.2           Renaming and Moving Files
5-13.3           Viewing Files
5-13.4           Editing Files
5-13.5           Resetting File Date and Time


6          Customizing Treeview
6-1           Screen Colors
6-2           DOS Command Macros
6-3           Setting File Limits
6-4           Point-and-Go
6-5           User Defined Keys
6-6           Using EMS Memory
6-7           Video Snow Checking
6-8           Defining the Editor and Viewer
6-9           DOS Volume Labels


7          Shareware Considerations
7-1           What is Shareware?
7-2           How to Register



          APPENDIX A    Treeview Menu Structure


          APPENDIX B    Treeview Help Structure


          APPENDIX C    Treeview Keystroke Commands


          APPENDIX D    DOS Command Macros


          APPENDIX E    Customer Support Information


                Order Form and User Comment Form



                   LICENSE AGREEMENT

The Treeview(tm) Product is NOT "Public Domain" and it is NOT "Freeware".
Treeview is a copyrighted software product developed and owned by Magee
Enterprises, Inc. located in Norcross, Georgia, U. S. A. Magee Enterprises,
Inc. grants you without charge the right to reproduce, distribute and use
copies of this version of our Treeview shareware software product, subject to
the limitations specified below, and on the express condition that you do not
receive any payment, commercial benefit, or other consideration for such
reproduction or distribution, or change this license agreement or the
following copyright notice which appears in the software, documentation, user
interface, menus and magnetic media: (C) Copyright 1988 Magee Enterprises,
Inc. All rights reserved worldwide.

Limitations: You may make and keep one (1)back-up copy of the software for
your personal use, provided that (i) you copy all the copyright, trademark,
and other information indicated on the initial screen display (or on the
diskette label, for the registered version disk) onto your backup diskette
label, and (ii) you have registered. Also you may distribute copies to other
persons, but solely for their evaluation (i.e., to decide whether to continue
using the product and therefore register) and solely for evaluation by such
other persons during that thirty (30) day period. Treeview must NOT be sold or
otherwise provided as part of a larger system, or as a part of a more
inclusive product or service, without express written consent and licensing
from Magee Enterprises, Inc.

The rights to receive any such financial or other benefit, and to modify the
product or employ its components in any kind of derivative work, are reserved
exclusively by Magee Enterprises, Inc. Support from users enables us to
develop additional features and future versions of the Treeview product.
Registered users benefit from enhanced technical support, notice of new
products, and bulletin board access. Contact us at:

Magee Enterprises, Inc.
Post Office Box 1587
Norcross, Georgia 30091 USA
404-446-6611

Also, please feel free to contribute your ideas regarding desired additional
product features and functionality.

THIS PRODUCT IS LICENSED "AS IS" WITHOUT ANY WARRANTY OF MERCHANTABILITY OR
FITNESS FOR A PARTICULAR PURPOSE, PERFORMANCE, OR OTHERWISE; ALL WARRANTIES
ARE EXPRESSLY DISCLAIMED. BY USING THE TREEVIEW PRODUCT, YOU AGREE THAT
NEITHER MAGEE ENTERPRISES, INC. NOR ANY OFFICERS, DIRECTORS, EMPLOYEES,
SHAREHOLDERS, AFFILIATES, OWNERS, OR OTHER RELATED PARTIES WILL BE LIABLE TO
YOU OR ANY THIRD PARTY FOR ANY USE OF (OR INABILITY TO USE) OR PERFORMANCE OF
THIS PRODUCT, OR FOR ANY DAMAGES WHATSOEVER WHETHER BASED ON CONTRACT, TORT OR
OTHERWISE. EVEN IF WE ARE NOTIFIED OF SUCH POSSIBILITY IN ADVANCE. (SOME
STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL
DAMAGES, SO THE FOREGOING LIMITATION MAY NOT APPLY TO YOU.)

You may not reverse-engineer, disassemble, modify, decompile or create
derivative works of the product. You acknowledge that the product includes
certain trade secrets and confidential information, all of which is the
copyrighted intellectual property of Magee Enterprises, Inc. Treeview is a
trademark of Magee Enterprises Inc. and the Magee Enterprises logo is a
trademark of Magee Enterprises, Inc. All rights are reserved worldwide. IBM,
PS/2 and Personal System/2 are registered trademarks of IBM Corporation.

RESTRICTED RIGHTS LEGEND

Use, duplication or disclosure by the Government is subject to restrictions as
set forth in sub paragraph (c) (1) (ii) of the Rights in Technical Data and
Computer Software clause of DFARS 252.227-7013. Magee Enterprises, Inc., Post
Office Box 1587, Norcross, Georgia 30091 USA.


























SECTION 1

INTRODUCTION

Thank you for your interest in Treeview! Treeview(TM) is a hard disk and file
maintenance utility for IBM (TM) Personal Computers, Personal System/2 (TM),
and other PC compatible computers.

Treeview gives you simple, straightforward commands to accomplish everyday
operations such as copying files, renaming or erasing files, backing up files,
and much more. Treeview removes the guesswork from file maintenance tasks by
displaying the files on your disk in a tabular format that is continually
updated in response to your changes. Treeview speeds up time consuming disk
cleanup and maintenance sessions.

Treeview is a powerful hard disk and file maintenance utility system. It gives
you the ability to execute DOS commands, but it does not pretend to be a full
featured DOS shell that simplifies (and sometimes hinders) all DOS functions.
Treeview is NOT a memory resident program that can be called up via "hot"
keys. Both of these constraints were designed into Treeview to keep it as
direct and unencumbering as possible.

You'll find that Treeview is most useful on computer systems that have a hard
disk for data storage. Treeview works just fine on floppy disk based systems,
but the file maintenance needs of floppy only systems are not as great as hard
disk systems. Few people have multiple directories and hundreds or thousands
of files on floppy disk systems.

This document describes the installation and usage of Treeview version 1.0.
The document describes many features and functions of the program. Once you
begin using Treeview, you'll discover more about how it works from the on-line
help facility and by experimenting with the various commands.

1-1 Features of Treeview

In addition to the standard file and disk maintenance functions (copy, rename,
erase, etc.), Treeview has many other useful features including:

* Supports from 1 to 6 windows allowing as many as 6 disks (or directories) to
be displayed at the same time.

* A directory tree display that shows your disk's directory structure in an
easy-to-understand graphical layout.

* A "Show-All" and "Show-Sub" display function that allow all files on the
current disk or under the current directory to be accessed as if they were in
one directory.




* A File viewing function that displays files as ascii text or in hexadecimal
format, and permits the use of any listing or editing program at the user's
option.

* A full screen interface with user selectable colors.

* On-line menu-driven help available whenever Treeview is waiting for user
input.

* DOS Command Line Macros that give the user the ability to access complete
file and pathnames by using just one or two characters

* Full mouse support

1-2 Documentation Conventions

Throughout this document, references to Treeview menu selections are
surrounded by brackets ([ ]) and have vertical bars (|) separating entries
from different menus. For example,

[Other | Setup Parameters | Screen Colors]

represents selecting the "Other" entry from the top level menu, the "Setup
Parameters" entry from the Other submenu, and the "Screen Colors" entry from
the Setup Parameters submenu.


























SECTION 2

INSTALLATION

2-1 System Requirements

Treeview requires an IBM PC, PS/2 or compatible computer with 128K RAM or more
to work properly. In addition, version 2.0 or greater of PC-DOS or MS-DOS is
required.

Treeview is "DESQview aware," meaning it can run in a small window under
Quarterdeck Office Systems' DESQview (TM) multitasking program.

To improve display speed, Treeview normally writes directly to the video
screen memory of your computer. Treeview works well with the IBM Monochrome
Display Adapter (MDA), Color Graphics Adapter (CGA), Enhanced Graphics Adapter
(EGA), Video Graphics Array (VGA), and compatibles. Other video adapters that
can emulate either the MDA or CGA should work properly.

Treeview requires approximately 120K of computer memory to contain the
program's executable code and common data. Additional memory is allocated as
required to contain the file information for each open directory window and a
copy buffer when copying files. The file information memory can either be
allocated in conventional RAM or in LIM/EMS RAM if available on your system.

You can change Treeview's total memory requirements by changing the number of
files allowed per directory window. The largest setting, 2515 files per
window, requires 64K of additional memory (conventional or EMS) per window.
The default value of 1000 files per window requires approximately 26K (32K if
EMS) per window.

Since Treeview is not a memory resident Terminate and Stay Resident (TSR)
program, the memory it uses is only required when you are actually running the
program. The advantage to using EMS memory is to allow any programs executed
from Treeview as much conventional DOS memory as possible for their own
purposes.

2-2 Installing Treeview

Installing Treeview is a very simple process--there are only three files
required to run the program. They are TV.EXE (the program itself), TV.HLP (the
help file), and TV.CFG (the configuration file). The TV.CFG file is optional
in that Treeview will create a new TV.CFG file if it can't locate one when it
starts up.

If your system has a DOS PATH command setup, simply copy these three files
into one of the directories identified in the PATH command. If you have a hard
disk system, but you haven't set up a PATH command, you should read about it
in the DOS manual or get someone knowledgeable to help you set one up.


Optionally, you can copy the TV.CFG and TV.HLP files into a separate
directory, and tell Treeview where they reside by setting the environment
variable TVFILES to the name of the directory. This has an advantage over
using a PATH directory, because only the single TVFILES directory needs to be
searched when accessing the TV.CFG or TV.HLP files. The following command in
the AUTOEXEC.BAT file informs Treeview to look for its files in the directory
C:\TV:

SET TVFILES=C:\TV

When Treeview is started, it tries to read the TV.CFG configuration file. This
file contains the configuration options that you've defined (for example, the
display colors, the User Defined Key values, and the Point-and-Go values). If
the TVFILES environment variable is defined, Treeview expects to find the
TV.CFG file there. If TVFILES isn't defined, Treeview looks in the current
directory; if TV.CFG isn't found there, the directories specified by the PATH
command are searched. If the file still can't be located, a set of default
parameters is used.

Treeview must be able to locate the TV.HLP file when you ask for on-line help.
If TVFILES is defined, Treeview looks for the TV.HLP file in that directory.
If TVFILES isn't defined, Treeview looks in the current directory and then the
directories specified by the PATH command. If the help file still can't be
located, you'll be asked to supply the location of TV.HLP. If you are running
a system with only floppy disks, it's recommended that you copy TV.EXE, TV.CFG
and TV.HLP to your system disk (or disks if you have more than one system
disk). The TV.HLP file is not accessed unless you actually request help, so it
could be left off if you are short on disk space.























SECTION 3

GETTING STARTED

3-1 Command Line Parameters

The usual way to start up Treeview is to simply type TV and press Enter at a
DOS command prompt. However, the following optional parameters can be
specified on the command line to modify Treeview's behavior during a given
run:

       /C or -C  Instructs Treeview to only use conventional memory,
         even if LIM/EMS memory is available and the [Use EMS
         (if available)] option is enabled.

       /E or -E  Allows use of LIM/EMS memory even if [Use EMS (if
         available)] option is disabled.

       /F or -F  Do not perform video snow checking even if the
         [Video Snow Checking] option is set.

       /S or -S  Perform video snow checking even if the [Video Snow
         Checking] option is disabled.

       /M or -M  Indicates that the following parameter is a file name
         mask. See below for an example of a file name mask.

       /4 or -4  Uses EGA 43/VGA 50 line mode if available


The Treeview command line can contain the name of the initial directory to
display when Treeview is started. The following command:

                 TV C:\LETTERS

starts Treeview with the directory C:\LETTERS displayed, regardless of what
the current directory was when the command was entered. Specifying a directory
name on the command line is equivalent to starting Treeview without a
directory name, and then using the Alt-L or [Dir | Login New Directory]
command to switch to the desired directory.

A file name mask to display specific file names can also be entered on the
command line, but only immediately after a /M parameter. Supplying a file name
mask on the command line works just as if the mask was specified with the
[Other | Selection Criteria | File Name Mask] command. For example, the
command line:

                  TV /M *.DBF

invokes Treeview and tells it to only display files that have an extension of
.DBF
The file name mask must follow the /M parameter on the command line.  Several
parameters can be entered on the same command line. For example:

                 TV/S/C/M *.COM D:\BIN

starts Treeview with video snow checking enabled (/S), EMS usage disabled
(/C), and only files with the extension .COM in the directory D:\BIN
displayed.

Refer to the topics USING LIM/EMS MEMORY and VIDEO SNOW CHECKING for more
information on EMS memory and video snow checking.

You can access Treeview's on-line help any time it is waiting for input by
pressing the F1 function key.

There are four areas on the main file display; the menu bar, the header area,
the file name area, and the status line. The contents and usage of the
different screen areas are described below.

3-2 Menu Bar

The menu bar across the top line of the screen shows the top level functions
which Treeview can perform. You select a function from the menu bar by
pressing the key that is the first letter of the desired function. Depending
on your computer's video equipment and your video attribute/color setup, the
first letter of the menu bar choices may be displayed in a different color or
otherwise highlighted to make them stand out visually.

In most cases, selecting a function from the menu bar results in a "pull-down"
submenu being opened. Submenus are a set of choices that appear in a box under
the corresponding top level option. You select a submenu entry by either
pressing the key that is highlighted in the submenu entry (not always the
first letter), or by using the up and down arrow keys to highlight the desired
entry and then pressing Enter. The Esc key can be used to exit a submenu
without selecting any of the choices.

Please refer to the APPENDIX A for a "map" of the keystrokes to navigate the
commands available within Treeview's menu bar.

In addition to the menus, many of Treeview's most common functions can be
performed by the function and control keys and Alt key combinations. Function,
control and Alt key usage is described in the Section 4, Appendix A, and in
Treeview's on-line help.








Here is an example showing the menu bar and an open submenu (in this case, the
Files submenu). When displayed on your computer's screen, actual graphics
characters are used, making a much nicer display.


     Dir  Files  Help  Other  Sort  Tag/Untag  Windows    Xecute    Quit
     ----+-----------------------------+-----------------------------
     |  Set File Attributes        |
     |  Copy File(s)           |
     |  Set File Date/Time           |
     |  Erase File(s)           |
     |  Extra File Info     Alt-I |
     |  Rename/Move File(s)        |
     |  View File         Alt-V |
     |  Xecute File      Alt-X |
     +-----------------------------+

3-3 The Header Area

The header area at the top of the screen contains information about the
current disk drive, the current directory, and Treeview options.

The header section entitled "Volume" displays the volume label of the current
disk, the total storage capacity of the disk in bytes, and the size of the
remaining free space on the disk, also in bytes. If the current disk does not
have a volume label, the label area is blank.

The header section entitled "Path" normally displays the complete pathname of
the current disk drive and directory. In either the show-all or show-sub
modes, the Path area displays the pathname of the current file.

The header section labeled "Files" displays the number of files listed in the
file name area, the total size of those files in bytes, the number of files
tagged for group operations, and the size of tagged files in bytes.

The final header section, "Selection", displays the selection criteria used to
pick which files are displayed in the file name area. More information on the
Selection area is provided in the QUICK REFERENCE section.

Following is an example of the header area, edited to fit on this page.


     + Volume -+- Path -----------------------------------------------+
     |AUTOMENU | C:\COMM                          |
     |           +------+- Files ----------------------+- Selection ----+
     | 21309440 TOTAL | SELECTED: 7 FILES  768 BYTES | MSK:          |
     | 11669504 FREE  | TAGGED:   0 FILES    0 BYTES | ATR: N . . . A |
     +----------------+------------------------------+----------------+


3-4 The File Name Area

The file name area usually displays a sorted list of the file names in the
current directory. If there are more file names to be shown than will fit on
the screen at one time, you can use the arrow keys or the PgUp, PgDn, Home,
and End keys to display the other file names.

You can select the manner in which the files are sorted for display with the
[Sort] command, and you can specify that they be sorted by Name, Extension,
Date, Size, or Unsorted, in Ascending or Descending order. More details on
using the [Sort] command are in Section 5 as well as Appendix A.

Many of the Treeview commands operate on the current file. The current file is
identified by being the only highlighted name in the file name area. The four
arrow keys and the PgUp, PgDn, Home, and End keys can be used to select a
different current file. The highlighted bar over the file name is sometimes
called the current file pointer or just the file pointer.

The file name area can be split into multiple windows to display different
disk drives and/or directories on the screen at the same time. Only one window
is current at a time (sometimes called the current window).

3-5 The Status Line

The status line appears along the bottom line of your computer's screen. It is
divided into three segments. The first segment tells you what Treeview is
doing and when it is ready for your input. The second segment simply reminds
you that you can press the F1 function key for on-line help. The third segment
shows whether or not the DOS verify mode is set on or off.
Following is an edited example of the file name area (with two file windows
displayed) and the status line.


+| C:\ |--------------------------------------------------------+
|  AUTO\      BRATEMM.SYS     JDISK.SYS    QEXT.SYS    |
|  AUTOMENU.COM   DV\         LIB\        SRC\        |
|  BATCH\      DV.BAT     MOUSE.SYS    WRITE\        |<-- File
|  BIN\       COMM\      FC\                |    Window
|  BRATDISK.COM   COMMAND.COM     GRAPHIC\            |    #1
+| C:\SRC\TV |--------------------------------------------------+
|  CVTHLP.C      GRAPHIC.H     MVFMOVE.C    MVVBUF.C    |
|  CVTHLP.EXE      KEYS.H     MVFMOVE.FUN    MVVIEW.BAK    |
|  DATE.ASM      LOGO.ASM     MVFUN.BAK    MVVIEW.C    |<-- File
|  DIALOG.C      LOGO.BAK     MVFUN.H    MVWIN.C     |    Window
|  DIALOG.H      MENU.C     MVHELP.BAK    PATHNAME.C    |    #2
+---------------------------------------------------------------+
+| Ready!         |    Press F1 for Help  | Verify: OFF       |+<-- Status
+---------------------------------------------------------------+    Line

3-6 The Help System

Treeview has an extensive on-line help system available at the press of the
"H" key. Help is broken up into six major areas:

Treeview Commands

Input (Keyboard and Mouse)

Treeview Menus

Program Parameters

Registering Treeview

Treeview Screens

Within the [Help | Commands] option, further help is available on these
subjects: Directories, Files, Viewing and Executing files, and Sorting and
Tagging files. Help is also given on customizing Treeview's screen colors,
default settings, user defined keys, "Point-and-Go" keys, Video options and
more. Please refer to Appendix B for a more detailed "map" of the entire
Treeview help system.




























SECTION 4

IMPORTANT KEYS WITHIN TREEVIEW

The on-line help facility should be used to supplement the information
presented in this section. You can get help any time the program is waiting
for input by hitting the F1 key.

4-1 ALT Key Usage

Treeview has a number of Alt-key combinations that are shortcuts to many of
the most common functions. Entering one of the following Alt-key combinations
executes the corresponding menu entry, without traveling through the menus.
Menu entries that have Alt-key shortcuts will display the shortcut at the
right edge of the menu line. Alt-key combinations are performed by pressing
and holding down the ALTernate key while tapping the second key, the releasing
the alternate key. For example, "Alt-A" means to hold the ALT key down and tap
the "A" key, then release the ALT key. Some of these special key combinations
available within Treeview are as follows:

Alt-A    Files | Set File Attributes | Current File
Alt-B    Files | Set File Attributes | Tagged Files

Alt-C    Files | Copy file(s) | Current File
Alt-K    Files | Copy file(s) | Tagged Files

Alt-F    Files | Edit File

Alt-E    Files | Erase file(s) | Current File
Alt-Y    Files | Erase file(s) | Tagged Files

Alt-R    Files | Rename/Move File(s) | Current File
Alt-M    Files | Rename/Move File(s) | Tagged Files

Alt-I    Files | Extra File Information
Alt-V    Files | View File

Alt-G    Dir | Login New Drive
Alt-L    Dir | Login New Directory
Alt-N    Dir | Reread Current Directory
Alt-T    Dir | Show Dir Tree

Alt-S    Other | Setup Parameters
Alt-P    Other | Setup Parameters | Point and Go Setup
Alt-U    Other | Setup Parameters | User Defined Keys

Alt-D    Xecute | DOS Command
Alt-X    Xecute | Current File

Alt-Q    Quit

4-2 Control Key Usage

Treeview allows several Control-key combinations to be used in addition to the
arrow and keypad keys. The Control-keys add a WordStar (TM) like interface to
Treeview. The sequence ^R means to hold down the Ctrl key and simultaneously
press the 'R' key.

^R     - Same as PgUp           ^G      - Same as Del
^C     - Same as PgDn           ^V      - Same as Ins
                   ^H      - Same as backspace
^W, ^E - Same as up arrow       ^M      - Same as Enter
^Z, ^X - Same as down arrow
                   ^T      - Tag/untag current
^A, ^S - Same as left arrow            file
^D, ^F - Same as right arrow


4-3 Function Key Usage

Treeview uses the function keys on the keyboard to execute several common
functions with a single key. The function key usage is:

F1  - Get Help
F2  - Tag/Untag the current file (toggles current tag state)

F3  - Login to the parent directory
F4  - Login to the subdirectory under the file pointer

F5  - Goto the next tagged file (next find in VIEW)
F6  - Goto the previous tagged file (prev find in VIEW)

F7  - Open another file name display window
F8  - Close the current file name display window

F9  - Goto the next file name display window
F10 - Goto the previous file name display window

The Alt-Fn, Shift-Fn and Ctrl-Fn (function key) combinations are called User
Defined Keys and are described in the topic of the same name.

4-4 The ESC Key

The Esc key quits or aborts whatever operation Treeview is currently
performing. The exact effect of pressing Esc depends on the operation being
performed.

At the highest level, the Esc key returns to the normal file name display from
viewing a file, viewing the directory tree, setting color selections, and the
on-line help facility.

Many of Treeview's submenus do not have a selection to quit or exit without
performing a function. The Esc key does this by closing the last opened
submenu. When multiple submenus are open, they can be closed in reverse order
by pressing Esc once for each submenu.

The Esc key also escapes from most pop-up window prompts. For example,
selecting the [Dir | Login New Directory] command pops up a window asking
which directory to log in. If you decide not to switch to another directory,
just press the Esc key and the window will disappear.

4-5 Other Important Keys

While Treeview's file windows are displayed, you may press the grey "plus" or
"minus" keys to tag and untag files. These keys are the same as the F2
function key, which tag and untag files each time you press them. This is
known as a "toggle" switch, because each time you press the key, the other
action is performed. Pressing a toggle key once will tag the file currently
highlighted, and pressing it again will untag it.

When using the grey plus and minus keys, you will notice that after tagging or
untagging a file, the highlight bar moves down to the next filename in the
display window. If you have your files sorted in the proper order, you will be
able to mark an entire block of filenames simply by repeatedly depressing the
grey plus key. Please note that the F2 key works in the same way - after you
press it, the highlight bar will move down one file.

The equals key is also very important in Treeview. Whenever you press the
equals key, followed by a letter or number, Treeview will immediately move the
highlight bar to the first occurrence of a filename that matches that letter
or number. More details on the "file find" feature of Treeview can be found in
section 5-4.

4-6 The Mouse

Here is a summary of the mouse capabilities built into Treeview:

4-6.1 Mice - Generally Speaking

Generally speaking, the left mouse button selects an operation while the right
button cancels or quits the operation in progress, but there are exceptions.

4-6.2 Executing Files With the Mouse

While the main file window is shown on the screen, the mouse can select a file
by pressing the left button while pointing at it. A rapid double-click of the
left mouse button will attempt to execute the file being pointed at (same as
Alt-X). If the file does not have an extension of .COM, .EXE, or .BAT,
Treeview will check to see if a point-and-go key has been set up and attempt
to perform that action on the file. If none of these are true, the file will
be viewed.

While looking at the directory tree, a single click of the left mouse button
will move the highlight bar to that directory. A rapid double-click on that
entry will log in to that directory (same as using the cursor keys to
highlight a directory and then pressing enter to log into it).

When multiple file windows are open, clicking the left mouse button on any
file in a window will make that window the current one and also highlight the
file.

4-6.3 Tagging Files With the Mouse

To tag a file, point at the file desired and press the right mouse button. To
untag a file, point to it and press the right mouse button again.

4-6.4 Scrolling Around With the Mouse

In each file window that is open, and when looking at the directory tree
screen, you will notice a set of four arrows in the upper right corner.
Clicking the left mouse button on one of these arrows will move the file or
directory pointer in the indicated direction, similar to pressing the
corresponding cursor control key.

4-6.5 Viewing Files With the Mouse

While viewing a file, the left mouse button can be used to select any of the
commands on the menu bar. The Up and Down, Left and Right commands are
implemented by pointing at them and pressing the right mouse button. You can
also point at these commands and depress and hold down the mouse button to
repeat the same command more rapidly. For instance, while viewing a file, you
can point at the Down command on the menu bar and hold down the left mouse
button to effectively "scroll" down through your document. Similarly, by
pointing at the Up command and holding down the left mouse button, you can
scroll upward through your file.

4-6.6 Dragging the Mouse

Another concept of the mouse is one called "dragging", and it is usually done
by holding down a mouse button while moving the mouse. In Treeview, you can
select a series of files from a window simply by holding down the right mouse
button while slowly moving your mouse over the files to be tagged. The mouse's
location is updated by the program approximately every one-ninth of a second,
so you can't move too quickly.

Using a mouse with Treeview is not mandatory, but it can simplify moving
around and selecting files to operate on. A mouse is a more "friendly" way of
dealing with the drop down menus and pop-up windows that Treeview provides,
and while there is a keyboard equivalent of almost all mouse operations, we
feel that using a "rodent" can definitely help the learning curve of any
program.


SECTION 5

ELEMENTS OF TREEVIEW

Treeview is a hard disk file maintenance utility. Its strengths lie in its
ability to copy files, move files, rename files, delete files, change file
attributes, sort filenames, and perform operations on one or more of those
files.

Here in Section 5 we will discuss what Treeview is and exactly what it does.
First, we will discuss the most important feature of Treeview: the ability to
display a graphic directory "tree" of the files on your system.

5-1 The Directory Tree

When the directory tree is displayed by Alt-T or the [Dir | Show Dir Tree]
command, a graphic tree somewhat like the following is shown:

      C:\ ---------+ AUTO
               + CATDISK
               + COMM --------+ AQUARIUS
               |          + MERCURY
               + GRAPHIC -----+ DRAW
               |          + PAINT
               + INCLUDE -----+ SYS
               + MAGEE -------+ AUTOMENU
               + SRC ---------+ TV
               + WRITE -------+ ARTICLES
                      + WS


The tree represents the structure of the directories on the current disk
drive. Each column to the right indicates another subdirectory. The
directories described by the tree above are:


     C:\
      C:\AUTO
      C:\CATDISK
      C:\COMM
           C:\COMM\AQUARIUS
           C:\COMM\MERCURY
      C:\GRAPHIC
           C:\GRAPHIC\DRAW
           C:\GRAPHIC\PAINT

      ...and so on.




The current directory is shown under a highlighted bar (called the directory
pointer). You can switch to another directory by using the up, down, right,
left arrow keys to highlight the new directory. In addition, the Home key
moves to the top level or "root" directory and the End key moves to the lowest
rightmost directory. Treeview does not actually switch (or "login") to the new
directory until you press the Enter key or select the [Login] option from the
directory tree menu bar.

As you move the directory pointer around the tree, the currently logged in
directory remains displayed in a different color/video attribute. This is the
directory to which Treeview returns if you press the Esc key or select the
[Quit] option from the directory tree menu bar, regardless of the directory
pointer location.

With the directory tree [Write] command, you can save the directory tree
information in a single disk file (named TV.DIR in the top level directory of
the current disk). When you bring up the directory tree display, Treeview
checks for this disk file--if it exists, the directory tree information is
read from the file instead of searching the disk for directories. This results
in a much faster tree display.

If you change your disk's directory structure outside of Treeview, you can
force a rescan the entire disk for directories (instead of just reading the
TV.DIR file) by using the directory tree [New] command. This informs Treeview
of the changes you've made to directories since the last time the disk was
scanned.

The directory tree [Mkdir] command (similar to the DOS command of the same
name) "makes" a new subdirectory "under" the directory pointer. For example,
if you select the [Mkdir] command while the directory pointer is on the
directory C:\123\SALES, and you enter "JOURNAL" as the new subdirectory name,
Treeview creates the directory C:\123\SALES\JOURNAL. New directories created
by [Mkdir] immediately appear in the graphic tree display.

The directory tree [Rmdir] command (also similar to the DOS command of the
same name) deletes or "removes" the subdirectory under the directory pointer.
Selecting [Rmdir] when the directory pointer was on the directory
D:\FORMS\LETTERS\SUPPORT will delete the SUPPORT directory, provided the
following conditions are meet:

- You can't delete the directory you're currently logged in to
  (the current directory).

- You can't delete the top level (root) directory of a disk.

- You can't delete a directory that contains any files and/or
  other directories. If you want to delete a directory that
  contains files, delete the files first using the [Files |
  Erase File(s)] command.

There are two directory tree options that are useful in conjunction with the
[Write] command. Both options are related to writing the directory tree file
to disk whenever changes are made in the disk's directory structure. Keeping
the file synchronized with the actual directory structure is important since
Treeview does not scan the disk for directories if the TV.DIR file exits
(unless you use the [New] command as noted above).

The first option, [Other | Setup Parameters | Directory Tree Options | Select
Drives to Always Write] allows you to specify a set of disk drives which are
to automatically have the TV.DIR file rewritten whenever you exit the
directory tree and there were directories created or deleted. A useful
application of this option is to specify all your computer's hard disks. The
drives should be specified as single letters, with or without colons (:) and
spaces.

The second option, [Other | Setup Parameters | Directory Tree Options | Prompt
to Write when changes] causes Treeview to ask you if the TV.DIR file should be
written when changes have been made in the directory structure. This option is
useful when you may or may not want to write to the disk.

If neither option is specified, Treeview does not write the directory tree
file to disk unless you explicitly use the [Write] command to do so.

5-2 Extra File Information

Treeview can display three levels of detail about files stored on disk. The
level of detail displayed is changed with the Alt-I or [Files | Extra File
Info] command.

A default level of detail can be set with the [Other | Setup Parameters |
Startup Defaults | Extra File Info (1 col)] and [ Other | Setup Parameters |
Startup Defaults | Extra File Info (2 col)] options. The lowest level shows
only file names, and is illustrated below:


ANSI.SYS      COMMAND.COM   DRIVER.SYS      JDISK.SYS    QEMM.SYS
AUTOEXEC.BAT  CONFIG.NEW    DUET\      LIB\        RES86.COM
BATCH\          CONFIG.OLD    DV\       MOUSE.SYS    SRC\


At the lowest level of detail, Treeview is able to show five columns of file
names per window. The second level displays full information on each file. In
addition to the file's name; its size, creation or modification date and time,
and attributes are shown. An example of the full file information display is
shown below:


      NAME    USED  ALLOCATED     DATE         TIME     R H S A DIR

ANSI.SYS      4963     6144    7/20/87   1:00:00 pm  . . . .
AUTOEXEC.BAT  1134     2048  11/27/87   8:01:26 pm  . . . .
BATCH\         <DIR>    <DIR>  11/21/87   5:31:52 pm  . . . . DIR
BIN\         <DIR>    <DIR>  11/21/87   5:16:48 pm  . . . . DIR
IBMBIO.COM   16557    18432    7/20/87   1:00:00 pm  R H S .
IBMDOS.COM   28464    28672    7/20/87   1:00:00 pm  R H S .


Each file (except for directories) shows two file sizes, USED and ALLOCATED.
Due to the manner in which DOS stores files on disk, a file often requires
more space than it actually uses. The file size reported in the USED column is
the amount of useful data actually in the file. The size reported in the
ALLOCATED column is the amount of space allocated or reserved for the file.
The allocated (but unused) space is not available for other files to use.

A file's attributes are shown as a single character if the attribute is on, or
a period if the attribute is off (R - Read/Only, H - Hidden, S - System, and A
- Archive). The Directory attribute is shown by the characters DIR.

When full file information is being displayed, only one column of file names
can be shown per window.

The third level of detail displays some, but not all, of the information per
file. The fields shown are: name, file size, and creation or modification date
and time. The allocated size and file attributes are not shown, allowing two
columns of file names to be shown per window. An example is shown below (only
one file per row will fit on the printed page):


ANSI.SYS       4963  7/20/87  1:00p
AUTOEXEC.BAT   1208  3/24/88  1:40p
BATCH\          <DIR>  2/14/88 11:03p


5-2.1 File Sorting

Treeview can sort the files for display in a variety of formats. The choices
you have for sorting files are as follows: by Filename, by extension, by date,
by size, or unsorted. You can also specify ascending or descending order.
Please note that when sorting files for display, no files are actually
relocated, just shown onscreen in the manner you have specified.

One of the benefits to sorting files is to group logically similar ones
together. When sorting by extension, all your batch files (.BAT) will be
listed together, all the program files (.EXE and .COM) and text files (.TXT
and .DOC, for example) will be grouped together, and so on. This would be a
nice way to use Treeview if you needed to know about only a certain type of
file, for example.

If you sort the files by size, the smallest files will be listed first, and
the largest will be listed last because this is considered ascending order. If
you tell Treeview to sort in descending sequence, the large files would be
shown first, followed by successfully smaller files.

Sorting the files by date will display the oldest files first, followed by
newer ones, again because this is ascending order. Unless otherwise selected,
ascending order is used by default when performing sorts within Treeview.

5-3 File Selection Attributes

File Selection Attributes allow you to work with a select group of disk files,
based on the DOS file attributes that the files themselves have. The following
attributes can be used for file selection:

Normal     -  Selects files which have none of the following
        attributes set. This is not really a DOS file
        attribute, but it's useful to treat it as one.

Archive   - Selects files which have the Archive attribute
        set. DOS sets the Archive attribute when a file
        is created or modified.

Dir      - Selects files which are subdirectories.

Hidden      - Selects files which have the Hidden attribute set.

Read/Only - Selects files which have the Read/Only attribute
        set.

System      - Selects files which have the System attribute set.

As distributed, Treeview's default file selection attributes are N (Normal), R
(Read/Only), A (Archive), and D (Dir). This means that only files with normal
attributes (that is no attributes), the Read/Only attribute, the Archive
attribute, or the Directory attribute are displayed.

Selection attributes work by only displaying files that have one or more
matching attributes. A file which does not have any matching attributes is not
displayed. The current file selection attributes are shown in the header
"Selection" area. The displayed attributes are abbreviated to their first
letter.

There are two commands that set file selections attributes; [Other | Selection
Criteria | by Attribute] and [Other | Setup Parameters | Startup Defaults |
Selection Attribs].

The [Other | Selection Criteria | by Attribute] command sets the selection
attributes for the current file name window. This command allows different
windows to be given different selection attributes, thereby displaying
different collections of files. When this command is used, Treeview rereads
the current window's directory (or directories if show-all or show-sub mode is
active) and only displays those files which match the new attributes.

As an example, you can display all modified files on your disk (and only the
modified files) by using [Other | Selection Criteria | by Attribute] to turn
off all attributes except Archive. Then use [Dir | Show All Dirs] to read all
directories on the disk. Only the modified files (those with the Archive
attribute set) will be displayed.

The other selection attribute command, [Other | Setup Parameters | Startup
Defaults | Selection Attribs] sets Treeview's default selection attributes.
These are the initial attributes used every time you start Treeview. Treeview
is distributed with the Hidden and System attributes turned off since files
with these attributes are not typically manipulated by users. If you like to
see every file in any given directory, change the default attributes to
include Hidden and System files.

5-4 Find File Name

The Find File Name command moves the file pointer to the first file name in
the current window that matches the characters you specify. To search for
(find) a given file name in the current window, first press the equals (=)
key. Each character typed after the '=' key further defines the file name to
find. For example, typing '=T' moves the file pointer to the first file in the
window that starts with the letter 'T'. If you then type the letter 'V', the
file pointer will move to the first file name starting with 'TV'.

If you type a character for which there is no matching file name, a beep will
sound and the file pointer will not move. You can change the name to search
for by using the Backspace key, all the way back to the '=' key. The status
line at the bottom of the screen contains the current file name search string
and brief instructions after typing '='.

The Find File Name command can be terminated by the Esc key and most other non
alpha-numeric keys and commands. The sequence =TV Ctrl-T moves the file
pointer to the first file name starting with TV and tags that file.

It's important to realize that the Find File Name command does not search the
disk for a given file, it only searches the list of names in the CURRENT
DIRECTORY WINDOW. If the file name is not in the window, Find File Name will
not find it. To use this command to search for a specific file somewhere on
disk, use it in conjunction with the [Dir | Show All Dirs] command to search
all file names on the disk.

5-5 Show-All and Show-Sub Modes

Normally Treeview displays the contents of a single directory in each file
name window. This mode of operation matches the way most people organize their
data on disk - related files are put together in the same directory. At times
however, it's more convenient to see all the files in a given set of
directories, or even all the files on a disk.

The [Dir | Show All Dirs] and [Dir | Show Sub Dirs] commands do just that.
[Show All Dirs] displays all files on the current disk (called show-all mode)
and the [Show Sub Dirs] command displays all files in the current directory
and any directories under the current directory (called show-sub mode).

The Path section of the header displays the directory name of the current file
so that you can tell in which directory a given file resides when Show-All or
Show-Sub mode is active. As you move the file pointer through the displayed
file names, the Path changes to show the location of the current file.
Normally all file names displayed in a window would be in the same directory,
so the Path section wouldn't change from file to file.

Selecting [Show All Dirs] or [Show Sub Dirs] a second time turns off the
corresponding mode and restores the display of the files in the current
directory.

You can use these commands in conjunction with the selection mask and/or
selection attributes to limit the files displayed. For example, a selection
mask of *.EXE combined with [Show All Dirs] displays all EXE files on the
current disk.

Show-all and show-sub modes are one Treeview's most powerful features. In
these modes, you can work with all the files on the disk (or in a given
directory tree) just as easily as you could with the files in a single
directory.

Some examples of show-all/sub uses are:

1) Erase all the .BAK files on drive C.

- Select all files on drive C [Dir | Show All Dirs].
- Tag all files with the extension .BAK [Tag/Untag | by Name].
- Erase all tagged files [Files | Erase File(s) | Tagged Files
  or Alt-Y].

2) Turn off the Archive attribute of selected files so the DOS
   BACKUP program will not copy them to disk.

- Select all files [Dir | Show All Dirs].
- Tag all modified files [Tag/Untag | Modified].
- Display only the tagged files [Tag/Untag | Select Tagged].
- Untag (F2 key) the files which are to be backed up - leaving
  only modified files not to backed up still tagged.
- Turn off the Archive attribute of the tagged files [Files |
  Set File Attributes | Tagged Files or Alt-B].

5-6 Subdirectories

DOS allows subdirectories to be given names just like any other type of file.
When looking at a list of file names, it's easy to forget which names
represent files and which names are actually subdirectories. To make the
distinction clear, Treeview displays directory names with a backslash
character (\) following the name. The following list shows several file and
directory names as they would be displayed by Treeview:

ANSI.SYS      COMMAND.COM   DRIVER.SYS      JDISK     QEMM.SYS
AUTOMENU\     CONFIG.SYS    DUET\      LIB\        SRC\
BATCH\          CONFIG.OLD    DV\       NOTES

In addition to the [Dir | Login New Drive] and [Dir | Login New Directory]
commands, the F3 and F4 function keys can also be used to change directories.
The F3 key will login to the parent of the current directory, up to the top
level root directory on the current disk. The F4 key will login to the
subdirectory under the file pointer.

5-7 Terminate and Stay Resident Utilities and Treeview

Terminate and Stay Resident (TSR) programs load into memory and remain there
when executed. You should be careful to avoid loading TSR routines from
Treeview since the TSRs would be placed above Treeview in memory. When you
exit Treeview, an unused "hole" would be left in memory where Treeview used to
reside. This hole in the computer's memory would generally cut down on the
amount of memory available to other programs executed after quitting Treeview.
This is true not only of Treeview, but many other programs that also give you
access to DOS.

One common DOS command, the PRINT command, is a TSR utility that remains in
memory after being loaded the first time. If you're going to use the PRINT
command from within Treeview, make sure that PRINT is used at least once
before starting Treeview. The following command could be added to your
AUTOEXEC.BAT startup file to load the resident portion of the PRINT command
whenever the computer is turned on or restarted.

PRINT /D:PRN >NUL:

The >NUL: on the command line simply keeps a couple of messages from the PRINT
program from appearing on the screen. This command should work in DOS versions
3.1 and above. Refer to your DOS manual for more information on the PRINT /D
command option.

5-8 Update Target Directory

When maintaining backup copies of files, or working with the same set of files
on multiple computers, it's often necessary to update your files so that all
copies of the same file are indeed the same version.

Treeview's [Dir | Update Target Directory] command provides a convenient way
to synchronize the files in different directories or disk drives. Two
directories are used by the [Update Target Directory] command; the source and
the target. Treeview selectively copies files from the source to the target,
so that the target directory contains the same files as the source.

What makes this command more convenient than a simple copy is that it only
copies the files in the source directory that were created or modified more
recently than the corresponding files in the target directory.

The source directory is always the current directory when the [Update Target
Directory] command is executed. Treeview prompts you to enter the name of the
target directory before copying any files.

The [Dir | Update existing files only] option modifies the behavior of the
[Update Target Directory] command. When this option is off, all files in the
source directory are checked against the target, and are copied if more recent
or if they don't exist in the target directory. When the [Update existing
files only] option is on, only files already in the target directory will be
updated. Files in the source directory but not in the target will NOT be
copied.

Because Treeview uses the creation/modification date and time to determine if
the files are the same or not, it's important that the date and times be
accurate for this command to work properly. If your computer system doesn't
have a real time clock, make sure the date and time is set correctly whenever
the computer is turned on or restarted.

5-9 Window Commands

Treeview can display from 1 to 6 file name windows on the screen at a time.
Each window is independent of the others and can display the same or a
different drive/directory. File name windows are opened, closed, and switched
with the [Windows] command. When you start Treeview, it initially has one file
name window open, displaying the contents of the current directory. As you
open and close additional windows with the [Windows | Open] and [Windows |
Close] commands, the size of the windows will be adjusted so that all open
windows have an equal amount of screen space. The F7 and F8 keys are
short-cuts for opening and closing windows, respectively.

Only one of the open windows can contain the file pointer at a time; this is
called the current window. The Path, Files, and Selection sections of the
header area at the top of the screen always display information about the
current window. As you move the file pointer from window to window with the
[Window | Next] and [Window | Prev] commands, the header area updates to
reflect the current window status. The F9 and F10 keys are short-cuts for
moving to the next or previous window, respectively.

A newly opened file name window displays the same directory as the current
window, and it also inherits the current window's sort options, tagged files,
and selection criteria. If you want the new window to display a different
directory or disk drive, use the [Dir | Login New Directory] or [Dir | Login
New Drive] command to switch to the desired directory or drive.

Commands that operate on files only effect the directory shown in the current
window. For example, when you erase all tagged files with the [Files | Erase
File(s) | Tagged Files] command, only the tagged files in the current window's
directory are erased. [Erase File(s)] does not effect any tagged files in
other directories.

Closing a file name window removes the window from the screen display. Closing
a window has no effect on the files themselves, it simply removes the window
from the display.

Windows are very useful when working with two or more directories at the same
time. For example, when copying a set of files from a hard disk to a floppy,
or when moving files from one directory to another.

5-10 Interrupting Tagged File Operations

When performing an operation on all tagged files (copy tagged, rename tagged,
erase tagged, etc.), the Esc, Ctrl-U, Ctrl-C, or Ctrl-Break keys can be used
to interrupt the process. Striking one of these keys during a tagged file
operation causes the message "Interrupt?" to be displayed. Respond Y to stop
the operation, N to continue.

Interrupting a tagged file operation doesn't restore files that have already
been processed, but it can keep further files from being modified. We recommend
that you do NOT interrupt tagged file operations that involve more than one DOS
command (i.e., REN $T $T.BAK^DEL $T^MODE BW80).

5-11 Editing Responses

When you are prompted for a response in a pop-up window (for example, when
logging in to a new directory or when entering a DOS command to execute), the
response can be edited with the Home, End, Ins, Del, backspace, left arrow,
and right arrow keys up until the time you press the Enter key to end the
input.

The Home and End keys move the cursor to the left and right ends of the
response, respectively. The Ins key turns insert mode on and off, allowing
existing data to be overtyped (when off) or new data inserted (when on). The
cursor is made larger when insert mode is turned on. The Del key deletes the
character at the cursor position, while the backspace key deletes the
character just to the left of the cursor. The left and right arrow keys simply
move the cursor in the corresponding direction.

The up and down arrow keys can also be used when entering a response. Treeview
keeps the last 10 responses entered, and recalls the next oldest response each
time the up arrow key is pressed. The recalled response can be edited or
accepted (by pressing Enter) just as if it had been typed in again. If you go
past the response you wanted with the up arrow key, the down arrow can be used
to recall the more recent responses.

Finally, the PgUp and PgDn keys also effect the entry and editing of
responses. Pressing the PgUp or PgDn key when entering a response inserts the
name of the directory displayed in the file name window above or below the
current window, respectively. Each time the PgUp or PgDn key is pressed, the
next higher or next lower window's directory name is inserted. This is useful
when performing operations such as copying files or logging in to another
directory.

5-12 External Functions of Treeview

Treeview can perform several "external" procedures - running any DOS program,
calling a user defined file editor or listing utility, and more. This ability
is usually referred to as a "shell", meaning that Treeview can provide an user
interface to the computer instead of the standard DOS prompt (C:>). By using a
shell, users can normally be more productive with less understanding of the
commands available from the normal DOS prompt. The shell is an environment
that provides on-line help, colorful screen displays, easy performance of
repetitive tasks, and a common place of reference for the user. A task is
performed from the shell and then control is returned to the shell program. In
Treeview's case, this means that you can just point to a program or executable
file, hit the Alt-X key and run it. When the program is finished, you are
returned to Treeview.

Treeview can be configured to either run its own internal file viewer or one
of your own selection. Similarly, you can set up an external editor to be
called with a single keystroke from within Treeview that will allow the user
to perform quick revisions to text files, batch procedures, or other ASCII
files.

Magee Enterprises Inc. has another product that can be considered a shell
program, and it is called Automenu (R). Where Treeview is file oriented (point
at a file and perform an action on it), Automenu is application oriented
(point to an option on a menu and perform it). Both are examples of shell
programs because both allow you to perform complex tasks more easily with them
than without them. More details on the external functions of Treeview are
outlined in Appendix A.
5-13 File Oriented Operations

With many of Treeview's file oriented operations, you must first tag (mark)
the files to be processed and then perform some type of command with those
tagged files. This is done by several means. You can move the highlight bar to
a file and then either press the grey "plus" key or the F2 function key. This
will mark the file as "tagged" and then proceed down to the next filename that
is displayed in the window.

You can also use the menu bar option at the top of the screen called
Tag/Untag. Do this by pressing the letter "T". Then you have the option of
tagging files by name where you can specify a file mask that fits the files
you want to process. You can specify "*.BAK" to tag all files with that
extension, or "STAR.*" to tag all files with that filename.

There are other options under the Tag/Untag function that allow you to select
files by date and time, if they have not already been tagged (Invert), files
with todays date, files with the archive attribute set (Modified), and to
untag all tagged files. Check Appendix A for the logic map on using the
Tag/Untag menu option.

5-13.1 Copying Files

After tagging the selected files you wish to copy you will return to the main
display screen. From here you must press "F" to access the Files menu bar
option, and then "C" to copy files. You will be asked if you want to copy the
Current file or all Tagged files. Press "T" to copy a series of tagged files,
and then answer the prompt about the destination for the files to be copied
to. To copy tagged files to another drive, just input the name of the drive to
be copied to (A:, etc.). If there is a special subdirectory that you wish the
files to be copied into, specify that when Treeview asks for the destination
(D:\FileDirectory, etc.).

5-13.2 Renaming and Moving Files

Treeview has a rather simple approach to moving files - it merely renames the
path associated with the filename so that DOS will keep track of it in another
subdirectory. Instead of making a copy in another subdirectory (with the
inherent space taken by duplicating files) and then deleting the original as
so many file products do, Treeview just renames the path specification to the
file you are renaming. For example:

C:\AUTOMENU\MARSHALL.MDF

can be "moved" to another subdirectory by renaming it to

C:\BACKUP\MARSHALL.MDF    or  C:\PUBLIC\MARSHALL.MDF

There is no reason to duplicate the file when DOS will accept the renamed path
specification as part of the new filename. This effectively "moves" a file
LOGICALLY without moving it PHYSICALLY.
5-13.3 Viewing Files

Treeview has a built-in file listing utility that will automatically switch
between ASCII and hexadecimal modes, depending on the format of the file you
wish to view. By just placing the highlight bar over a file and pressing
RETURN you will see the contents of the file displayed on the screen. This is
important if you need to look at several files before deciding which one you
might wish to edit.

View any current file by pressing "F" for Files and then "V" for View. The
highlighted file will then be displayed on the screen. A shortcut would be to
highlight a file and then press Alt-V. If the current (highlighted) file is in
ASCII (text) format, it will be displayed in full screen format. If it is not
ASCII, it will be displayed in hex format - the left two thirds of the screen
will show the hexadecimal representation of each byte in the file, with the
printable equivalents shown on the right one third.

This version of Treeview allows you to use either the native file lister
included with the product, or configure one of your own. Please refer to
Section 6 for tips on "Customizing Treeview".

5-13.4 Editing Files

There is no editor built into Treeview, so this is what we call an "external"
function. It is something that you can set up, but will not operate if you do
not do so. From the main display you can press [Other | Setup Parameters |
External Program Hooks | File Editor] to access a screen that will ask you for
the "command prototype" of the editor you wish to use.

The command prototype is in the same form as those discussed in Section 6-4
and 6-5, and makes use of the DOS macros explained in Section 6-2. Typically
you would tell Treeview to use a command prototype that looks like this:

EDITOR $F

where "Editor" is the command to start your choice of editing programs, and
"$F", a DOS macro, which will be substituted by the full path and filename of
the current file. This will allow you to highlight a file from the main screen
and then press Alt-F ([Files | Edit File]) to start your editor and pass to it
the name of the highlighted file.

5-13.5 Resetting File Date and Time

The date and time attributes of any file(s) can be changed by using the [Files
| Set File Date/Time] command. Treeview will ask if you want to change the
current file or all tagged files, and then present a pop up window displaying
today's date and time. You can press the return key to use this data, or input
your own specifics and then press return. In any event, changing file dates
and times can be a convenience for those who must track files by their
vintage, such as a software librarian or programmer.

SECTION 6

CUSTOMIZING TREEVIEW

6-1 Screen Colors

The [Other | Setup Parameters | Screen Colors] command allows you to customize
the video attributes Treeview uses to display various types of information. On
a color display monitor, the video attributes determine which colors are
displayed. On a monochrome monitor, the attributes select display options such
as underlined, inverse video, and intensity.

You can specify video attributes for ten different types of displayed text.
They are: Normal text, Highlighted text, Window text, Highlighted window text,
Heading text, Background text, Tagged file name text, Menu text, Highlighted
menu text, and Selected menu text. The easiest way to determine what the
different types of text are is by changing the colors and observing the
results.

When you select the [Other | Setup Parameters | Screen Colors] command, the
display shows the types of text that can be selected, the attribute
combinations allowed, and short directions. The PgUp and PgDn keys on the
numeric keypad select the type of text to define, while the arrow keys select
the particular display attribute for that type of text. The current type of
text and the current attribute are always indicated by > TEXT < characters.

When changing video attributes, three choices are available from the menu bar;
Accept, Reset, and Quit. Use the [Accept] option to begin using the color
combination you've selected. If you've selected a set of attributes you don't
like, you can use the [Quit] command to return to the previous attribute
settings. With the [Reset] command, you can restore the default (permanent)
settings even if you've accepted other attributes. [Reset] restores the last
settings that were written to the TV.CFG file.

6-2 DOS Command Macros

A set of command line "macros" are available for use wherever Treeview accepts
input of a DOS command ([Xecute | Current File], [Xecute | DOS Command], User
Defined Keys, and Point-and-Go commands). Before executing the DOS command,
Treeview replaces the macro with its value. The supported macros are:

$C  - The current file name, with extension.
$D  - The current drive letter, without a trailing colon (:).
$F  - The full pathname of the current file, including drive,
      directory, and file name (with extension).
$P  - The directory pathname for the current or tagged file,
      without a trailing backslash (unless the current directory
      is the root and a \ does not follow the $P macro).
$T  - The first or next tagged file name, with extension.  When
      $T appears in a command line, Treeview executes the
      command once for each tagged file.
$XC - The current file name, without its extension or trailing
      period.
$XT - The first or next tagged file name, without its extension
      or trailing period. Like $T, $XT causes the command to
      be run once for each tagged file name.

Macro examples:

PRINT $C

Runs the DOS PRINT command on the current file. If the file pointer was on the
file TV.DOC, the command is executed as:

PRINT TV.DOC

The command

COPY $T A: /V

runs the COPY command once for each tagged file. If the files TV.CFG, TV.DOC,
TV.EXE, and TV.HLP were tagged, the following commands are executed:

COPY TV.CFG A: /V
COPY TV.DOC A: /V
COPY TV.EXE A: /V
COPY TV.HLP A: /V

When executing a DOS command in the Show-all or Show-sub modes (multiple
directories displayed in a single file name window), use the $F or $P macros
to ensure the command looks for the file in the proper directory. Without the
$F or $P, the command will most likely assume the file is in the current
directory, while it may in fact be in a different directory. The command

FIND "silver" $T

tries to find the string "silver" in all tagged files, but will not be able to
search those files that are not in the current directory. The command

FIND "silver" $P\$T

searches all tagged files using the file's complete pathname (including files
not in the current directory). To pass a macro name to DOS without being
expanded, use two $'s. The command

FLARP *.C $$P /DI

is executed as:

FLARP *.C $P /DI


The macro names can be entered in upper or lower case, thus $C is the same as
$c.

Entering a $T or $XT macro on a command line causes Treeview to execute the
command once for each tagged file in the current window. If you have a ram
disk on your computer system, you can speed up such operations by putting a
copy of the DOS COMMAND.COM file on the ram disk and pointing the COMSPEC
environment variable to it. For example, if your system has a RAM disk as
drive D: the following commands in the AUTOEXEC.BAT would copy the COMMAND.COM
file and setup the COMSPEC environment variable:


COPY C:\COMMAND.COM D:
SET COMSPEC=D:\COMMAND.COM

6-3 Setting File Limits

Treeview allows you to select the maximum number of files that can be
displayed in a file name window. The number of files per window directly
corresponds to the amount of your computer's memory required to hold file
information. The smallest number allowed is 100, while the maximum is 2515.
Approximately 64K of memory is used to hold file information when the maximum
value of 2515 is selected. Having four maximum sized windows open at once
would require 256K of memory, just to hold file information.

If you want to minimize the amount of memory that Treeview itself uses, select
a value for the number of files per window that is just large enough to hold
all the files in one or your typical directories. Minimizing Treeview's memory
usage allows more memory for any programs executed from within Treeview.

The number of files per window is set with the [Other | Setup Parameters | #
Files per Window] command. Changing this value does not effect any file name
windows that are already open, only windows opened afterwards (via F7 or the
[Window | Open] command), will have the new value.

The number of files per window can be increased on a temporary basis by
selecting the new value and then responding with an N to the "Write Changed
Parameters to Disk (y/N):" prompt.

Treeview's conventional memory requirement can be greatly reduced if your
computer has LIM/EMS memory available to hold file information. See the topic
USING LIM/EMS MEMORY for more information.









6-4 Point-and-Go

Treeview's Point-and-Go facility provides the ability to operate on files with
DOS commands or other programs simply by pointing at the file name and
"executing" the file. Whenever Treeview executes a file, it looks at the
file's extension to determine what processing is required. If the extension is
.COM, .EXE, or .BAT, the file is treated as an executable program (.COM or
.EXE) or as a batch file of DOS commands (.BAT). If the file has an extension
other than .COM, .EXE, or .BAT, Treeview searches a table of file extensions
and commands to determine how to process the file. Instead of executing the
file itself, Treeview performs one or more DOS commands defined for files with
matching extensions.

The Point-and-Go commands are most useful when combined with Treeview's
command line macros. These macros allow information such as the current drive,
directory, and/or file name to be added to the command before it's executed.
See Section 6-2 "DOS Command Macros" for a complete description of the
available macros.

As with User Defined Keys and the [Xecute] commands, you can specify multiple
DOS commands to be executed in a Point-and-Go entry by separating the commands
with '^' characters. The following example shows three DOS commands that could
be given in a Point-and-Go entry. All three commands would be executed, in
left to right order, when a file with a matching extension is "executed."

del $xc.old^rename $xc.bak $xc.old^ws $c

As an example of how to setup the Point-and-Go entries, consider an entry with
an extension of .DOC and a command of WS $C. Whenever you enter Alt-X
(short-cut for [Xecute | Current File]) with the file pointer over a .DOC
file, Treeview executes the WS program with the current file name as a
parameter. Alt-X with the file pointer on the file TV.DOC would execute the
command

WS TV.DOC

while Alt-X on the file DC_TRIP.DOC would execute the command

WS DC_TRIP.DOC

The Point-and-Go table can hold up to 10 extension/command entries. You create
and modify the entries with the [Other | Setup Parameters | Point and Go
Setup] command. Each entry can specify from 1 to 3 different extensions. When
entering multiple extensions, make sure to separate them with a single space.
The following example shows how a couple of Point-and-Go entries might look:

    NUM EXT(s)     COMMAND PROTOTYPE         PAUSE READ
      1 doc      ws $c                   N     N
      2 c asm txt     edlin $f               N     N
      3 ltr      del $xc.bak^ws $c           N     N
      4 mdf      automake $f               N     N
Entry number 1 is the WS $C example presented above. Entry number 2 shows a
command that edits files with three different extensions (.C, .ASM, and .TXT).
Entry 3 shows two commands being executed for LTR files, while entry 4 edits
AUTOMENU Menu Definition Files by running the AUTOMAKE program.

For each Point-and-Go entry, you can define whether or not Treeview pauses
and/or rereads the current directory after executing the DOS commands. If you
enter "Y" (for YES) in a entry's PAUSE column, Treeview waits for you to press
a key after running the command(s). An "N" (for NO) in the PAUSE column causes
Treeview's screen to be redisplayed as soon as the commands finish. Entering
"Y" for PAUSE allows you to view any output the commands leave on the screen
before Treeview redisplays its own screen.

Entering "Y" in the READ column of an entry tells Treeview to reread the
current directory when the command(s) finish. A value of "N" will not reread
the directory. "Y" should most likely be specified if the commands create or
delete files, or if they change the current directory. Note that rereading the
directory will result in "untagging" any files tagged before the commands were
executed.

6-5 User Defined Keys

Treeview provides the ability to execute user defined commands at the touch of
a key. There are 30 User Defined Keys available. A particular User Defined Key
is executed by pressing an Alt-Function key sequence, a Control-Function key
sequence, or a Shift-Function key sequence; Alt-F1 executes User Defined Key
number 1, Alt-F2 executes User Defined Key number 2, and so forth.

User Defined Keys are created and modified with the [Other | Setup Parameters
| User Defined Keys] command. The following sample entries show how User
Defined Keys are entered.

NUM  KEY  COMMAND PROTOTYPE              PAUSE READ

 1  A-F1  edlin $f                    N      N
 2  A-F2  pak v $f                    Y      N
 3  A-F3  chkdsk $d:                    Y      N

The first entry (invoked by the Alt-F1 sequence) runs the program EDLIN with
the name of the current file as a parameter. Assuming EDLIN is a text editor,
you could edit any text file by moving the file pointer to the file's name and
pressing Alt-F1.

The second entry shown above runs the program PAK with two parameters; the
letter V and the name of the current file. PAK is a popular program for
maintaining archived (compressed) files. Moving the file pointer to a .PAK
file and pressing Alt-F2 would list the contents of the .PAK file.

The third entry shown above runs the DOS CHKDSK command with the current drive
letter as a parameter.

As with Point-and-Go entries and the [Xecute] commands, you can specify
multiple DOS commands to be executed by a User Defined Key. Each command must
be separated from the others by the '^' character. The following example shows
two DOS commands that could be executed by a User Defined Key:

del $xc.bak^edlin $c

For each User Defined Key, you can specify whether or not Treeview pauses
and/or rereads the current directory after executing the commands. If you
enter "Y" (for YES) in a command's PAUSE column, Treeview waits for you to
press a key after running the command(s). An "N" (for NO) in the PAUSE column
causes Treeview's screen to be redisplayed as soon as the commands finish.
Entering "Y" for PAUSE allows you to view any output the commands leave on the
screen before Treeview redisplays its own screen.

Entering "Y" in the READ column of an entry tells Treeview to reread the
current directory when the commands finish. A value of "N" will not reread the
directory. "Y" should most likely be specified if the commands create or
delete files, or if they change the current directory. Note however that
rereading the directory will "un-tag" all files which were tagged before the
commands were executed.

6-6 Using E.M.S. Memory

Treeview can make use of two different types of memory in your computer system
- conventional and expanded. Conventional memory is that part of memory used
and controlled by DOS. There is normally somewhere between 128K and 640K of
conventional memory available in an IBM PC or compatible system.
The Lotus/Intel/Microsoft (LIM) Expanded Memory Specification (EMS) is a
hardware and software system that provides extra (expanded) memory to programs
that know how to use it. If your computer system has EMS compatible memory
installed, Treeview can use this memory to store file names and other file
data. Allowing Treeview to utilize EMS memory is advantageous because it
leaves additional conventional memory available to execute DOS commands and
other programs from Treeview.

The [Other | Setup Parameters | Other Options | Use EMS (if available)] option
enables or disables Treeview's use of LIM/EMS memory. If your computer system
does not have LIM/EMS memory installed, this option has no effect as Treeview
will then use conventional memory anyway. The [Other | Setup Parameters |
Other Options | Use EMS (if available)] option is turned on when a check mark
is displayed in front of the option - it's off when a not sign precedes the
option.

You can also enable or disable Treeview's use of EMS memory with the /C and /E
command line parameters. Refer the topic COMMAND LINE PARAMETERS for more
information.

As distributed, the [Use EMS (if available)] option is on to allow Treeview's
use of EMS memory - if EMS memory isn't available, conventional memory will be
used anyway.
6-7 Video Snow Checking

The [Other | Setup Parameters | Other Options | Video Snow Checking] option
allows for faster screen updates on computer systems that do not make "snow"
when writing directly to video memory. This option is only useful for some
systems with color displays--monochrome displays do not make "snow" and
Treeview knows not to check for snow when using a monochrome adapter.

Disabling "snow" checking can significantly speed up screen updates. If you
are not sure if your color display adapter makes snow or not, try disabling
Treeview's snow checking. It will quickly be obvious if you need to re-enable
the snow checking.

Snow checking is enabled when a check mark is displayed before the [Other |
Setup Parameters | Other Options | Video Snow Checking] option. Snow checking
is disabled when a not sign is displayed.

You can also enable or disable snow checking with the /F and /S command line
parameters. Refer the topic COMMAND LINE PARAMETERS for more information.

As distributed, video snow checking is disabled.

6-8 Defining the Editor and Viewer

Treeview permits you to specify your own choice of file listing (viewing)
utility as well as an editor. Even though a native file viewer is included,
you might wish to use the famous LIST program written by Vern Buerg to view
your files. To do this from the main Treeview screen you would press Alt-S
(for Setup), "H" for External Program Hooks, and "V" to specify that you want
to change the File Viewer.

You will be asked for a "command prototype". This is the specification to tell
Treeview what listing program to run and what form of filename to use with it
in the form of a DOS macro). For example:

LIST $F

will instruct Treeview to use the List program and pass to it the current file
(including pathname) and display it on the screen. More details on the concept
of DOS macros are in Section 6-2. Available macros are listed in Appendix D.

A user defined editor would be defined in exactly the same way, except you
would specify "E" for File Editor and input the command prototype.

6-9 DOS Volume Labels

You can change the name of the DOS volume label on your disk drive with this
special capability of Treeview. From the main display screen, type "O" for
Other and "L" for Set Volume Label. Input the new name and press RETURN. The
new volume name will be displayed on the main screen.

6-10 DOS Verify

Treeview can control the DOS verify function by turning it on or off. The
Verify function performs a check every time a file is copied to make certain
(verify) that the operation occurred successfully. Copying files will take a
bit longer with verify turned on because of the checks that must be performed,
however it is almost certain that many file related problems will not be
noticed if the verify function is left on. If you use an exceptionally slow
disk drive or CPU, you might be forced to leave verify off due to
exceptionally long times required to do copy files. We recommend, however,
that the DOS verify function be left ON at all times. Think of it as a little
piece of insurance, a little peace of mind.







































SECTION 7

SHAREWARE CONSIDERATIONS

Treeview is distributed under the shareware marketing concept, it is not free
software and it has not been released to the public domain. The documentation,
executable images, and all other files distributed with Treeview are
copyrighted by Magee Enterprises.

7-1 What Is Shareware?

Shareware is a way of distributing computer software that allows you to try
out a program before you purchase it. Programs distributed as shareware
typically give you some period of time to use the program and evaluate its
usefulness to you. If the program doesn't meet your needs, you're under no
obligation to pay for it. If you do find the program useful and wish to
continue using it, the shareware program's author will request that you pay
for the program by sending him or her a completed registration form and
payment.

If you find Treeview to be a useful addition to your software library, please
become a registered user by completing the enclosed registration form and
returning it along with the indicated license/registration fee. I hope that
you will agree that the $39.95 fee is a small price to pay for the continued
use of the program. It requires a large investment to develop, market, and
support a product of this complexity. Your support in the form of a
registration fee will help us to continue to make good software available at
very reasonable prices. Treeview is also available at very special rates to
organizations who wish to use it in promotional campaigns, or to educational
institutions. Write to Magee Enterprises Inc. for information on using the
program this way.

7-2 How To Register

If you use Treeview on a regular basis, you should complete the registration
form at the end of this document and return it along with the indicated
license/registration fee. Registration gives you the right to use the software
as documented in the license. There are two types of registrations available:
1) regular, and 2) quantity. Registration is required if Treeview is used in a
business, government, or other commercial environment.

The regular registration fee of $39.95 establishes you as a registered user of
Treeview and upon receipt of your registration fee, you will be mailed a
diskette containing the most recent Treeview version, a bound and printed
manual, extended technical support and notice of product updates. Note that
the version mailed to you may be the same version you already have, although
updated versions will be released from time to time.

Registered users will also receive the current release of TV286, a version of
Treeview specifically made for computers with the Intel 80286 and 80386
microprocessors.
APPENDIX A

TREEVIEW MENU STRUCTURE
Main Menu Line
===============================================================
Dir  Files  Help  Other  Sort  Tag/Untag  Windows  Xecute  Quit
===============================================================
DIR

    L Login New Directory          Alt-L
    D Login New Drive              Alt-G
    R Reread Current Dir          Alt-N
    T Show Directory Tree          Alt-T
    A Show All Dirs
    S Show Sub Dirs
    U Update Target Dir
    X Update Existing Files Only

FILES

    A Set File Attributes
     C Current File           Alt-A
     T Tagged Files           Alt-B

    C Copy Files
     C Current File           Alt-C
     T Tagged Files           Alt-K
     R Use DOS Verify
     I Overwrite Check

    D Set File Date/Time
     C Current File
     T Tagged Files

    F Edit File               Alt-F

    E Erase Files
     C Current Files          Alt-E
     T Tagged Files           Alt-Y

    I Extra File Info              Alt-I

    R Rename/Move Files
     C Current File           Alt-R
     T Tagged Files           Alt-M

    V View File               Alt-V

    X Execute File              Alt-X

HELP (See Appendix B)
APPENDIX A

TREEVIEW MENU STRUCTURE

OTHER

    C Selection Criteria
     A Attribute
     R Reset to Defaults
     M File Name Mask
     C Clear Mask
     I Invert Mask

    I Treeview Information

    L Set Volume Label

    S Setup Parameters              Alt-S
     C Screen Colors
          F # Files per Window
          P Point and Go Setup    Alt-P
          U User Defined Keys     Alt-U
          S Startup Defaults
           A Selection Attributes
           S Sort Options
           B Bypass Startup Screen Delay

          T Copy Options
          D Dir Tree Options
          H External Program Hooks
           E File Editor
           V File Viewer

          V View Options
           7 Display 7 Bit Char
           M Require Case Match
           A Default to ASCII
           H Default to Hex

     O Other Options
          D Display as File Ext
          E Use EMS Memory
          F Sound Effects
          S Video Snow Checking
          4 43 Line EGA Mode
          X Esc Exits at Top Level

     W Write Setup to Disk

    V Toggle DOS Verify

SORT

    N Name
    E Extension
    D Date
    S Size
    U Unsorted
    A Ascending
    C Descending










































APPENDIX A

TREEVIEW MENU STRUCTURE

TAG/UNTAG

    C Current File
    D Date/Time
    I Invert
    M Modified
    N by Name
    T Today
    U Untag All
    S Select Tagged


WINDOWS

    O Open                  F7
    C Close                  F8
    E Expand
    N Next                  F9
    P Previous                  F10

XECUTE

    C Current File              Alt-X
    D DOS Command              Alt-D
    S DOS Shell

QUIT                      Alt-Q




















APPENDIX B

TREEVIEW HELP STRUCTURE
HELP
    C Commands
     D Directories
          D Dir-Tree
          S Show All/Sub
          U Update

     F Files
          A Attributes
          C Copy
          D Date/Time
          I Info
     V View
          F Find

     X Execute

     O Other
          C Criteria
          S Setup
           C Colors
           D Defaults
           F Files
           G Go
           U User Defined Keys
           S Snow Checking
           O Options

     S Sort
     T Tag
     W Windows
          O Open/Close

     X Execute
          G Go
          M Macros

    I Input
     K Keyboard
          A Alt
          C Control
          F Function
          O Other
     Mouse

    M Menus
    P Parameters
    R Registration
    S Screen
    Q Quit

APPENDIX C

TREEVIEW KEYSTROKE COMMANDS

Function Key Usage
==================

F1  Help

F2  Tag/Untag current file (toggle)

F3  Login to parent directory

F4  Login to subdirectory under pointer

F5  Goto next tagged file (find NEXT in View)

F6  Goto previous tagged file (find PREVIOUS in View)

F7  Open another file display window

F8  Close current file display window

F9  Goto next filename display window

F10 Goto previous filename display window


Control key Usage
=================

^R  PageUp
^C  PageDown
^W, ^E     Up Arrow
^Z, ^X     Down Arrow
^A, ^S     Left Arrow
^D, ^F     Right Arrow
^G  Delete
^V  Insert
^H  Backspace
^M  Enter
^T  Tag, Untag current file



=   Find File in current window

+   Tag Current File in Window

-   Untag Current File in Window

APPENDIX D

DOS COMMAND MACROS


$C  Filename with extension

$D  Drive letter, no trailing colon (:)

$F  Full pathname (drive, directory, filename and extension)

$P  Directory pathname, no trailing colon (:)

$T  First or next tagged filename (executes once per file)

$XC Filename, no extension or trailing period

$XT First or next tagged filename, no extension or trailing period
    (like $T, executes once per file)




Examples of Command Prototypes with DOS Macros



del $xc.old^ren $xc.bak $xc.old^ws $c


pkarc a arcfile $t^copy arcfile a:\ /v^echo ALL DONE


command [parameter(s)]^command [parameter(s)^command [parameter(s)]




















APPENDIX E

CUSTOMER SUPPORT INFORMATION

If you have problems with Treeview, please read this manual first to make sure
you do understand everything. We have tried to provide a problem-free product
but sometimes we make mistakes. If you think you have found a problem please
take the time to contact us and explain your problem to us. All registered
users will be informed of any problems and their solution. Make sure that you
include the following information to help us evaluate the problem:

1.    Version of DOS you are using
2.    Machine type, memory, monitor type, hardware description
3.    Any application executed before Treeview
4.    Your address and telephone number (when corresponding)
5.    Where, when and how you obtained Treeview
6.    Which version of Treeview you are using
7.    Printouts of your AUTOEXEC.BAT and CONFIG.SYS files
8.    Your product SERIAL NUMBER

We also provide an electronic Bulletin Board System (BBS) for anyone
interested in Treeview or Shareware in general. This board currently supports
1200, 2400, 4800, and 9600 baud (Hayes) speeds and is available 24
hours a day, seven days a week. Multiple lines are now available, however in
the future we will offer some lines that are limited to registered users only.

We maintain the most current releases of our products and many other helpful
files concerning Treeview, as well as a large selection of other SHAREWARE
products provided to us DIRECTLY from the authors. The BBS can be reached by
calling 404-446-6650. We also can be reached through a CompuServe ID:
76004,1541. Our Technical Support Group is open between the hours of 9am to
4pm ET Monday through Friday, and their direct line is 404-662-5387. We also a
have FAX line available at 404-368-0719.

Users will always receive a response to their questions. Non-registered users
will receive a response if they enclose a self-addressed stamped enveloped
with their query.

If you write to us concerning a problem you've encountered using Treeview,
please include as much of the following information about you computer system
as you can. Thank you.

Computer Make and Model _________________________________________

BIOS Type and Version Number ____________________________________

Display Adapter (CGA, EGA, VGA, etc.) ___________________________

Amount of conventional DOS memory installed _____________________

Amount of LIM/EMS memory installed ______________________________

Version of DOS in use (2.x, 3.x, 4.x) ___________________________

Device drivers being used _______________________________________

_________________________________________________________________

Any multi-tasking software in use (DESQview, Windows, etc.)

_________________________________________________________________

What TSR programs are in use (Sidekick, Superkey, spoolers, etc.)

_________________________________________________________________

Please describe the problem as fully as possible

_________________________________________________________________

_________________________________________________________________

_________________________________________________________________

_________________________________________________________________

Can you send copies of your CONFIG.SYS and AUTOEXEC.BAT files? __

_________________________________________________________________

Remember our FAX LINE [phone] and the BBS [phone]
             ------------------------------------
             Treeview Registration Payment Form
            ------------------------------------
    To order Treeview, please fill out the form below. Use your street
    address only, please.  WE CANNOT SHIP TO A POST OFFICE BOX.
    Or call 1-800-662-4330 USA; or 404-446-6611

                              Date: _____________
    Name: _____________________________  Title:   ___________________
    Company: ________________________________________________________
    Address: ________________________________________________________
    _________________________________________________________________
    City: ___________________________________________________________
    State/Country: ________________________ Zip: ____________________
    Phone  Work: (_____) _____ - ______  Home: (_____) _____ - ______


    Method of payment: Please complete the worksheet below and choose
    one of the payment options indicated. Georgia State residents
    must add sales tax. ALL CHECKS AND MONEY ORDERS MUST BE DRAWN ON
    U.S. ACCOUNTS ONLY.
    +----------+------------------------------+----------+----------+
    |       |                  |   Cost   |     Total    |
    | Quantity |          Description      | per unit |     Cost    |
    +==========+==============================+==========+==========+
    |       |                  |         |        |
    |       |Treeview 1.0 Software Package |  $39.95  |        |
    |       |                  |         |        |
    +==========+=+============================+==========+==========+
             |         Georgia residents add sales tax |        |
             +---------------------------------------+----------+
             | Shipping Cost if Overseas, add $15.00 |        |
             +---------------------------------------+==========+
                               TOTAL |        |
    Please indicate diskette format:  [ ] 5.25         +==========+
                      [ ] 3.5

     [ ] Check with order  [ ] Money Order    [ ] MasterCard    [ ] VISA

    Credit card #:______________________________ Exp. Date: ____/____

    Signature: ______________________________________________________

    Cardholder's name: ______________________________________________

    Cardholder's address: ___________________________________________
    (If different from above)
    *****************************************************************
    Send all items to:     Magee Enterprises, Inc.
                   Treeview Order Department
                   Post Office Box 1587
                   Norcross, Georgia 30091 USA                ---------------------
                 TREEVIEW COMMENT FORM
                 ---------------------

    Your comments about this software and documentation are welcome.
    Please take the time to fill out this form or write or call us
    with your comments.

    Name: _____________________________  Title:   __________________

    Company: _______________________________________________________

    Address: _______________________________________________________

    ________________________________________________________________

    City: __________________________________________________________

    State/Country: ________________________ Zip: ___________________

    Phone Work: (_____) _____ - ______  Home: (_____) _____ - ______

    Treeview Version Number: ___1.0_______    Date: __________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________
                                  21561.8811

    *****************************************************************
    Send this form to:     Magee Enterprises, Inc.
                   Treeview Comments
                   Post Office Box 1587
                   Norcross, Georgia 30091    USA
    *****************************************************************