home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Share Gallery 1
/
share_gal_1.zip
/
share_gal_1
/
UT
/
UT036.ZIP
/
TV.DOC
< prev
next >
Wrap
Text File
|
1989-05-31
|
127KB
|
3,129 lines
TREEVIEW (TM)
The Ultimate File Management Utility (TM)
Version 1.1
May, 1989 Release
Copyright 1988, 1989 Magee Enterprises, Inc.
ISBN 0-938167-01-4
Copyright 1988, 1989 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 and
registered trademarks referenced within this document are the property of
their respective owners.
MAGEE ENTERPRISES, INC.
POST OFFICE BOX 1587
NORCROSS, GEORGIA 30091 USA
Sales: Monday - Friday
404-446-6611 Voice 9 AM - 5 PM Eastern Time
800-662-4330 Orders Only
404-368-0719 FAX (24 Hours/7 Days)
Technical Support Group: Monday - Friday
404-662-5387 Voice 9 AM - 4 PM Eastern Time
404-446-6650 Big Peach BBS (24 Hours/7 Days)
76004,1541 or
70167,2200 CompuServe (24 Hours/7 Days)
Documentation by Mark Strelecki, Swati Mahajan, Randal DePriest, and Marshall
Magee. Artwork by Neisha L. Keith. Based on "Overview Too", an original work
by James Mathews.
This manual was developed using WordPerfect 5.0.
May 1989 Release
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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
3-6 The Help System
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
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
Section Title
5 Elements of Treeview
5-1 The Directory Tree
5-1.1 File Masks
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
5-9 Window Commands
5-10 Interrupting Tagged File Operations
5-11 DOS Command Recall
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
5-14 Command Prototypes
5-15 Displaying and Resetting File Attributes
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
6-10 DOS Verify
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
APPENDIX F Treeview and the Disk Operating System
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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: Copyright 1988, 1989 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 increased bulletin board access. Contact us at:
Magee Enterprises, Inc.
Post Office Box 1587
Norcross, Georgia 30091 USA
Also, please feel free to contribute your ideas regarding desired additional
product features and functionality.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
SECTION 1
THIS IS TREEVIEW(TM)
Thank you for your interest in Treeview(TM). Treeview is a hard disk and file
management utility for IBM(TM) Personal Computers, Personal System/2(TM), and
other PC compatible computers.
Treeview is a powerful hard disk and file management 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.
Treeview gives you simple, straightforward commands to accomplish everyday
operations such as copying, renaming, erasing and backing up files, and much
more. Treeview removes the guesswork from file management tasks by displaying
the files on your disk in a tabular format that is continually updated in
response to your commands. Treeview speeds up time consuming disk cleanup and
maintenance sessions.
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-only systems.
This document describes the installation and usage of Treeview. It also
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 on screen at the same time
* A directory tree display that shows your disk's directory structure in
an easy-to-understand graphical layout
* A powerful "Show-All" and "Show-Sub" function that allows all files
on the current disk or under the current directory to be displayed and
accessed as if they were all in one subdirectory
* A "Find File" function permits you to find any file on any disk in
seconds
* A file viewing function that displays files as ASCII text or in hexa-
decimal format, and permits the use of any listing or editing program
at the user's option
* A full screen windowed interface with user selectable colors and
defaults
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
* Extensive on-line, menu-driven help available at any time with one
keystroke
* DOS Command Macros that give the user the ability to access complete
file and pathnames with just one or two characters and perform
multiple DOS commands on a series of tagged files
* Automatic recall of previously entered DOS commands
* Full mouse support, network compatible
* EGA/VGA video support for 25/43/50 line modes
* Easily modify these file attributes: Hidden, Read-Only, System or
Archive
* Easily alter file time/date stamp, disk volume label, and verify status
* Update file directories quickly and easily
* Runs under DOS 2.X, 3.X, or 4.X
1-2 Documentation Conventions
Throughout this document, references to Treeview menu selections are
surrounded by brackets ([ ]) and some 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.
WARNING!
Due to the nature of some of the commands available under DOS version 3.3 and
higher, we recommend that you DO NOT USE Treeview within a system where
APPEND, SUBST or JOIN commands are in effect. These commands can create
confusion for Treeview when copying, moving or renaming files, and the best
procedure is simply not to use them. Please consult your DOS manual for
further explanation regarding these commands and their use.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
SECTION 2
INSTALLATION
2-1 System Requirements
Treeview requires an IBM PC, XT, AT, PS/2 or compatible computer with 256K RAM
(or more) to work properly. In addition, version 2.0 or greater of PC-DOS or
MS-DOS is required.
Treeview requires approximately 158K 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 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 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
to use as much conventional DOS memory as possible for their own purposes.
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 is also "DESQview aware," meaning it can run in a small window under
Quarterdeck Office Systems' DESQview(TM) multitasking program.
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). Default values will be used
if Treeview can't locate TV.CFG when it starts up. If you change any of the
default aspects of Treeview operations and answer YES when prompted to "Save
changes to Disk? y/N", a TV.CFG file will be created (or updated).
If your system has a DOS PATH command set up, simply copy these three files
into one of the directories identified in the PATH command. If you have a hard
disk system, but have not set up a PATH command, you should read about it in
your DOS manual or get someone knowledgeable to help you set one up.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 find and read the TV.CFG configuration
data 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, and more). If the "TVFILES=" environment variable is
defined, Treeview expects to find the TV.CFG file there.
If TVFILES isn't defined in the environment, Treeview looks in the current
directory; if TV.CFG isn't found there, the directories specified by the PATH
command are searched. In case the file still can't be located, a set of
default parameters will be 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. In the event the help file still
can't be located, you'll be asked to supply the location of TV.HLP.
For those who 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. The TV.HLP file
is not accessed unless you actually request help, so it can be left off if you
are short on disk space.
PLEASE NOTE!
There may be important information on this release of Treeview that did not
make it into this manual. Please check the READ.ME file on your distribution
diskette for the most current data. Thank you!
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 the
DOS command prompt. However, the following optional parameters can be
specified on the command line to modify Treeview's behavior during a given
run. The typical command line syntax to execute Treeview is:
TV [parm] ... [parm] d:\subdir
where [parm] is as follows:
/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
/2 or -2 Uses "normal" 25 line mode even if default is different
d:\subdir Use this as the initial drive and subdirectory
A file name mask to display specific file names can also be entered on the
command line, but only 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 *.MDF
invokes Treeview and tells it to only display files that have an extension of
.MDF.
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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
Refer to Section 6-6, USING EMS MEMORY, and Section 6-7, VIDEO SNOW CHECKING
for more information on EMS memory and video snow checking.
You can access Treeview's on-line help system (any time Treeview is "Ready!"
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 The 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 letter that is highlighted in the submenu entry (not always the
first letter), or by using the up and down arrow keys (or mouse) to highlight
the desired entry and then pressing Enter (or clicking the mouse button). 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 Section 4, Appendix A, and in
Treeview's on-line help system. Here is an example of the menu bar and an open
submenu (in this case, the Files submenu):
Dir Files Help Other Sort Tag/Untag Windows Xecute Quit
| |-----------------------|
| Set File Attributes |
| Copy File(s) |
| Set File Date/Time |
| Edit File Alt-F |
| 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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 space used by those files (in bytes), the number of
files tagged for group operations, and the space used by those tagged files
(in bytes).
The final header section, "Selection", displays the selection criteria (mask)
used to pick which files are displayed in the file name area. If no mask is
shown, it means that ALL files will be displayed. If *.MDF is the mask, only
files with an MDF extension will be shown.
Following is an example of the header area:
+--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 called the
"current file pointer" or sometimes 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 (also called the current window). The current window is
defined as the window where the current file (pointer) is located.
3-5 The Status Line
The status line appears along the bottom 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. The following is an
example of the file name area (with two file windows displayed) and the status
line.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
C:\ -----------------------------------------------------------------------
|
AUTO\ BRATEMM.SYS JDISK.SYS QEXT.SYS |
AUTOMENU DV\ LIB\ SRC\ |
BATCH\ DV.BAT MOUSE.SYS WRITE\ |
BIN\ COMM\ FC\ |
BRATDISK COMMAND.COM GRAPHIC\ |
(Window #1) |
C:\SRC\TV -----------------------------------------------------------------|
|
CVTHLP.C GRAPHIC.H TVFMOVE.C TVVBUF.C |
CVTHLP.EXE KEYS.H TVMOVE.FN TVVIEW.BAK |
DATE.ASM LOGO.ASM TVFUN.BAK TVVIEW.C |
DIALOG.C LOGO.BAK TVFUN.H |
(Window #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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 at most any time 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, then
releasing the alternate key. For example, "Alt-A" means to hold the ALTernate
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
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 Control key and
simultaneously press the 'R' key, then release the Control 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 (same as ENTER)
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 Section 6-5.
4-4 The ESC Key
The ESCape 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 Escape 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 Escape key does this by closing the last opened
submenu. When multiple submenus are open, they can be closed in reverse order
by pressing the Escape key once for each submenu. The Escape 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 Escape key and the
window will disappear.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
4-5 Other Important Keys
While Treeview's file windows are displayed, you may press the grey "plus" key
to tag files or the grey "minus" key to untag files. These keys are
functionally the same as the F2 function key and can be used to tag files the
same way.
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. You can use this feature to rapidly locate a file anywhere on the
disk. More details on the "find file" feature of Treeview can be found in
Section 5-4.
Pressing the asterisk key [*] will access the user's prior menu selection. If
no selection was previously made, the first (Directories) menu will drop down.
4-6 The Mouse
This section deals with the mouse capabilities built into Treeview. You must
make certain that you have enabled mouse support in Treeview. This is done
from the [Other | Setup Parameters | Other Options | Mouse Support] menu.
After selecting mouse support, save your changes to disk when prompted, then
quit Treeview and restart it. Your mouse will now function throughout
Treeview.
4-6.1 Mice - Generally Speaking
Throughout Treeview, the left mouse button selects an operation, the right
mouse button untags files and escapes out of menus, and pressing both mouse
buttons at once tags files.
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 highlighting it. A rapid double-click of the
left mouse button will attempt to execute the highlighted file (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).
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 desired file and press both mouse buttons. To
untag a file, point to it and press the right mouse button. When the file has
been tagged, an arrow will appear to the left of the filename.
4-6.4 Scrolling Around With the Mouse
In each open file window, you will notice a set of four arrows and the words
"Root" and "Parent" in the upper right corner. These items are also displayed
when looking at the directory tree screen. 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.
By pointing at the word "Parent" with the mouse and clicking on it, you will
move up the subdirectory structure one level, similar to pressing the F3 key.
If you click on the word "Root", you will log into the root directory of the
current drive.
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 left mouse button.
If you have defined your own choice of file viewing programs, this mouse
support may not be the same, so check your listing program's documentation for
mouse support.
4-6.6 Dragging the Mouse
Another concept of the mouse is called "dragging", and it is usually done by
holding down one or both mouse buttons while moving the mouse. In Treeview,
you can select a series of files from a window simply by holding down both
mouse buttons while moving your mouse over the files to be tagged.
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 to almost all mouse operations, we
feel that using a mouse can definitely help the learning curve of this
program. We recommend the use of a Microsoft mouse-compatible device because
it is fully supported by Treeview.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
SECTION 5
ELEMENTS OF TREEVIEW
Treeview is a hard disk file management utility. Its strengths lie in the
ability to copy, move, rename and delete files, change file attributes, sort
filenames, and perform operations on one or more of these 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:\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, PgUp,
PgDn, right and 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. PgUp and PgDn will also move the pointer
quickly through a series of entries. 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 current directory
remains displayed in a different color/video attribute. This is the directory
to which Treeview returns if you press the Escape key or select the [Quit]
option from the directory tree menu bar, regardless of the directory pointer
location.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 of 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 met:
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
by 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 of 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] will 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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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. If you
want Treeview to reread the current drive/subdirectory, use the [New] command
first, then the [Write] command to save the new information.
5-1.1 File Masks
Normally, Treeview displays all files in the current directory whenever you
run it, however you also have the option of forcing Treeview to only show the
files you are interested in processing at the time. This is where the concept
of "file masks" comes in.
Think of a file mask as an easy way to "filter" the types of files that are
displayed. By default, Treeview will display files that match the mask of
"*.*". In other words, ALL FILES. If you set the file mask to "*.MDF" for
example, Treeview will only show files with an extension matching "*.MDF". A
File Mask of "TV.*" will only show files named "TV" with any extension. A File
Mask of "AUTO*.*" will show all files whose names start with the letters
"AUTO". The File Mask is a fast way to select the types of files Treeview will
display.
Another way to control the files that are shown is to TAG the files you want
BY NAME. Then do another TAG operation and SELECT the files tagged. This
performs the same function as specifying a File Mask in that only certain
files in the current directory will be shown.
5-2 Extra File Information
Treeview can display three levels of detail about files stored on a disk. The
level of detail displayed is changed with the Alt-I or [Files | Extra File
Info] command. Each time you select this option, Treeview will "toggle" to
another "level" of detail, from highest detail level to lowest.
A default level of detail can be set with the [Other | Setup Parameters |
Startup Defaults | Extra File Info] options. The lowest level shows only file
names, and is illustrated below:
ANSI.SYS COMMAND.COM DRIVER.SYS
AUTOEXEC.BAT CONFIG.NEW DUET\
BATCH\ CONFIG.OLD DV\
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 last modification date and
time are shown.
An example of the highest level of detail (full file information display) is
shown below:
----------------------------------------------------------------------------
NAME USED ALLOC DATE TIME R H S A
----------------------------------------------------------------------------
ANSI.SYS 4963 6144 7/20/87 1:00:00pm . . . .
AUTOEXEC.BAT 1135 2048 11/27/87 8:01:26pm . . . .
BATCH\ <DIR> <DIR> 11/21/87 5:31:55pm . . . .DIR
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
Each file entry (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 by DOS or reserved for
the file's use. The allocated (but unused) space is not available for other
files to use, and is a good indicator of those files which may be wasting
space. These files frequently include small batch files and text files.
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 medium 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, thus 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:00pm
AUTOEXEC.BAT 1209 3/25/89 1:45pm
BATCH\ <DIR> 2/14/88 11:03pm
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, extension, date, 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. The DOS directory is NOT
modified in any event.
From the Treeview main screen, you can sort the files in the current window by
typing the following keystrokes:
S D [Sort | by Date] (sorts by date) or
S N [Sort | by Extension] (sorts by extension) or
S S [Sort | by Size] (sorts by size)
One of the benefits of sorting files is to logically group 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. For example, this
would be a nice way to use Treeview if you needed to know about only a certain
type of file.
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 largest files would be
shown first, followed by successively smaller files.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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
The File Selection Attributes function will allow you to work with a select
group of disk files, based on the DOS file attributes that the files
themselves have. Attributes are qualities that DOS maintains about each file
to tell it whether a particular file should or should not be displayed
(Hidden), used by the operating system (System), unchangeable (Read-Only), has
been copied (Archive), or is a directory entry (Directory). Check your DOS
manual for more information on file attributes.
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 the
Normal attribute (that is, no attributes at all), the Read/Only attribute, the
Archive attribute, or the Directory attribute will be 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 selection 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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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,
and are the initial values used every time you start the program. 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.
To change attributes of any file(s), please see Section 5-15.
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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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).
You may access this feature by typing the following:
D A [Dir | Show All Dirs] (to see ALL files on the disk) or
D S [ Dir | Show Subdirs] (files in the current directory and below)
This is a "toggle" switch, meaning that the first time the D A command is
used, all files will be displayed in the window. If you issue a second D A
command, only the files in the current subdirectory will be shown.
The Path section of the header displays the directory name of the current file
so that you can tell which directory a given file resides in when the 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 would not change from file to file.
Selecting [Dir | Show All Dirs] or [Dir | 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 just two of Treeview's most powerful features.
In these modes, you can work with all the files on any disk (or in a given
directory tree) just as easily as you could with the files in any single
subdirectory.
Some examples of Show-All/Show-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].
Keystrokes used to perform this operation would be:
D A T N *.BAK(enter) F E T Y
(Directory Show-All, Tag by Name all ".BAK" files, File Erase Tagged YES)
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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
AUTOMENU\ CONFIG.SYS DUET\ LIB\
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 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 of 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 most
DOS versions. Refer to your DOS manual for more information on the PRINT /D
command option.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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. Programmers (or anyone)
who use multiple subdirectories for source files will appreciate the ease of
updating files in their choice of target directory.
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. If you have opened a window into
the target directory, just pressing the PgUp or PgDn keys will automatically
fill in the information needed for the update.
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 they are
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, providing they are more recent versions. Files in the source
directory but not in the target will NOT be copied if this option is turned
on. Please note: Because Treeview uses the creation/modification date and
timestamp to determine if the files are the same or not, it's important that
your computer's date and time be accurately set for this command to work
properly. If your system doesn't have a real time clock, make sure the date
and time are set correctly whenever the computer is turned on or rebooted.
5-9 Window Commands
Treeview can display from 1 to 6 file windows on the screen at a time. Each
window is independent of the others and can display the same or a different
drive and/or 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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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.
To close a file name window, just place the file pointer in the window to be
closed and press F8 or W C [Window | Close]. Closing a file name window
removes the window from the screen display. It has no effect on the files
themselves, it simply removes the window from the screen.
Windows are very useful when working with two or more directories or drives 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 does not restore files that have already
been processed, but it can keep further files from being modified. If another
DOS command is named in the operation, Treeview will attempt to continue
processing with that command, so the following note is placed here to suggest
otherwise.
WARNING: We recommend that you do NOT interrupt tagged file operations that
involve more than one DOS command (i.e., COPY $T $T.BAK^DEL $T^ECHO ALL DONE).
Treeview may continue processing files with the following command if there are
more than one in the prototype. Please check Section 6-2 for more on DOS
Command Macros.
5-11 DOS Command Recall
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 the insert mode on and off, allowing
existing data to be typed over (when off) or new data to be inserted (when
on). The cursor is made larger when the 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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
The up and down arrow keys can also be used when entering a response. Treeview
keeps track of 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
alternate 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. A 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 Enter key, X C, or Alt-X key [eXecute | Current
File] to 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 at 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 (on the numeric keypad) 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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
You can also use the menu bar option at the top of the screen called
Tag/Untag. Do this by pressing the letter "T". You are given the option of
tagging files by name by specifying a file mask that fits the files you want
to process. You can specify "*.BAK" to tag all files with the extension .BAK,
or "STAR.*" to tag all files with the name STAR.
There are other options under the Tag/Untag function that will allow you to
select files by date and time, all files not already tagged, files with
today's date, and files with the archive attribute set (Modified). 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.
When prompted for the destination, you can use the PgUp and PgDn keys to
access the names of the directories into which windows are currently open, or
you can point at the small letter "T" on the top of the destination window.
This will bring up a graphic directory tree that you can point to your
destination and double-click the mouse button. The same will happen if you use
the Alt-T command.
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 the subdirectory name when Treeview asks for
the destination (D:\FileDirectory, etc.). An easy way to copy files is to open
one window into the source directory and one into the target directory. Then
after tagging the files to be copied, give the F C T command, and when
prompted for the destination, press PgDn, then Return. Treeview will copy all
tagged files quickly and easily!
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 or moving. 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, and does not require additional space
be available on disk for the newly named file.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 Enter
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 of the screen.
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" for details on configuring your own external functions.
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 that will be discussed in
Section 5-14, and makes use of the DOS macros that are 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.
Using the example above, if the highlight bar is placed over a file called
MYFILE.TXT on the C: drive in the \TEXT subdirectory, the command passed to
DOS would be
EDITOR C:\TEXT\MYFILE.TXT
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 enter key to use this data, or input
your own data and then press enter.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
You can also use the up and down cursor keys to "recall" a previously entered
date or time, so if you are changing these attributes on many files, this
"automatic command recall" feature can save you quite a few keystrokes.
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.
5-14 Command Prototypes
Treeview allows you to build your own series of DOS commands to be executed at
a variety of points in the program. There are User Defined Keys (UDK), DOS
Command Macros (DCM) and the Point-and-Go (P&G) commands, all of which are
made up of what are called "Command Prototypes".
A Command Prototype is nothing more than a string of characters that includes
one or more DOS commands and one or more Treeview macro characters ($T, $F,
etc.). To Treeview, this represents a "prototype" (working example) of the
command that you want carried out, and usually takes the following form:
DOS_Command [TV_Macro]...^DOS_Command [TV_Macro]...
where DOS_Command is a valid program or instruction, and TV_Macro is one of
the Treeview macro characters as discussed in Section 6-2. This Command
Prototype is the instruction that tells Treeview what actions to take whenever
the user invokes the command. Here is an example of a Command Prototype:
ECHO $T >> DIRS^PKZIP -A ZIPFILE @DIRS^DEL DIRS^ECHO DONE
This prototype has three parts, each separated by the "^" (caret) symbol. The
three parts break down as follows:
1. ECHO $T >> DIRS
This instruction tells Treeview to ECHO (write) the name of every TAGGED file
($T) to another (temporary) file called DIRS. This will create a file (DIRS)
with the names of all tagged files in it.
2. PKZIP -A ZIPFILE @DIRS
This command calls Phil Katz's fine file compression utility program PKZIP and
instructs it to create a single compressed file called ZIPFILE and to place in
it all the files listed in the file DIRS. This means that you can tag a series
of files, press a User Defined Key and perform this operation on all the files
at the same time with a single keystroke.
3. DEL DIRS
This will delete the temporary list file named DIRS, as it was only needed for
the execution of this particular prototype.
4. ECHO DONE
This last directive will ECHO (write) a message on the screen to tell the user
that this operation is "DONE". Command Prototypes are used throughout
Treeview, and more discussion on this and related subjects will be found in
the next section.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
5-15 Displaying and Resetting File Attributes
Treeview can easily display and/or modify the attributes of any DOS file.
There are two ways to display the attribute of any file. First, you can elect
the most detail from the file window with the ALT-I command. This will show
you not only the file attributes, but also the file size and the last date it
was modified. The other way is to place the file pointer over the filename and
use the ALT-A command. This will bring up a window that will not only show you
the current attributes of the file, but also give you a chance to change them.
To change a single file's attributes, place the file pointer over the filename
and press ALT-A. Press the letter(s) of the attribute(s) to be changed, then
press C to write the change to disk. Treeview will then return to the main
file display and await your next command.
To change the attributes of multiple files, tag the files desired and then
press ALT-B. Press the letter(s) of the attribute(s) to be changed, then press
C to write the changes to disk. Treeview will then return to the main file
display and await your next command. Attributes that can be displayed and/or
modified with this version of Treeview are detailed in Section 5-3, File
Selection Attributes.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 the different
types of text is to change the colors and observe the results.
When you select the [Other | Setup Parameters | Screen Colors] command, the
display shows the types of text that can be selected, and the color
combinations allowed. 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 save 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 "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 name.
$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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
Macro examples:
TYPE $C
Runs the DOS TYPE command on the current file. If the file pointer was on the
file TV.DOC, the command is executed as:
TYPE TV.DOC
which will type (display) the text file to the screen. 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 $ signs. The command
COPY *.C $$D /V
is executed as:
COPY *.C $D /V
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
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 of 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 Section
6-6, USING 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 a normal DOS executable program
(.COM or .EXE) or as a batch file command (.BAT). If the file has an extension
other than .COM, .EXE, or .BAT, Treeview searches a table of user-defined 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 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 $xc.old
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 can
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 several Point-and-Go entries might
look:
NUM EXT 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 previously. 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. There is a limit of 50 characters to any one Point-and-Go key.
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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 pkzip -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 PKZIP with two parameters; the
letter V and the name of the current file. PKZIP is a popular program for
maintaining compressed files. Moving the file pointer to a .ZIP file and
pressing Alt-F2 would list (view) the contents of the .ZIP 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 can 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. There is a limit of 50 characters in any one User
Defined Key.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
6-6 Using EMS 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. Normally there is 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 are
able to access 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 since
Treeview will then use conventional memory. 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 to Section 3-1, Command Line Parameters, for
more information.
Remember: if you want the changes you make to become permanent, be certain to
save the new values to disk when prompted. By default, Treeview considers all
changes made to be temporary, so if you wish the changes to become the new
defaults, you MUST save them.
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
Video "snow" is best described as little flashes of light on your monitor
screen. Sometimes caused by clone CGA video cards, snow is a distracting
nuisance that can be avoided by setting Treeview to write to the screen
through the BIOS, instead of directly to video memory.
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 will NOT 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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 to Section
3-1, 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 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 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 Command Macro. For example:
LIST $F
will instruct Treeview to use Vern Buerg's fine LIST program and pass to it
the current file including pathname ($F) 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" for the editor.
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 Enter. 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 the length of time required to 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.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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, Inc.
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. We hope that
you will agree that the registration 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 payment 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. Call or write to Magee Enterprises, Inc. for more
information.
7-2 How to Register
If you use Treeview on a regular basis, you should print out and complete the
file REGISTER.FRM 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.
The reasonable registration fee establishes you as a registered user of
Treeview and upon our receipt , you will be mailed a diskette containing the
most recent Treeview version, a printed manual, extended technical support,
notice of product updates, and our multiple line, 24 hour networked bulletin
board service (The Big Peach BBS). 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, as well as all the above mentioned materials.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 Directory
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)
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
OTHER
C Selection Criteria
A by 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 Wait
1 Extra File Info (1 column)
2 Extra File Info (2 columns)
T Copy Options
D Use DOS Verify
O Overwrite Check
D Dir Tree Options
D Select Drives to Always Write
P Prompt to Write when changes
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 NAME EXT
E Use EMS Memory
F Sound Effects
M Use Mouse (if available)
S Video Snow Checking
4 Use EGA 43/VGA 50 Line Mode
X Esc Exits at Top Level
W Write Setup to Disk
V Toggle DOS Verify
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
SORT
N by Name
E by Extension
D by Date
S by Size
U Unsorted
A Ascending
C Descending
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
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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
A Attributes
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
M Mouse
M Menus
P Parameters
R Registration
S Screen
Q Quit
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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
[Note: "^R" means to hold down the Control key and press the letter R.]
^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
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
Other Keys Used in Treeview
= Find File in current window
+ Tag Current File in window
- Untag Current File in window
* Access last used menu item
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
APPENDIX D
DOS COMMAND MACROS
Macro Substitution
$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 using DOS Macros
(50 Characters maximum length)
del $xc.old^ren $xc.bak $xc.old^ws $xc.old
(Delete a file, then rename the backup file and edit it)
echo $t >> dirs^pkzip -a zipfile @dirs^del dirs
(Copy each tagged filename into a file called DIRS, then create a compressed
file from that list and then delete the list)
command [parameter(s)]^command [parameter(s)]^command ...
(Generic implementation of multiple DOS commands )
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
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 bug-free product but
sometimes we make mistakes. If you think you have found something please take
the time to contact us and explain it to us. Make sure that you include the
following information to help us evaluate your situation:
1. Your product SERIAL NUMBER (Registered Users have serial numbers)
2. Version of DOS you are using
3. Machine type, memory, monitor type, hardware description
4. Any application executed before Treeview
5. Your address and telephone number (when corresponding)
6. Where, when and how you obtained Treeview
7. Which version of Treeview you are using
8. Printouts of your AUTOEXEC.BAT and CONFIG.SYS files
We also provide a networked electronic Bulletin Board System (BBS) for anyone
interested in Treeview, Automenu(R), or Shareware in general. This board
currently supports 1200, 2400, 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 and Automenu, 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
and 4pm Eastern Time, Monday through Friday, and their direct line is
404-662-5387. We also have a 24 hour FAX line available at 404-368-0719.
Users will always receive a response to their questions. Non-registered users
will receive a written response if they enclose a self-addressed, stamped
envelope with their inquiry.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
APPENDIX F
TREEVIEW AND THE DISK OPERATING SYSTEM (DOS)
Treeview is a sophisticated, powerful software tool, and as such requires a
bit of knowledge on the part of the user. In fact, the more you understand
about the DOS, the better you will be able to use Treeview.
WHAT IS DOS?
DOS is really SOFTWARE for the computer that allows it to deal with disk
drives, both floppy and fixed (hard drives). The computer is actually a very
"dumb" appliance, and can only function in the manner prescribed by the user.
By starting up the PC, DOS will load automatically, and then tell you that it
is ready for further instructions. Typically, most garden-variety computers
show a "prompt" (ready to do something) such as this one:
C:\>
Let's face it - it doesn't take a rocket scientist to know that this prompt is
anything but friendly. How can you know what to do next when the computer
won't show you your choices?
DOS is really a collection of programs, and that's why we refer to it as a
"system" - there is more than one element to it. DOS starts to work each time
you "boot" (power up) your machine, loading a pair of hidden files (they are
not shown in a DIRectory listing) and then checking for a couple of more
(CONFIG.SYS and AUTOEXEC.BAT), and if they exist, they are loaded into memory
and we are off and running!
Of course, DOS is of no use whatsoever without a computer that can run it. You
might say that there is a very close relationship between DOS and the computer
- without each, the other would be useless. That's why you usually receive a
copy of DOS whenever you purchase a new PC. In a real sense, DOS is THE most
important program your computer can run!
HOW DOES DOS WORK?
We can classify the general operations of any computer in four simple steps:
INPUT
PROCESS
STORAGE
OUTPUT
This is what we are going to call the "IPSO Facto". All computer operations
can be broken down into one of the above, and if we try to categorize all the
things we do with our PCs, we will find that they fall into one of these
areas. For instance, when we turn on our computer, and it sits there waiting
for us to do something, we could say that it is ready to accept INPUT. When we
type a command that the computer recognizes, we say that it is PROCESSing that
request. If we save a file, STORAGE comes into play, and whenever we print
something, or display anything on the monitor, we are using the computer's
OUTPUT function.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
Most everything that the PC can do will be able to be classified under one (or
more) of the above headings. Even programmers can make life much easier for
themselves by organizing their particular language into this kind of
arrangement.
WHY IS FILE MANAGEMENT SO IMPORTANT?
Treeview was designed to help in the process of dealing with all the files
that can be generated by the OUTPUT process mentioned above. When you run
programs, files are usually created (or changed). Take your word processor
(WP), for example. When you run it, it asks for the name of the file to be
edited and opens it. If you wish to create a new file, then the word processor
creates (OUTPUTs) a new one. If you change a file, some WP programs will leave
the original file on the disk and simply rename it. When you save the file, it
is written (OUTPUT) to the disk drive.
After a while, we could have a serious number of files on our hands - and
that's just from the word processor! If you use a spreadsheet program, or a
graphics program, or a database program, the same might be true. Files, files,
files. What are we going to do with all of them? Well, for starters, we need
to organize them!
WHAT IS A DIRECTORY?
Because the typical hard drive is capable of storing so much data, we need
some easy method of sorting and organizing the files that are there. DOS has
an important capability to create "logical" divisions on the disk called
directories, and to keep track of what is called the "current directory". The
current directory is very simply the one you are in at any given moment.
If you can imagine a file cabinet that has only one drawer, you begin to see
what we are talking about. One large drawer in a cabinet really has no way to
separate the mass of materials that will be STOREd there, so we use more than
one drawer to keep logically similar data in the same place. Think of these
"drawers" as directories, and the entire hard drive as a filing cabinet. If we
then further break down each drawer into file folders, we begin to simulate
the same structure that DOS uses to keep track of all the files on the disk.
If you ran a business, you would file similar paperwork together and create a
filing system that allowed you (or anybody else) to access any of that
paperwork in a fast and efficient manner. Similarly, the DOS filing structure
employs directories (and SUBdirectories) to keep apart different files, and to
keep together related ones. When we speak about DOS directories, we should
envision a kind of "tree" structure that begins at the "root" and branches out
into a variety of directories (and SUBdirectories, which are directories
underneath other directories). This is how Treeview got it's name - it helps
manage the tree structure of your disk and keeps all the "leaves" (files)
swept up and in neat order.
Your hard disk may be organized, and it may not be, however one thing is
certain: the more order you keep on your computer's disk, the easier it is to
make BACKUPS (copies) that can be a real life saver if there is a hardware
problem (disk crash, for example). The benefits of proper disk organization
are many and great. Take some time and use Treeview to display the structure
of your disk drive. Is there a "tree" there? Are similar files grouped into
individual areas (directories)?
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
We cannot begin to explain all the intricacies and inner workings of DOS here,
so we must advise you to take a look at your DOS manual or one of the books
listed below. The time you invest in learning about your computer's most
important software will be worth it many times over. Also check into your
local computer club or user's group - they are a tremendous resource for
getting answers to questions you might have. In fact, there are answers
waiting for questions at the next meeting of many, many computer groups, so
take advantage of the situation, and learn more about DOS.
RECOMMENDED READING FOR DOS USERS
There are many good books on using the hidden powers of the Disk Operating
System, and if you want additional background on using and learning DOS, try
one or more of these fine volumes:
RUNNING MS-DOS (3rd Ed.), Van Wolverton, Microsoft Press
This is probably the very best of the "aftermarket" DOS books, not just
because it's published by Microsoft, but because Van has taken an easy going,
almost casual approach to teaching the fundamentals of DOS. He begins by
explaining what DOS is, how it gets the computer started, and how it organizes
files and disks (hence it's name: Disk Operating System). He then goes into a
very understandable explanation of managing files and devices, hard disk
organization, system controls and tailoring, local area networks and more.
Several appendices are included, one that tells how to prepare a hard disk and
another that details the syntax of every DOS command. This is the best book
for the first time DOS user. Highly Recommended!
SUPERCHARGING MS-DOS, Van Wolverton, Microsoft Press
As a follow-up to the title above, Van takes the DOS user deeper into the
system functionality with chapters on things like printer "languages", using
the DOS DEBUG utility, controlling the environment with CONFIG.SYS, system
customizations, care and feeding of the computer, and much more. A Quick
Reference section is set up to answer questions about ANSI.SYS drivers and
hexadecimal codes. Definitely NOT for the beginner, SUPERCHARGING is still one
of the "must-have" books in any DOS user's library. Also Highly Recommended!
MS-DOS BIBLE, Steven Simrin, The Waite Group
Also geared for the beginners, this volume stretches the technical side a bit
more than RUNNING MS-DOS, and even includes a tutorial on booting DOS,
formatting diskettes, installing and changing drives, filenames and
extensions, copying files, batch files, redirection and piping, EDLIN (the DOS
line or text editor), and much, much more! This one is definitely for those
who have a foundation of knowledge in DOS, and will take you even further than
the SUPERCHARGING MS-DOS mentioned above. A fine reference work for daily use,
this book will provide many hours of ready information on all aspects of DOS.
Recommended.
TRICKS OF THE MS-DOS MASTERS, The Waite Group
For users with a previous knowledge of DOS, TRICKS will show you insight and
techniques not published anywhere else. According to the authors (four of
them!), this volume is for serious business and personal users, software
developers and consultants, and "power users". This book will open your eyes
to some of the more arcane tips and practices for stretching DOS to the max.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc.
MS-DOS BATCH FILE PROGRAMMING, Ronny Richardson, Tab Books
This is a definitive reference to those who wish additional insight into the
mysteries of programming directly within the operating system (DOS).
Everything from simple batch files to replaceable parameters, looping and
control flow, and the AUTOEXEC.BAT and CONFIG.SYS files are covered. A
reference to DOS commands is included, and many examples are used throughout.
If you are DOS-literate, this volume will certainly assist in creating more
imaginative and powerful batch procedures that will be easily controlled from
within TREEVIEW or AUTOMENU. Recommended.
This is definitely NOT intended as any kind of complete resource listing of
available DOS publications. You should refer to a local PC Users Group for the
best advice. And keep checking the Magee Enterprises BBS (The Big Peach) for
updated information and tips and tricks on using DOS and Treeview.
MS-DOS is a registered trademark of Microsoft Corporation. Treeview is a
trademark of Magee Enterprises, Inc. Automenu is a registered trademark of
Magee Enterprises, Inc. All rights are reserved worldwide.
The above listing is only provided as a public service, and Magee Enterprises
Inc. is in no way connected or involved with any of the above companies,
authors or publications. We do, however, feel that in the interests of
furthering knowledge about computers and DOS in general, it is necessary to
provide some kind of reference listing for our user's further investigation
and comprehension.
Treeview 1.1 Copyright 1988,1989 Magee Enterprises, Inc..End of Treeview Documentation.