TreeTop USER'S MANUAL Kilgore Software P.O. Box 2291 West Sacramento, CA 95691 (916) 371-3715 Copyright 1989 TreeTop All rights reserved, worldwide. Notice of Liability: The information in this manual and the TreeTop software package is distributed on an "As Is" basis, without warranty. Neither the author nor Kilgore Software shall have any liability to any person or entity with respect to any liability, loss, or damage caused or alleged to be caused directly or indirectly by the instructions in this manual or the software itself. Published by Kilgore Software Copyright (c) 1989 by Kilgore Software Version 2.34 ISBN 0-9624863-0-2 IBM, IBM-PC, PC-DOS are trademarks of International Business Machines MS-DOS is a trademark of Microsoft Corporation TreeTop TreeTop is a shareware (user supported) product. You are granted a free 30 day license to use TreeTop and you may make as many copies as you like. You may also distribute copies of TreeTop to other users as long as you accept no compensation from them. If you find TreeTop useful and wish to continue using it after the 30 day license period, you may obtain a permanent registration (and manual) by submitting the license agreement (see file TREETOP.DOC) and appropriate registration fee to: Kilgore Software P.O. Box 2291 West Sacramento, CA 95691 (916) 371-3715 or call toll free: 1-800-TREETOP Registration, disks, and manual ........... $39.00 Contents ====================================================================== 1 Introduction Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 What Is Shareware . . . . . . . . . . . . . . . . . . . . . . 2 TreeTop Registration . . . . . . . . . . . . . . . . . . . . . 2 If You're New to DOS . . . . . . . . . . . . . . . . . . . . . 2 Executing TreeTop . . . . . . . . . . . . . . . . . . . . . . 3 Point and Shoot Interface . . . . . . . . . . . . . . . . . . 3 Context Sensitive Online Help . . . . . . . . . . . . . . . . 4 The Key . . . . . . . . . . . . . . . . . . . . . . . . 4 The Mouse Interface . . . . . . . . . . . . . . . . . . . . . 4 Pull Down Menus . . . . . . . . . . . . . . . . . . . . . . . 5 2 Installation System Requirements . . . . . . . . . . . . . . . . . . . . . 6 Initial Installation . . . . . . . . . . . . . . . . . . . . . 6 Installing a Mouse . . . . . . . . . . . . . . . . . . . . . . 8 User Setup . . . . . . . . . . . . . . . . . . . . . . . . . . 8 3 Directory Operations The Directory Service Screen . . . . . . . . . . . . . . . . 11 Select a Directory . . . . . . . . . . . . . . . . . . . . . 13 Select All Directories (Global) . . . . . . . . . . . . . . 13 Add a Directory . . . . . . . . . . . . . . . . . . . . . . 14 Delete a Directory . . . . . . . . . . . . . . . . . . . . . 14 Rename a Directory . . . . . . . . . . . . . . . . . . . . . 15 4 File Operations The File Service Screen . . . . . . . . . . . . . . . . . . 16 About File Operations . . . . . . . . . . . . . . . . . . . 18 About Tagging Files . . . . . . . . . . . . . . . . . . . . 18 Tag/Untag a Single File . . . . . . . . . . . . . . . . . . 20 Tag/Untag Multiple Files . . . . . . . . . . . . . . . . . . 21 Set File Display . . . . . . . . . . . . . . . . . . . . . . 23 Retag Files . . . . . . . . . . . . . . . . . . . . . . . . 23 Find a File . . . . . . . . . . . . . . . . . . . . . . . . 24 Edit a File . . . . . . . . . . . . . . . . . . . . . . . . 24 Execute a File . . . . . . . . . . . . . . . . . . . . . . . 25 Set File(s) Attributes . . . . . . . . . . . . . . . . . . . 26 Set File(s) Date/Time . . . . . . . . . . . . . . . . . . . 27 Set File Selection Masks . . . . . . . . . . . . . . . . . . 28 Set Tagged File Mask . . . . . . . . . . . . . . . . . . . . 30 Sort Files . . . . . . . . . . . . . . . . . . . . . . . . . 30 Copy File(s) . . . . . . . . . . . . . . . . . . . . . . . . 31 Move File(s) . . . . . . . . . . . . . . . . . . . . . . . . 33 Delete File(s) . . . . . . . . . . . . . . . . . . . . . . . 34 Print File(s) . . . . . . . . . . . . . . . . . . . . . . . 35 Rename a File . . . . . . . . . . . . . . . . . . . . . . . 35 File Speed Search . . . . . . . . . . . . . . . . . . . . . 36 Hex File Dump . . . . . . . . . . . . . . . . . . . . . . . 36 View a File . . . . . . . . . . . . . . . . . . . . . . . . 37 Contents cont. ====================================================================== 5 Miscellaneous Operations Registration Information . . . . . . . . . . . . . . . . . . 39 Available Disk Space . . . . . . . . . . . . . . . . . . . . 39 Logging to a Different Drive . . . . . . . . . . . . . . . . 39 Setting the Disk Volume Label . . . . . . . . . . . . . . . 40 Scanning the Current Drive . . . . . . . . . . . . . . . . . 40 Shelling to DOS . . . . . . . . . . . . . . . . . . . . . . 40 Exiting TreeTop . . . . . . . . . . . . . . . . . . . . . . 41 INDEX TO OPERATIONS . . . . . . . . . . . . . . . . . . . . . . 42 Section 1 Introduction ===================================================================== Overview ------------------------------------------------------------ TreeTop provides a powerful, quick and easy to use interface between you and your computer's operating system. TreeTop's menus use single key commands to perform most file and directory operations with a fraction of the keystrokes required by DOS. The graphic representations and "Point and Shoot" interface help even the newest users of DOS understand and manipulate directories and files. Mouse users can take advantage of TreeTop's full mouse interface. Whether you are doing hard disk housekeeping, reorganizing your directory structure, or simply copying files, TreeTop makes it a breeze. Some of the features found in TreeTop are: o Fast and user friendly o Pull down menus o Context sensitive help o User installable setup o Full color or monochrome support o Shell to DOS o Execute COM, EXE, and BAT files o Mouse support (not required) o Sort files by name, extension, size, date/time, ascending or descending order o Copy, move, delete, rename, or print single files or groups of files o Add, delete, and rename directories o Select and operate on files in a single directory or in the entire logical drive o Select files by wildcards, date/time, attributes, or individually o Change file's date/time or attributes o Find files with speed searching o Disk and directory status display o View files in hex or text format o Set, rename or delete disk volume labels page 2 What is Shareware --------------------------------------------------- Shareware is commercially available software usually sold directly from the software company or the author. With shareware, the user has the advantage of fully testing the software on his system, at his leisure, before he makes a decision to purchase it. The user may obtain the software from any source, such as electronic bulletin boards or other users, and evaluate it free of charge for a period of time (typically 30 days) to determine if it fits his or her needs. At the end of the evaluation period, he must purchase the software if he wishes to continue using it, or remove it entirely from his computer(s) and discontinue its use. If it does fit his needs and he purchases the software, he is entitled to the privileges outlined in the purchase/license agreement. Typically, this includes documentation and the latest version, technical telephone support, and notifications of updates or changes that the user may be interested in. Users of shareware are encouraged to distribute copies of the software, as per the license agreement, to other potential users for evaluation purposes only. TreeTop Registration ------------------------------------------------ TreeTop is a commercial shareware product that represents a very significant investment of time and money. Thousands of man-hours have been devoted to its design, programming, testing, and distribution. Many more hours will be spent on user support and software updates. The shareware marketing concept for TreeTop can only work if you, the user, register when you decide to continue using it. By registering, you will help offset the initial development costs and support the development of enhancements and updates. As a registered TreeTop user, you will have the privilege of technical telephone support as well as notifications of changes and updates. Please see the Purchase/License agreement supplied on the TreeTop disk (filename TREETOP.DOC) for specific details if you have not already registered. If You're New to DOS ------------------------------------------------ DOS (Disk Operating System) is the system that controls your computer and its peripheral devices. When using your computer for word processing, accounting, or any other applications, you create data files associated with them. DOS manages the computer's disk drives and the files they contain and consists of a set of commands that are normally typed in along with the file and directory name you wish to operate on. Using DOS can be a tedious and time consuming process, and it's easy for the unwary user to make errors from which its difficult to recover. By using a set of menus with single key commands and user prompts, TreeTop eliminates most of the keystrokes, reducing of the chance for error. page 3 Directories and Files Hard disks found on microcomputers today can accommodate thousands of files. Keeping track of many files in a single location is unwieldy, so DOS allows you to divide your hard disk (or a floppy disk, for that matter) into a series of directories and subdirectories where similar types of files can be grouped. For example, word processing data can be stored separately from spreadsheets and drawings. This method of directory and file management is commonly called "tree" structured. Your diskette or hard disk can be thought of as having a base or root which branches into smaller and smaller areas in which files can be stored - and hence the name TreeTop. You can also think of your diskette or hard drive as a file cabinet with a set of drawers (the directories.) Each drawer can hold file folders (the subdirectories) which can in turn hold more file folders or your individual files. The only limit to the number of branches (directories and files) your hard disk may contain is the size of the disk. That's about all the DOS information you need to understand to get started using TreeTop effectively. If you have additional questions about DOS, refer to your DOS User Reference. Executing TreeTop --------------------------------------------------- When properly installed, TreeTop can be executed at the DOS prompt from anywhere on your system (See Initial Installation under the Installation Section.) Normally you only need to type TT then press to execute (or run) TreeTop. TreeTop automatically scans your logged drive for all files and directories. If you wish TreeTop to automatically scan a drive you are not logged onto, you can type TT [drive] (where the drive is actually the drive letter and you don't type the brackets.) You can also change the logged drive after TreeTop has loaded (See Logging to a Different Drive under Miscellaneous Operations.) Point and Shoot Interface ------------------------------------------- TreeTop was designed around a visual "directory tree" image of your hard disk. Using this directory tree structure, you can easily execute nearly every command with the "Point and Shoot" concept. When you first run TreeTop, the Directory Service Screen is displayed with a graphical representation of the directory structure of your hard disk. The logged directory when you executed TreeTop will be highlighted on this tree. If you wish to list the files in a different directory, simply move the highlighted bar to the desired directory using the arrow keys or click on that directory with your mouse cursor. This is the "Point" part of the "Point and Shoot." page 4 Now press or click again on the highlighted directory with your mouse cursor to change to the File Service Screen; the "Shoot" part of the "Point and Shoot." This gives a sorted list of files for that directory. You can do many other operations as well. For example, if you want to delete the directory that is highlighted, you would press D to delete it. It's that easy. The same "Point and Shoot" interface also applies to the File Service Screen. If you want to copy a single file, you would first highlight that file using the arrow keys or click on the desired file with your mouse cursor (the "Point" part), then press C or click on Copy with your mouse cursor (the "Shoot" part.) You would then be prompted for the destination to copy to. There are many directory and file operations you can execute in this manner, with shortcuts to help speed things along. Context Sensitive Online Help --------------------------------------- TreeTop provides a generous amount of online help when needed. Hopefully, you will not have to use the help often because TreeTop is designed to be as intuitive as possible. However, if you want help, simply press F1 at any time for a help screen. TreeTop will display a help screen that best fits the context of where you are in the program. You are not limited to that help screen. If you want other help, you may press I while viewing any help screen to get an index of other help screens. This index is actually a menu from which you can view any help screen. When done viewing help, press to return. The Key ------------------------------------------------------- The escape key is a very important key for TreeTop. It is used for returning to a previous screen, exiting TreeTop, backing out of an operation you selected, or cancelling an operation that is currently running. Basically its a safety key you can hit whenever you start something that you don't want to finish. Selecting a menu item will often prompt you for a Yes/No answer. Pressing the escape key will cancel that prompt altogether and return you to the screen you were working from. You don't have to worry about whether or not you should cancel an operation while it is running. If you don't understand a prompt, or you want to stop what you have started, just press . The Mouse Interface ------------------------------------------------- If your computer has a mouse, you can make even better use of TreeTop. Generally speaking, you can move the mouse cursor to a menu item on the screen, click on that item (press the left mouse button) and accomplish the same thing as pressing the highlighted key for that menu item. You can also select the highlighted directory or file by simply moving the mouse cursor to the desired directory or file and clicking on it. If the desired directory or file is not in view on your screen, you can scroll to it by clicking just outside of page 5 the box that surrounds the files or directories. If you keep your finger down on the left button, it will continue to scroll automatically until you release the button. Pressing the right mouse button is exactly the same as pressing at the keyboard. This gives you the ability to operate TreeTop using the mouse with virtually no keyboard interaction. The only time you must use the keyboard is to type file or directory names when prompted to do so, or when selecting help screens from within help. Pull Down Menus ----------------------------------------------------- TreeTop utilizes pull down menus. These menus are designed to be fast and easy to use by both mouse and non-mouse users. In all cases, the pull down menu will give you a vertical list of items to choose from. You may select a menu item by pressing the highlighted key for that item or by moving the highlighted menu bar (using your up and down arrow keys) to that item and pressing . If you have a mouse, you can drag the highlighted bar to the desired menu item, then select it by pressing the left mouse button. If you change your mind and do not want to make a selection on the pull down menu, just press your right mouse button, or select the CANCEL menu item, or just press at the keyboard. Some of the pull down menus will execute your request immediately upon selection. Other pull down menus require you to accept your selections with the ACCEPT option at the bottom of the menu. The menus that require you to accept selections do so because there are multiple choices possible. This gives you the ability to select several items on the menu; when you have finished, select the bottom line, ACCEPT, to confirm your choices. You can also press to cancel the menu. Section 2 Installation ===================================================================== System Requirements ------------------------------------------------- TreeTop is compatible with IBM PC computers and IBM PC clones that use the PC-DOS or MS-DOS operating system (often just called DOS computers.) Your computer must have at least 256K RAM and be running a DOS operating system version 2.0 or greater. Computers that have a large number of files on the hard drive (i.e., over 1000) may need slightly more memory than 256K RAM. Although TreeTop will run just fine on a "floppy-only" computer system, you will be better able to make use of TreeTop if your computer has a hard disk drive as well. TreeTop will operate on most video cards and can be used on monochrome or color monitors. TreeTop will run fine on a monochrome display adapter or a Color Graphics Adapter (CGA), but it will provide the best display if you are using an Enhanced Graphics Adapter (EGA) or a Video Graphics Adapter (VGA) card. Initial Installation ------------------------------------------------ This installation describes how to load TreeTop onto your hard disk drive and modify your AUTOEXEC.BAT file so that it will run at its optimum performance. TreeTop consists of three files that must be on your hard disk drive for proper operation and two other files that you may want to include for easy reference. These files are listed below with a brief explanation for each of them: 1) TT.EXE This is the main executable file that is run when you execute TreeTop. 2) TREETOP.HLP This is the file that contains the online, context sensitive help for TreeTop. If this file is not on your hard disk drive, TreeTop will still operate properly, but you won't have any online help. page 7 3) TREETOP.PAR This file contains the user defined setup parameters for TreeTop. It is created automatically if it doesn't already exist when you save the setup parameters. (See the next section on user setup.) 4) TREETOP.DOC This is a text file that has a copy of the Purchase/License agreement for TreeTop. 5) README.TXT This file contains the latest information on TreeTop that may not be reflected in the bound manual. There are two installation requirements that must be met for TreeTop to operate properly on your computer. You must first copy the file TT.EXE to a directory on your hard disk drive that is included in the global path variable. That will insure the execution of TreeTop from anywhere on your system. The second requirement is that you set up an environment variable that instructs TreeTop to find its help (TREETOP.HLP) and parameter (TREETOP.PAR) files in the correct directory. The easiest way to install TreeTop is to create a directory on your hard disk drive called TREETOP, then copy all of the above files to that directory. You must also edit your AUTOEXEC.BAT file to include the directory TREETOP in the path command and set an environment variable that tells TreeTop where to find its files. You can do this by following the steps outlined below: 1) Choose the drive on which you wish to install TreeTop. The following example assumes drive C:. Note: After each command listed below, press to execute. 2) Create the TREETOP directory by using the "make directory" DOS command, MD. MD C:\TREETOP 3) You can now copy all the files from your master floppy to the TREETOP directory using the DOS copy command. If your master disk is in floppy drive A:, type COPY A:*.* C:\TREETOP 4) You must also edit your AUTOEXEC.BAT file so that each time you boot the computer TreeTop will know where to find its help and parameter files. To do this , include the following line in your AUTOEXEC.BAT file: SET TREETOP=C:\TREETOP 5) The last thing you must do is edit the path command in your AUTOEXEC.BAT file to include the directory, C:\TREETOP; in the path variable. You should reboot your computer when you have completed the above five steps. After rebooting, you can run TreeTop by simply typing TT from the DOS prompt anywhere on your system. page 8 Note: You should only edit your AUTOEXEC.BAT file in a non-document ASCII mode (also known as DOS ASCII or text mode.) If you are not familiar with your autoexec.bat file or how to edit it, you should read your DOS manual and/or get some help from a knowledgeable person. Most editors or word processors provide a way to edit files like autoexec.bat. Check your editor or word processor manual if you are not sure. Installing a Mouse -------------------------------------------------- To use your mouse with TreeTop, you must first load the standard Microsoft (or Microsoft compatible) mouse driver. There are two different ways to load a mouse driver. The first and most common way is to include a line in your CONFIG.SYS file that instructs the operating system to load the mouse driver every time you boot. The other way is to execute a .COM file from the system prompt or from your AUTOEXEC.BAT file that loads the mouse driver. See the manual that accompanied your mouse for specific instructions on how to load your mouse driver. User Setup ---------------------------------------------------------- The user setup is different than the initial installation because it allows you to customize certain default conditions that TreeTop will use each time it is run. The user setup is not mandatory since the default setup on your master disk is configured for common settings. You may not need to make any changes, although you should at least view your choices. To examine the current settings for TreeTop, simply run TreeTop by typing TT at your system prompt. Then, from the Directory Service Screen, select the setup menu by pressing Alt-S (press and hold down the Alt key, then press the S key while the Alt key is still depressed.) After you have examined the setup options and made any desired changes, press to accept all of your settings. If you wish to cancel these settings, press . If you press to accept the new settings, TreeTop will ask if you wish to save these settings to disk. Answer Yes to save the changes to the TREETOP.PAR file for future reference. If you answer No, TreeTop will only use those settings for the rest of your current session and will forget them when you quit. page 9 The following is a list of the four setup options and a description of each: o General setup parameters o Editor setup o Sort file setup o Attribute mask setup o General Setup Parameters The General setup allows you to set seven different options. An option is selected if there is a check mark next to it. You may toggle the selection on or off using your mouse and left mouse button or the arrow and keys. When finished, press to ACCEPT your choices or to CANCEL them (See The Mouse Interface and Pull Down Menus under Introduction.) These options are described below: 1) Show files on directory This option will display the first eighteen files of each directory in the window on the right side of Directory Service Screen. These files are displayed in the order that they exist on your disk drive (not sorted.) 2) Sorted directory tree Causes the directory tree to be sorted and displayed in alphabetical order. This does not actually change the order stored on the disk. 3) Extended file display mode Sets the display mode on the File Service Screen to show the user the size, date, time and attribute settings for files as well as the full filenames. 4) Overwrite existing files When set, TreeTop will automatically overwrite an existing file in a destination directory if that filename is the same as the file being copied. Treetop's default setting, however, will prompt you when this situation arises. You may disarm this safety feature and allow overwriting without being prompted. 5) Sound effects Causes sound effects to be generated when doing certain operations such as changing from one screen to another. 6) Color Monitor If you have a color monitor, check this option. If you have a monochrome monitor, you probably don't want this option, however, some monochrome display adapters function well in the color mode, so it may be worth a try. page 10 7) LPT1 or LPT2 This selection allows you to set which port TreeTop will send to for printing files. Select the port your printer is connected to. o Editor Setup The Editor setup allows you to enter the name of your favorite text editor. This will give TreeTop the ability to execute your editor automatically if you wish (see Edit File under File Operations.) o Sort File Setup The Sort file setup gives various options of how files are sorted on the File Service Screen. Check the sort options you prefer and press to accept the setting. Note: You can temporarily override these settings while using TreeTop if you wish (see Sort Files under File Operations.) o Attribute Mask Setup The attribute mask setup allows you to selectively weed out files to be viewed by TreeTop. TreeTop will still know about these files but it will not display them on the File Service Screen. Select the attribute or attributes of files that you wish to weed out, and TreeTop will skip by them automatically. Normally, the only files you will want to weed out are HIDDEN or SYSTEM files. The default setup is configured to weed out HIDDEN files. Section 3 Directory Operations ===================================================================== The Directory Service Screen ---------------------------------------- All directory operations are executed from the Directory Service Screen. You may add, delete, or rename a directory from this screen. The root directory is always present and you cannot rename or delete it. If you try, TreeTop will ignore your request. The Directory Service Screen is displayed by TreeTop when first entering the program and must be displayed anytime you're performing directory operations. The six major areas of the Directory Service Screen are: 1) Drive Status Box 2) Directory Status Box 3) Directory Display 4) File List 5) Directory Pathname 6) Menu Bar Drive Status Box - The drive status box found at the left side of the screen gives information on: 1) the current logged drive and its volume label, 2) the total number of files on the drive and their cumulative size in bytes, including system and hidden files, and 3) the total number of tagged files and their cumulative size in bytes. Directory Status Box - The directory status box also found at the left side of the screen displays the name of the currently highlighted directory and the following specific information about that directory: 1) the date and time the directory was created on your drive, 2) the total number of files contained in that directory including system and hidden files and their cumulative size in bytes, and 3) the number of tagged files in that directory and their cumulative size in bytes. page 12 Note: Some copy protection schemes use hidden or read/only directories which may have directory names containing non-ASCII characters. Most programs do not see these special directories, so you may not even know they exist until you run TreeTop. TreeTop will alert you to these directories (if any exist) by flashing the directory name in the directory status box. DO NOT ATTEMPT to delete or rename these special directories unless you know why they exist and how to recreate them properly. If you do attempt to delete or rename one of these directories, TreeTop will warn you, giving you a chance to change your mind. Remember, if you do delete or rename a directory like this, TreeTop will not be able to recreate it. Directory Display - The center section of the screen shows a "tree" structured layout of the directories and subdirectories of the logged drive. The current logged directory when you loaded TreeTop will be highlighted. The up, down, left, and right arrow keys and the PageUp, PageDown, Home, and End keys are used to change the highlighted directory. The left and right arrow keys move through every directory on the tree, one directory at a time. The up and down arrow keys move the highlight bar vertically to a directory of the same level in the tree. You can use your PageUp, PageDown, Home and End keys to jump through the directories. Mouse Users: You may simply click on a given directory to highlight it, then click again on the highlighted directory to select it. If the directory is not visible on the screen, you can scroll to it by clicking (or holding down the left mouse button) just outside the box (but not on the top menu bar.) Clicking at the top or bottom of the box is the same as using the up or down arrow keys, while clicking at the left or right of the box is the same as using the left or right arrow keys. File List - The list of files found in the highlighted directory is displayed in the column at the extreme right side of the screen. These files are displayed regardless of how the file or attribute masks are set. They are not sorted at this point but are in the actual order that they exist on your disk drive. This list of files is intended to function as a reminder of what files, if any, exist in a given directory. You cannot, for example, delete a directory if any files appear in this box. If you wish to view the files in sorted order or execute file operations, press to select the File Service Screen for the highlighted directory. Note: If you do not wish to have the file list displayed, you may turn it off by changing your setup (see User Setup under the Installation section.) Menu Bar - The menu items are displayed on two lines near the top of the screen. The single letter command or function key required to select a menu item is highlighted for quick reference. Typing the first letter of a menu selection will execute most commands. Directory Pathname - The full pathname of the highlighted directory is shown on the bottom line of the screen. page 13 Select a Directory -------------------------------------------------- Command: Screen: Directory Service Screen Synopsis: Selects the File Service Screen for the highlighted directory Choosing the select option (press from the Directory Service Screen) will select the highlighted directory. The File Service Menu and the filenames from the selected directory will be displayed. (see the File Operations section for instructions on using the File Service Menu.) Select All Directories (Global) ------------------------------------- Command: G Screen: Directory Service Screen Synopsis: Selects the File Service Screen for all directories on the logged drive Select the Global option (press G from the Directory Service Screen) to select all the directories for the logged drive. The File Service Screen and the selected files for the entire logged drive will be displayed. This is handy, for example, if you wish to sort the files or find a given file on the drive regardless of what directory it is in. For example, assume you want to find the largest file on the logged drive. You would first select the Global option then sort the files by size, in descending order. The file at the top of the screen is your largest file. (See the File Operations section for instructions on using the File Service Screen.) page 14 Add a Directory ----------------------------------------------------- Command: A Screen: Directory Service Screen Synopsis: Adds a sub-directory to the highlighted directory Highlight the directory on the Directory Service Screen that will become the parent to the directory you want to add then select the Add option (press A from the File Service Screen) to add a sub-directory. The screen will be reformatted to include another directory and the cursor will be positioned on the screen for you to add the new directory name. Type in the name you wish and press . If the name is valid and does not conflict with other directory names, it will be added and displayed on the screen. When there is a problem with the name you chose, a warning message will be displayed and you will be given a chance to edit your entry. If your user setup specifies that the directories are displayed in alphabetical order, you may re-scan your drive with the ScaN option to display the new directory in alphabetical order. If you change your mind and elect not to add a directory before completing the operation, just press to cancel. Delete a Directory -------------------------------------------------- Command: D Screen: Directory Service Screen Synopsis: Deletes the highlighted directory To delete a directory, simply highlight the directory on the Directory Service Screen that you wish to delete. Then select the Delete option (press D from the Directory Service Screen) to delete that directory. If the directory does not contain any files or have any sub-directories, it will be deleted and the screen will be updated to reflect the change. If, however, the directory contains one or more files or sub-directories, a warning message will be displayed and the directory will not be deleted. If you still wish to delete the directory, you must first delete all files and sub-directories that it contains (See Delete File(s) under File Operations.) Note: There is a special situation when the directory has been set by some other program to HIDDEN or READ/ONLY. In this case, you will be notified that it is a special directory and you should see your manual before deleting it. These special directories are sometimes set by copy protection programs and, under normal circumstances, should not be deleted. Chances are they cannot be recreated exactly the same way. You should not delete these directories unless you know why they exist on your system and how to recreate them properly. page 15 Rename a Directory -------------------------------------------------- Command: R Screen: Directory Service Screen Synopsis: Renames the highlighted directory To rename a directory, simply highlight the directory on the Directory Service Screen that you wish to rename. Then select the Rename option (press R from the Directory Service Screen) and you will be prompted for the new directory name. Type the new name and press . If the name is valid and does not conflict with other directory names, the directory will be updated and displayed on the screen. If there is a problem with the name, a warning message will be displayed and you will be given a chance to enter a different name. If your user setup specifies that the directories are displayed in alphabetical order, you may re-scan your drive with the ScaN option. The new directory will then be displayed in alphabetical order. If you change your mind and elect not to rename a directory before you have completed the operation, just press to cancel the operation. Note: There is a special situation when the directory has been set by some other program to HIDDEN or READ/ONLY. In this case, you will be notified that it is a special directory and you should see your manual before renaming it. These special directories are sometimes set by copy protection programs and, under normal circumstances, should not be altered. Chances are they cannot be renamed exactly as they were. You should not rename these directories unless you know why they exist on your system and how to rename them properly. Section 4 File Operations ===================================================================== The File Service Screen --------------------------------------------- The File Service Screen is used for executing most file operations. This screen is displayed when a single directory is selected from the Directory Service Screen or when all files and directories are selected by using the Global option from the Directory Service Screen. The four major areas of the File Service Screen are: 1) Directory/Disk Status Box 2) File Display 3) Directory Pathname 4) Menu Bar Directory/Disk Status Box - The directory status box is found at the left side of the screen. If a single directory was selected, this status box will display Directory Stats. If, however, the Global option from the Directory Service Screen was used to select the files for the File Service Screen, the status box will display Disk Stats (since the files displayed represent all the files on the logical disk drive.) The Directory/Disk Status Box contains the following information: 1) the filename mask and attribute mask used to select the files that are currently displayed, 2) the total number of files selected, regardless of the above mask (i.e. includes all files, hidden or system, etc.) and their cumulative size in bytes, 3) the number of selected files and their cumulative size in bytes, 4) the number of tagged files and their cumulative size in bytes, and 5) the number of untagged files and their cumulative size in bytes. File Display - The selected files are displayed in a box on the right side of the screen. The actual file display comes in two flavors, Normal and Extended. The normal display shows only the filename and lists the files in four columns. This mode is useful for displaying a large number of files on the screen at one time. The extended file display shows fewer files on the screen at one time but gives you much more information about each file. The following is a list and page 17 description of these items: Name - The left eight characters of the filename. Ext - The right three characters of the filename. Size - The size of the file in bytes. Date - The date the file was last edited. Time - The time the file was last edited. Arc - If set, this indicates the file had been modified at one time. This Archive attribute is generally used by backup utilities for flagging which files to backup. Most files will have this bit set. Sys - If set, this indicates that the file is a System file generally used by the operating system (DOS.) Hid - If set, this indicates that the file should be Hidden from the DIR command and certain other programs. R/O - If set, the file is Read/Only and cannot be easily modified or deleted. Directory Pathname - The full pathname of the selected directory is displayed on the bottom line. If the Global option (all directories) was used to select the files, the pathname of the highlighted file will be displayed. Notice how the pathname changes as you change the highlighted file when in Global mode. Menu Bar - The menu items available are displayed on two lines near the top of the screen. The single letter command or key required to select a menu item is highlighted for quick reference. Typing the first letter of a menu selection will execute most commands. An alternate menu bar will appear if you press the Alt key. The menu selections available when the Alt key is depressed generally affect tagged files. Mouse Users: You may click on the menu selection Alt-menu found in the upper right corner of the menu bar. This is analogous to pressing the Alt key at the keyboard. Holding the left mouse button down after clicking on this selection will keep the alternate menu bar displayed. You may drag the mouse cursor to a desired menu item then release the mouse button to select that option. Releasing the mouse button when the mouse cursor is not positioned on a menu item will cancel the Alt-menu selection. page 18 About File Operations ----------------------------------------------- Most file operations are executed from the File Service Screen although a few file operations are executed from the Directory Service Screen. File operations include copying, moving, deleting, viewing, editing, executing, printing, changing date/time, tagging, untagging, re-tagging, and sorting files. Single file operations act on the highlighted file displayed on the File Service Screen. For example, if you wish to copy just one file from one disk drive to another you need only highlight that file then select the Copy option from the top menu bar. You will then be prompted for additional information to copy that file. If, however, you wish to copy several files, you would first have to tag those files. Once tagged, you must select the Alt-Copy option from the File Service Screen. To do this, hold down the ALT key first then press C to copy. You will then be prompted for additional information to copy the tagged files. About Tagging Files ------------------------------------------------- Tagging files is a very powerful way of dealing with files as a group. Many operations that you could do on a single file can be executed on a group of tagged files. You can see which operations may be executed on either single or tagged files by pressing and releasing the ALT key from the File Service Screen and watching the menu bar at the top of the screen change. Generally, if you wish to operate on a single file, you need only make the selection from the menu bar without pressing the ALT key. If, however, you wish to execute that same operation on tagged files, press the ALT key before making your menu selection. Once tagged, you can execute an operation such as copying tagged files that will systematically copy all the files that you have tagged. After copying, the once tagged files are set to a limbo state where you can easily retag or just ignore them. This is handy, for example, if you wish to copy some files from your hard disk to a floppy disk then delete those files on your hard disk. You would first tag the files you wish to copy then execute the Alt-Copy option to copy the tagged files. Once completed, you could retag just the files you just copied by executing the Alt-RetaG option. Now select the Alt-Delete option to delete the tagged files from your hard drive. Files can be tagged from either the Directory Service Screen or the File Service Screen. Tagging files from the Directory Service Screen is handy for tagging groups of files in directories or for the entire logical drive. If you wish to more selectively or individually tag files, you must do this from the File Service Screen. For example, tagging files based on various criteria such as the date and time a file was last edited, its attributes, a filename mask, or other specific criteria, is done from the File Service Screen. page 19 Files can be untagged by the same criteria that is used to tag files. For example, you wish to backup (to floppies,) all files on your hard drive except files having the .BAK extension. You would do this by tagging all the files on your hard drive from the Directory Service Screen using the Alt-Tag. option. Next you would choose the Global option to select all files and change you to the File Service Screen. From here, you would select the Alt-Untag option, then the Mask option, allowing you to untag files based on a filename mask. Type *.BAK to untag those files, leaving the remaining files on your hard drive tagged. Last, you would select the Alt-Copy option to copy the tagged files to your floppy disks. TreeTop does not forget about your tagged files as you move from screen to screen or directory to directory. This gives you the ability to move freely about your hard drive, tagging and untagging files until you are satisfied with the files you have tagged. Once you are done tagging files, you can then execute options that act on those tagged files. page 20 Tag/Untag a Single File --------------------------------------------- Command: T Screen: File Service Screen Synopsis: Tags the highlighted file then advances the highlighted bar to the next file Command: U Screen: File Service Screen Synopsis: Untags the highlighted file then advances the highlighted bar to the next file Select the Tag or Untag option (press T or U from the File Service Screen) to tag or untag the highlighted file. If you tagged the file, a caret is placed next to the that file to alert you that it is tagged. If you untagged a file, the caret is removed. As you tag or untag files, the highlighted bar is moved to the next file on the screen so you can quickly move through the files. Mouse Users: Mouse users can first click on a file to highlight it, then click again on that file to tag or untag it. Clicking on a highlighted file toggles that file between tagged and untagged status. page 21 Tag/Untag Multiple Files -------------------------------------------- Command: Alt-T Screen: File Service Screen Synopsis: Opens a menu of options to tag files based on different criteria Command: Alt-U Screen: File Service Screen Synopsis: Opens a menu of options to untag files based on different criteria Command: T Screen: Directory Service Screen Synopsis: Tags all selected files in the highlighted directory Command: U Screen: Directory Service Screen Synopsis: Untags all selected files in the highlighted directory Command: Alt-T Screen: Directory Service Screen Synopsis: Tags all selected files on the entire logged drive Command: Alt-U Screen: Directory Service Screen Synopsis: Untags all selected files on the entire logged drive Files can be tagged or untagged in groups from either the File Service Screen or the Directory Service Screen. Tagging/Untagging files from the File Service Screen provides the most control for tagging multiple files. Keep in mind, if you have entered the File Service Screen for a single directory with the "select" option, you can only tag/untag files within that directory. If, however, you have entered the File Service Screen using the Global option, you will be tagging/untagging files on the entire logical drive. If you wish to tag/untag files from the File Service Screen, select the Alt-Tag or Alt-Untag option (press Alt-T or Alt-U from the File Service Screen) and a menu of items will appear. All options on this menu will only tag/untag files that have been selected for the File Service Screen. If you select the first option on this menu, all files that are currently selected for the File Service Screen will be tagged/untagged. If you select the second option, you will be given the opportunity to tag/untag files based on a filename mask. Only the files that match the mask you type in will be tagged/untagged. Then next four options allow you to tag/untag files based on the files' attribute settings. You can also tag/untag files that have a date/time stamp that matches today's date. This might be handy for tagging files that you have edited today and want to make a copy to a floppy disk. The last way to tag/untag a group of files from this menu is to select a date/time range. All selected files meeting that range will be tagged/untagged. page 22 Tagging or untagging files from the Directory Service Screen is less selective than from the File Service Screen, but is handy for tagging/untagging all selected files for specific directories or for the entire logged drive. Select the Tag or Untag option (press T or U from the Directory Service Screen) to tag/untag all the selected files in the highlighted directory. If you wish to tag/untag the files in other directories as well, just change the highlighted directory and select the Tag or Untag option again. Select the Alt-T or Alt-U option (press Alt-T or Alt-U from the Directory Service Screen) to tag/untag all the selected files for the entire logged drive. This is especially handy for backing up your hard drive. Note: Before you can execute any file operations other than tagging or untagging files (such as copying and deleting) you must first select the File Service Screen. Also, if you have tagged files in more than one directory, you may want to select the File Service Screen using the Global option. page 23 Set File Display ---------------------------------------------------- Command: Alt-F Screen: File Service Screen Synopsis: Toggles the file display screen between extended and normal display modes Select the Alt-File display option (press Alt-F from the File Service Screen) to toggle between extended and normal file display modes. The normal display mode shows only the file names and extensions of the files, while the extended file display mode show the size, date, time and attribute settings as well. Retag Files --------------------------------------------------------- Command: Alt-G Screen: File Service Screen Synopsis: Retags files that were once tagged but are currently in the limbo state Select Alt-RetaG (press Alt-R from the File Service Screen) to retag files that are in the limbo state. Retagging files is a feature that allows you to execute several different operations on the same group of files. Files that had been tagged and then acted on with a tagged file operation (such a copying tagged files,) get changed to a limbo state where they are no longer tagged. However, they are not quite untagged either. A file in this state is denoted by a white diamond next to it. These files are treated as untagged files by all operations except the Alt-RetaG command. Changing files to this limbo state gives you the ability to abort any file operation, at any time, and TreeTop will know which files have been processed and which files have not. If a tagged file operation is allowed to go to completion, all the selected tagged files will be in this limbo state. The Alt-RetaG option changes files in this limbo state to tagged again. This gives you the ability to tag files, process them, retag them and process them again. For example, you may wish to delete a group of files. First, however, you want to make sure that none are set to Read/Only. To do this, you would tag the appropriate files, then execute the set tagged files' attributes (Alt-Attr) option, setting them to Read/Write (not Read/Only.) Next, you would retag those same files using the retag files option (Alt-RetaG), then execute the delete tagged files option (Alt-Delete.) page 24 Find a File --------------------------------------------------------- Command: F Screen: Directory Service Screen Synopsis: Finds a file or files on the entire logical drive regardless of how the file and attribute masks are set Select the Find option (press F from the Directory Service Screen). A window will appear in which you can type in the filename you wish to find or a filename mask of files you wish to match. Type the filename or mask you wish and press . Find will search the entire logical drive and display all matching files showing you their full pathname. Find is especially useful for locating files that may not be included in the default attribute or file mask and checks all files regardless of how these parameters are set. Since TreeTop already knows about all the files on the disk, Find executes in a fraction of a second because no disk access is required. Edit a File --------------------------------------------------------- Command: E Screen: File Service Screen Synopsis: Invokes your editor for the highlighted file You must first enter the name of your editor in the User Setup portion of TreeTop. If you have not yet done this, refer to User Setup under the Installation Section. Highlight the file you wish to edit, then select the Edit option (press E from the File Service Screen). Your editor will be automatically executed with the file you highlighted just as if you had typed it from the DOS command line. When you finish editing the file, save and exit your editor as you normally would, and you will be returned back to TreeTop. Treetop will automatically rescan your disk drive so it will be aware of any changes you may have made while editing. page 25 Execute a File ------------------------------------------------------ Command: Alt-X Screen: File Service Screen Synopsis: Executes the highlighted file then returns to Treetop Highlight the file you wish to execute, then select the Alt-eXecute option (press Alt-X from the File Service Screen). A window will appear with a prompt similar to your DOS command line and the name of the highlighted file. At this point, you can enter additional arguments to the command line, or even edit the name of the executable file. When you are satisfied with the command line, just press to start the execution. When the program execution is complete, you will be automatically returned to TreeTop. Note: You can only execute three types of files. These are files with an extension of BAT, COM or EXE. If you attempt to execute a file with a different filename extension, the command line window will still appear but the filename will be absent from the window. page 26 Set File(s) Attributes ---------------------------------------------- Command: A Screen: File Service Screen Synopsis: Opens a menu to set the file attributes for the highlighted file Command: Alt-A Screen: File Service Screen Synopsis: Opens a menu to set the file attributes for tagged files Select the Attr option (press A from the File Service Screen) to change the attributes of the highlighted file, or select the Alt-Attr option (press Alt-A from the File Service Screen) to change the attributes of tagged files. A menu will appear with two choices: 1) Change Attributes 2) Change Date/Time Select the Change Attributes option. If you are changing only the highlighted file, a second menu listing the current settings of that file will be displayed. Attributes that are currently set will have a check mark next to them. You may change these attributes to your desired settings using the pull down menu commands. When you are done setting the attributes, press to accept the changes or press to cancel them. The menu displayed for changing the attributes of tagged files differs slightly from the one just described. This menu allows you to set the desired attributes on or off as needed, or leave them unchanged. This is handy, for example, if you wish to set a group of files to Read/Only but do not wish to change the status of the other three attributes, which may vary from file to file. page 27 Set File(s) Date/Time ----------------------------------------------- Command: A Screen: File Service Screen Synopsis: Opens a menu to set the date and time of the highlighted file Command: Alt-A Screen: File Service Screen Synopsis: Opens a menu to set the date and time of tagged files Select the Attr option (press A from the File Service Screen) to change the date and time of the highlighted file, or select the Alt-Attr option (press Alt-A from the File Service Screen) to change the date and time of tagged files. A menu will appear with two choices: 1) Change Attributes 2) Change Date/Time Select the Change Date/Time option. If you a changing only the highlighted file, a second window showing the current date and time of that file will be displayed. You may edit the date and time for that file using your arrow keys to move about the window. When completed, press to accept the changes or press to cancel them. The window displayed for changing the date and time of tagged files will show the current date and time. You may edit the date and time using your arrow keys to move about the window. When completed, press to set the tagged files to the new date and time or press to cancel the operation. page 28 Set File Selection Masks -------------------------------------------- Command: F Screen: File Service Screen Synopsis: Opens a menu of options allowing the user to set the file masks in any of several ways The file selection masks are used by TreeTop to determine which files should be selected for display on the File Service Screen. There are two file selection mask: 1) the filename mask, and 2) the file attributes mask. The filename mask is used by TreeTop to match selected files. Normally, this mask is set to ????????.??? which will match all files. For example, if you wish to select on only the .COM files, then you would set the file mask to ????????.COM. This would instruct TreeTop to select all the files, regardless of their filename, as long as the filename extension was .COM. You could be more specific about which files you select by substituting letters or numbers in place of the question marks. When entering a file mask, you can use the asterisk character (*) as a short hand for all the question marks on either side of the period in the file name because the asterisk will automatically get expanded to the correct number of question marks. For example, ????????.COM would match the same files as *.COM. The other file mask, the file attribute mask, is used to mask out or hide files from being selected. For example, if you did not wish to select on files that are hidden, you could check the HIDDEN bit of the attribute mask and TreeTop would ignore any hidden files, regardless of how the filename mask was set. The default installation of TreeTop is set this way since you do not normally want to see your hidden files. Selecting the File sel option (press F from the File Service Screen) will open a menu that gives you four options: 1) Set Filename Mask 2) Set Mask Attributes 3) Select Tagged files only 4) Reset to default settings Choosing the first option opens an additional window that allows you to type in the actual filename mask you wish TreeTop to use when selecting files. You may use any legal combination of filename characters, including questions marks (?) and asterisks (*.) Choosing the second option opens another menu showing the current settings for the file attributes mask. Using pull-down menu commands, set the file attributes mask to your desired setting. When you are done setting these attributes, you can press to accept the changes or press to cancel them. Choosing the third option overrides the filename and attribute masks and instructs TreeTop to select only on tagged files, regardless of filenames or file attributes. page 29 The fourth and final option is used to reset the file masks to the default settings found in the setup parameter file that was initially read by TreeTop when you executed TreeTop from the DOS prompt. page 30 Set Tagged File Mask ------------------------------------------------ Command: F5 Screen: File Service Screen Synopsis: Toggles the files selected for the File Service Screen between files that are tagged and files that meet the conditions of the filename and attribute masks Select the F5-Tg'd Mask option (press F5 from the File Service Screen) to toggle the files selected for the File Service Screen between files that are tagged or files that meet the conditions of the filename and attribute masks. When tagged files are used as the criteria for selecting files, a red warning message is displayed in the directory status box on the left side of the screen in place of the actual mask that would normally be used for selecting files. When toggled back to the normal condition of selecting files based on their filename and attribute mask, the warning is removed. Sort Files ---------------------------------------------------------- Command: Alt-S Screen: File Service Screen Synopsis: Opens a menu to choose the criteria used for sorting the files on the File Service Screen Select the Alt-Sort option (press Alt-S from the File Service Screen) to open a menu of sort criteria. The current sort criteria used for sorting the files in the File Service Screen are checked. You can select new sort criteria using the pull-down menu commands. Press to accept the new sort criteria or to cancel. The new sort criteria will remain in effect for the remainder of the session (regardless of which directory is subsequently viewed) or until it is changed again. page 31 Copy File(s) -------------------------------------------------------- Command: C Screen: File Service Screen Synopsis: Copies the highlighted file to a specified drive and directory Command: Alt-C Screen: File Service Screen Synopsis: Copies tagged files to a specified drive and directory Both types of copy file operations (highlighted file and tagged files) are executed from the File Service Screen. The menus that prompt you are the same for both cases barring one exception. That exception is the feature that allows you to copy a single file (the highlighted file) while changing the name of the destination file. Select the Copy option (press C from the File Service Screen) to copy the highlighted file. A window appears showing you the name of the source file and the default name of the destination file. If you wish to edit the destination filename, do so at this time, then press to accept the new destination name. To keep the default (original) name, just press without editing. Selecting the Alt-Copy option (press Alt-C from the File Service Screen) allows you to copy the tagged files. Once the copy file(s) option is selected, a list of destination disk drives will appear for your selection. Upon selecting a drive, another menu appears that gives you four options: 1) Scan disk first 2) Duplicate source sub-directories 3) Copy to Root 4) Enter destination path Choosing the first option (Scan disk first) instructs TreeTop to scan the destination disk drive for directories and display them in a window similar to the Directory Service Screen. From this window you may choose which directory you want to copy your files to by moving the highlighted bar to the desired directory then pressing to start the copy operation. Mouse Users: You can simply click on the desired directory to highlight it, then click on that directory again to start the copy operation. If the desired directory is outside of the window, click and hold down your mouse button with the cursor just outside of the window to scroll the directory structure. Choosing the second option (Duplicate source sub-directories) starts the copy operation and instructs TreeTop to copy the file(s) into a subdirectory on the destination disk drive that has an identical path to the source disk drive. If the path does not exist on the destination disk drive, TreeTop will automatically create it. page 32 Choosing the third option (Copy to Root) starts the copy operation and instructs TreeTop to copy the file(s) into the root directory of the destination drive. Choosing the fourth and last option (Enter destination path) opens an additional window that allows you to enter the name of the destination path you wish to copy files to. This option is handy if you know the name of the path you wish to copy to, but do not wish to wait for the destination disk to be scanned first. TreeTop recalls the destination pathname of the last copy operation to this window. You simply type in the destination pathname or edit the existing pathname in the window, then press to start the copy operation. Note: You may fill the destination disk drive while copying files. TreeTop handles this situation gracefully, informing you of the available disk space on the destination disk drive and the size of the file that it is trying to copy. At this point, you are given the opportunity to skip that file and to try copying the next file, or cancelling the copy operation so that you can deal with the full disk. If you cancel the copy operation while you are copying to a floppy disk, you may want to insert a freshly formatted blank floppy disk into the disk drive and resume copying. TreeTop keeps track of the tagged files it has already copied so you can pick up where you left off. In all cases, you can cancel the copy operation while you are copying files by pressing , then resume where you left off by selecting the copy option from the menu again. page 33 Move File(s) -------------------------------------------------------- Command: M Screen: File Service Screen Synopsis: Moves the highlighted file from one directory to another directory on the same logical drive Command: Alt-M Screen: File Service Screen Synopsis: Moves tagged files from one directory to another directory on the same logical drive Select the Move option (press M from the File Service Screen) to move the highlighted file, or select the Alt-Move option (press Alt-M from the File Service Screen) to move tagged files. Either option will prompt you with a directory tree structure of the current logged drive. This tree structure is similar to the one on the Directory Service Screen. From this window you may choose which directory you want to move your file(s) to by moving the highlighted bar to the desired directory then pressing to start the move operation. You may cancel the move operation at anytime by pressing . Mouse Users: You can simply click on the desired directory to highlight it, then click on that directory again to start the copy operation. If the desired directory is outside of the window, click on your mouse cursor just outside of the window to scroll the directory structure. Note: When using the move file commands, you are limited to moving the file(s) within the same logical drive on which they exist. This is because the move operations do not actually move any data, but changes the directory entries and FAT (file allocation table) entries that tell DOS where the file(s) is located. The move operations are extremely fast because they efficiently move files (regardless of the size of the files) from one directory to another on the same logical drive. If you wish to move a group of files from one logical drive to another, you can do so by using TreeTop's copy and delete routines. First tag the files you wish to move, then select the Alt-Copy option (see Copy File(s) under File Operations) to copy the tagged files to another drive. When that operation has been successfully completed, select the Alt-RetaG option (see Retag Files under File Operations) to retag the files you just copied. Now select the Alt-Delete option (see Delete File(s) under File Operations) to delete the files you just copied. page 34 Delete File(s) ------------------------------------------------------ Command: D Screen: File Service Screen Synopsis: Deletes the highlighted file Command: Alt-D Screen: File Service Screen Synopsis: Deletes tagged files Both the Del and Alt-Del options to delete files are executed from the File Service Screen. To delete only the highlighted file, select the Del option (press D from the File Service Screen). The name of the file you selected will be displayed and you will be asked if it is OK to delete that file. You can respond with Yes, No, or just press to cancel the delete operation. To delete tagged files, select the Alt-Del option (press Alt-D from the File Service Screen.) You will be asked if it is OK to delete tagged files. If you respond with Yes, you will be asked if you wish to be prompted. If you answer Yes, each tagged filename to be deleted will be displayed and you will have the option of deleting or saving that file. If you answer No, the tagged files will be deleted and no more questions will be asked. You may cancel the delete operation at any time by pressing , but keep in mind, you cannot undelete files TreeTop had already deleted up until the time you pressed the escape key. page 35 Print File(s) ------------------------------------------------------- Command: P Screen: File Service Screen Synopsis: Prints contents of the highlighted file Command: Alt-P Screen: File Service Screen Synopsis: Prints contents of tagged files Both the Print and Alt-Print options are executed from the File Service Screen. To print only the highlighted file, select the Print option (press P from the File Service Screen.) The name of the highlighted file will be displayed, and you will be asked if it is OK to print that file. You can respond with Yes, No, or just press to cancel the print operation. To print tagged files, select the Alt-Print option (press Alt-P from the File Service Screen.) You will be asked if it is OK to print tagged files. You can respond with Yes, No, or just press to cancel the print operation. You may cancel the print operation at any time by pressing . If your printer is off-line or not connected properly when you select a print option, a warning message will be displayed informing you the printer is not ready. Rename a File ------------------------------------------------------- Command: R Screen: File Service Screen Synopsis: Renames the highlighted file Highlight the file you wish to rename, then select the Rename option (press R from the File Service Screen). The current name will be displayed and you will be prompted for a new name. Any valid file name that does not conflict with other files in the same directory can be used. Type in the new name and press . If there is a naming conflict, a warning message will be displayed and the file will not be renamed. page 36 File Speed Search --------------------------------------------------- Command: F4 Screen: File Service Screen Synopsis: Advances highlighted bar to filename matching user input Select the F4-Spd Srch option (press F4 from the File Service Screen.) You will be prompted for a filename to search. TreeTop tries to match a file in the selected directory or directories (if Global) to the filename you are typing. It will continuously move the highlighted bar to the matching file as you type. When no match is found for the typed entry, TreeTop will ignore that character. Once TreeTop has highlighted the file you desire, you can press either or to terminate File Speed Search. This is a handy way to locate a file if you know its name and do not wish to scroll through all the files manually. Note: If searching for a specific file while in Global (Viewing All Subdirectories), it is advisable to first sort the files alphabetically. This way files of the same name will be grouped together. Hex File Dump ------------------------------------------------------- Command: H Screen: File Service Screen Synopsis: Displays the contents of the highlighted file in hexadecimal form Select the Hex option (press H from the File Service Screen.) The highlighted file will be opened, changing you to the Hex Dump Screen and displaying the first 256 bytes of the file in hexadecimal form (base 16.) At the right of the Hex Dump Screen, the ASCII representation of each byte is displayed. If the value of a given byte is greater than the ASCII range, the IBM block mode graphics character is displayed. You may move through the file, displaying other 256 byte records using your Home, End, PageUp, and PageDown keys. If you wish to view a specific 256 byte record, you can select the Goto (press G) option at the top of the Hex Dump Screen. This option allows you to Goto any 256 byte record in that file. When you have finished viewing the file, you may press to exit the Hex Dump Screen. Mouse Users: Mouse users can click on the bottom of the screen to view the next record or near the top of the screen (but below the menu bar) to view the previous record. page 37 View a File --------------------------------------------------------- Command: V Screen: File Service Screen Synopsis: Displays the contents of the highlighted file in text form Select the View option (press V from the File Service Screen). The highlighted file will be opened, changing you to the File View Screen and displaying the first 19 lines of that file. You may move through the file one page at a time using your PageUp and PageDown keys or one line at a time using your up and down arrow keys. The Home and End keys move you to the first and last pages of the file, while the left and right arrow keys will shift the file left or right 10 characters. When you have finished viewing the file, press to exit the File View Screen. Mouse Users: Mouse users can click on the bottom of the screen or near the top of the screen (but below the menu bar) to scroll the file vertically. You can also click on the left and right sides of the screen to scroll the file horizontally. Section 5 Miscellaneous Operations ===================================================================== The remaining operations described in this section consist mostly of disk drive commands. All the commands listed in this section can be executed from the Directory Service Screen and many can be executed from the File Service Screen. page 39 Registration Information -------------------------------------------- Command: I Screen: Directory Service Screen Synopsis: Displays registration information for TreeTop Select the Info option (press I from the Directory Service Screen) to display the Registration Information Screen. This screen contains information instructing you how to permanently register your TreeTop software. Available Disk Space ------------------------------------------------ Command: S Screen: Directory Service Screen or File Service Screen Synopsis: Displays the available disk space for a given drive Select the Space option (press S from either the Directory Service Screen or the File Service Screen). A menu of logical drives is displayed. Press the letter of the drive you wish or press O for Other Drive if the disk drive you want is not on the menu. If you pressed O, a box will appear for you to enter the drive you want. After selecting a drive, the available disk space is displayed in another window. If the drive you selected is not ready or does not exist on your system, a warning message will be displayed. If this happens, you can press to cancel the Space request or ready the drive and select it again. When you have completed checking available space on your logical drives, press to return. Logging to a Different Drive ---------------------------------------- Command: L Screen: Directory Service Screen or File Service Screen Synopsis: Changes to a new drive and scans that drive for its files and directories Select the Log drive option (press L from either the Directory Service Screen or the File Service Screen). A menu of logical drives is displayed. Press the letter of the drive you wish or press O for Other Drive if the disk drive you want is not on the menu. If you pressed O, a box will appear for you to enter the drive you want. After selecting a drive, TreeTop scans that drive for all files and directories, just as it did when you first executed TreeTop. If the drive you selected is not ready or not available on your system, a warning message is displayed. If this happens, you can press to cancel the Log drive request or ready the drive and press to try again. page 40 Setting the Disk Volume Label --------------------------------------- Command: V Screen: Directory Service Screen Synopsis: Sets the volume label for the currently logged drive Select the Volume option (press V from the Directory Service Screen) to set the volume label for the current logged drive. A window will appear allowing you to enter a new volume label. If a volume label currently exists on the logged drive, then it will be changed to the new label. If there is no previous label, then one will be created. If you wish to delete the volume label, just press without typing a new label. If you wish to cancel the operation, press . Scanning the Current Drive ------------------------------------------ Command: N Screen: Directory Service Screen Synopsis: Rescans the currently logged drive for its files and directories Select the ScaN option (press N from the Directory Service Screen) to rescan the current logged drive. This feature is useful if you have logged onto a removeable media disk drive (i.e. a floppy drive) and you wish to change floppies. Rescanning forces TreeTop to reread all the directory and file entries for the logged drive and set any previously tagged files to untagged status. You may wish to use this command if you have tagged a number of files throughout the directories and you want to have a fresh look at the drive. Shelling To DOS ----------------------------------------------------- Command: F3 Screen: Directory Service Screen or File Service Screen Synopsis: Temporarily exits TreeTop by executing your command interpreter Select the F3-DOS Shell option (press F3 from either the Directory Service Screen or the File Service Screen). As a precaution, you will be asked if you wish to shell to DOS. Press or answer No to cancel the command. Answering Yes causes TreeTop to invoke your command interpreter, returning you temporarily to the DOS prompt in the directory you were at when you selected the F3-DOS Shell option. Keep in mind that you actually suspended TreeTop, and it still resides in memory. Type EXIT then press at your DOS prompt to return to TreeTop. TreeTop will automatically rescan your logged drive to check for any files or directories you may have changed. page 41 Exiting TreeTop ----------------------------------------------------- Command: Screen: Directory Service Screen Synopsis: Quits TreeTop and returns you to your original directory Command: F2 Screen: Directory Service Screen or File Service Screen Synopsis: Quits TreeTop and places you in the current logged drive and directory There are two ways you can quit TreeTop. The first and most common way is by selecting the ESC-Quit option (press from the Directory Service Screen). As a precaution against accidentally exiting, you will be asked if you want to exit TreeTop. Answer No or press to cancel the command and continue running TreeTop. Answer Yes to quit TreeTop and return to your DOS prompt in the same drive and directory that you originally ran TreeTop from. The second way of quitting TreeTop allows you to change to the current logged drive and directory while exiting. Select the F2-Exit to dir option (press F2 from either the Directory Service Screen or the File Service Screen). As a precaution against accidentally exiting, you will be asked if you want to exit TreeTop. Answer No or press to cancel the command and continue running TreeTop. Answer Yes to quit TreeTop and return to your DOS prompt in the drive and directory that was TreeTop's logged drive and directory when you executed the command. INDEX TO OPERATIONS Operation Cmd Scrn* Pg Synopsis ---------------- --- ----- -- ----------------------------------- Add a Directory A D 14 Adds a sub-directory to the high- lighted directory Copy files(s) C F 31 Copies the highlighted file to a specified drive and directory Alt-C F 31 Copies tagged files to a specified drive and directory Delete Directory D D 14 Deletes the highlighted directory Delete File(s) D F 34 Deletes the highlighted file Alt-D F 34 Deletes tagged files Edit a File E F 24 Invokes your editor for the high- lighted file Execute a File Alt-X F 25 Executes the highlighted file then returns to TreeTop File Speed F4 F 36 Advances highlighted bar to filename Search matching user input Find a File F D 24 Finds a file or files on the entire logical drive regardless of how the file and attributes masks are set Hex File Dump H F 36 Displays the contents of the high- lighted file in hexadecimal form Information I D 39 Displays TreeTop registration Info. Logging to a L D/F 39 Changes to a new drive and scans that Drive drive for its files and directories Move File(s) M F 33 Moves the highlighted file from one directory to another directory on the same logical drive Alt-M F 33 Moves tagged files from one directory to another directory on the same logical drive Print File(s) P F 35 Prints the contents of the highlighted file Alt-P F 35 Prints the contents of tagged files Quit TreeTop D 41 Quits TreeTop and returns you to your original directory F2 D/F 41 Quits TreeTop and places you in the currently logged drive and directory *D = Directory Service Screen, F = File Service Screen, D/F = either screen INDEX TO OPERATIONS (cont.) Operation Cmd Scrn* Pg Synopsis ---------------- --- ----- -- ----------------------------------- Rename Directory R D 14 Renames the highlighted directory Rename a File R F 35 Renames the highlighted file Retag Files Alt-G F 23 Retags files that were once tagged but are currently in the limbo state Scanning Logged N D 40 Rescans the currently logged drive for Drive its files and directories Select All G D 13 Selects the File Service Screen for all Directories directories on the logged drive Select a D 13 Selects the File Service Screen for the Directory highlighted directory Set File Display Alt-F F 23 Toggles the file display between extended and normal display modes Set File Selec. F F 28 Opens a menu of options allowing the Masks user to set the filename and attribute masks in any of several ways Set File(s) A F 26 Opens a menu to set the file attributes Attributes of the highlighted file Alt-A F 26 Opens a menu to set the file attributes of tagged files Set File(s) A F 27 Opens a menu to set the date and time Date/Time of the highlighted file Alt-A F 27 Opens a menu to set the date and time of tagged files Set Tagged File F5 F 30 Toggles the files selected for the File Mask Service Screen between files that are tagged and files that meet the cond- itions of the filename and attribute masks Set Volume Label V D 40 Sets the volume label for the currently logged drive Setup Alt-S D 8 Opens a menu of options for customized setup by the user Shelling to DOS F3 D/F 40 Temporarily exits TreeTop by executing the DOS command interpreter Sort Files Alt-S F 30 Opens a menu to choose the criteria used for sorting the files on the File Service Screen *D = Directory Service Screen, F = File Service Screen, D/F = either screen INDEX TO OPERATIONS (cont.) Operation Cmd Scrn* Pg Synopsis ---------------- --- ----- -- ----------------------------------- Space Available S D/F 39 Displays the available disk space for a (disk) given drive Tag a File(s) T F 20 Tags the highlighted file then advances the highlighted bar to the next file Alt-T F 21 Opens a menu of options to tag files based on various criteria T D 21 Tags all selected files in the high- lighted directory Alt-T D 21 Tags all selected files on the entire logged drive UnTag a File(s) U F 20 Untags the highlighted file then advances the highlighted bar to the next file Alt-U F 21 Opens a menu of options to untag files based on various criteria U D 21 Untags all selected files in the high- lighted directory Alt-U D 21 Untags all selected files on the entire logged drive View a File V F 37 Displays the contents of the high- lighted file in text form *D = Directory Service Screen, F = File Service Screen, D/F = either screen