home *** CD-ROM | disk | FTP | other *** search
/ PC Format 5 / Disk5.iso / DISKTREE.DOC next >
Text File  |  1991-10-27  |  70KB  |  1,747 lines
  1.  
  2.  
  3.  
  4.                       DiskTree V1.1 (Oct/Nov 1991 Release) 
  5.            
  6.                          (C)opyright 1991 Richard Smith
  7.  
  8.  
  9.           Published and Distributed by PRECISION SOFTWARE APPLICATIONS    
  10.            
  11.  
  12.                    This program is dedicated to Cliff Burton
  13.  
  14.  
  15.  
  16.            
  17.                                TABLE OF CONTENTS
  18.       
  19.       
  20.       1.  INTRODUCTION
  21.       
  22.       1.1 Overview of facilities
  23.       
  24.       1.2 MSDOS directory structure
  25.       
  26.       2.  BASIC FACILITIES
  27.       
  28.       2.1 Directory functions
  29.       
  30.       2.2 File functions
  31.       
  32.       2.3 Differences between functions
  33.       
  34.       3.  IMPORTANT CONCEPTS
  35.       
  36.       3.1 Tagging
  37.       
  38.       3.2 Tag masking
  39.       
  40.       4.  SYSTEM REQUIREMENTS
  41.       
  42.       5.  INSTALLATION
  43.       
  44.       6.  RUNNING DiskTree
  45.       
  46.       7.  USING DiskTree
  47.       
  48.       7.1 The user interface
  49.  
  50.       7.1.1   Help system
  51.        
  52.       7.2 Directory functions
  53.         
  54.       7.3 Directory function descriptions
  55.  
  56.       7.3.1   Tag
  57.       7.3.2   Untag
  58.       7.3.3   taG mask
  59.       7.3.4   Find    
  60.       7.3.5   Copy
  61.       7.3.6   Delete
  62.       7.3.7   Move
  63.       7.3.8   New directory
  64.       7.3.9   Options
  65.       7.3.10  Statistics
  66.       7.3.11  Log drive
  67.       7.3.12  ^Log options
  68.       7.3.13  Zip
  69.       7.3.14  Select files
  70.       7.3.15  Quit  
  71.       7.4 File functions  
  72.       7.5 File function descriptions
  73.       7.5.1   Tag
  74.       7.5.2   ^Tag all
  75.       7.5.3   Untag
  76.       7.5.4   ^Untag all
  77.       7.5.5   Copy
  78.       7.5.6   Delete
  79.       7.5.7   Move
  80.       7.5.8   Attrib
  81.       7.5.9   Invert
  82.       7.5.10  View file
  83.       7.5.11  Edit
  84.       7.5.12  eXecute program
  85.       7.5.13  Rename
  86.       7.5.14  taG mask
  87.       7.5.15  display type
  88.       7.5.16  dOs command
  89.       7.5.17  Escape
  90.       
  91.       Appendix 1.  DiskTree and Networks
  92.       
  93.       Appendix 2.  Hints & tips
  94.       
  95.       Appendix 3.  Reading list
  96.       
  97.       Appendix 4.  Support software 
  98.   
  99.  
  100.     1.  INTRODUCTION
  101.  
  102.     Making order out of the chaos of the thousands of files contained on 
  103.     even the smallest of Hard-disk drives is both important and incredibly 
  104.     tedious. Without control and order, files get lost, space gets wasted 
  105.     and productivity drops as users spend more and more time just keeping 
  106.     track of what files are where. Of course, in a perfect world, users 
  107.     would save their data according to a sensible and logical standard of 
  108.     what files should go where.  Unfortunately, no one does this with any 
  109.     real conviction and when things get confused, there is no quick way of 
  110.     sorting the mess out. 
  111.  
  112.     Until now!
  113.  
  114.     DiskTree is an affordable, powerful and above all, easy-to-use disk 
  115.     management tool for all your needs. 
  116.  
  117.  
  118.     1.1 Overview of facilities
  119.  
  120.     Full Microsoft mouse support
  121.     
  122.     Support for extended screen resolutions, i.e. 43, 28 and 50 line modes 
  123.     
  124.     Up to 26 drives in memory at once, drives may be removed from memory or 
  125.     re-read at any point. On a 640K system between 10,000 and 13,000 files 
  126.     and directories can be held in memory 
  127.     
  128.     Directory structure is displayed in pictorial fashion and can be 
  129.     traversed using either the keyboard or mouse 
  130.     
  131.     Files, directories, directories trees and even entire drives can be 
  132.     moved, copied or deleted with ease 
  133.     
  134.     Search for individual files or directories 
  135.     
  136.     Option to auto view files during file operations 
  137.     
  138.     Files can be viewed, edited or executed 
  139.     
  140.     Associate external programs with file extensions for automatic 
  141.     execution of external applications 
  142.     
  143.     Variables and shortcuts to reduce typing 
  144.     
  145.     Works with PKWARE's PKZIP utility for effortless and seamless creation 
  146.     of ZIP archives 
  147.     
  148.     Extensive context-sensitive help available at all times. 
  149.     
  150.     
  151.     1.2 MSDOS directory structure (Beginners Intro) 
  152.  
  153.     The MSDOS directory structure is made up of basically two types of 
  154.     item; files - containing program and user data and directories which 
  155.     hold the individual files. The average disk, be it a floppy disk drive 
  156.     or hard disk can contain many such files and directories. 
  157.  
  158.     1.2.1 Directories
  159.  
  160.     Directories can be one of two types; the root directory or a sub-
  161.     directory.  On any single drive there will only ever be one root 
  162.     directory but there may be many sub-directories. This situation is more 
  163.     easy to visualise if one considers the directory structure as a sort of 
  164.     up-side-down tree with the root directory at the top and sub-
  165.     directories growing down from it. The following diagram shows what 
  166.     might be a typical structure for a fairly empty hard-disk, in this case 
  167.     drive 'C'. 
  168.  
  169.            (The root - '\')
  170.         _________________|________________
  171.        /    /    \    \
  172.       DOS    SYS    WORK    MODULA2
  173.             / \    /\
  174.            /   \    /  \
  175.           DOCS   TEMP   MOD  DEF
  176.  
  177.     In this example the root (shown as a '\') contains the subdirectories 
  178.     DOS, SYS, WORK and MODULA2. In addition the sub-directory WORK contains 
  179.     two further sub-directories -DOCS and TEMP. The sub-directory MODULA2 
  180.     also contains sub-directories; in this case, MOD and DEF. 
  181.  
  182.     Directories are specified by their paths. A path defines the route 
  183.     through to the directory tree structure for individual directories. 
  184.  
  185.     The format for a DOS path is thus:
  186.  
  187.     DRIVE-DESIGNATOR, ROOT, 1ST SUB-DIR, '\', 2ND SUB-DIR ..
  188.  
  189.     In this example the path for the TEMP directory within WINDOWS is: 
  190.  
  191.           ___sub-dir separator
  192.          /
  193.        C:\WORK\TEMP --- sub-dir name
  194.         / | \   \
  195.       drive  root \   \
  196.     designation    Sub-dir \__ sub-dir separator
  197.  
  198.     For normal DOS paths, the drive designation and root are not compulsory 
  199.     and it is normal to only give enough information to specify the 
  200.     required directory. 
  201.  
  202.     Example:
  203.  
  204.     Suppose, using the above examples, that we are at the root '\'.  To 
  205.     move (Using the DOS command line, NOT DiskTree) to the TEMP directory 
  206.     of the WORK directory: 
  207.  
  208.     CD WORK\TEMP  <---' (Return or Enter)
  209.  
  210.     Since we are at the root, the tree follows straight down to the TEMP 
  211.     directory through the WINDOWS directory.  If, however, we were already 
  212.     within the directory DOCS, we would have to specify the root '\' to get 
  213.     back to the correct starting point position: 
  214.  
  215.     CD \WORK\TEMP  <---' (Return or Enter)
  216.  
  217.     The other way to change to C:\WORK\TEMP from C:\WORK\DOCS would be to 
  218.     use the backward tree pointers that point back through the directory 
  219.     structure to the root. 
  220.  
  221.     When a directory is created, DOS automatically creates two other sub-
  222.     directory entries - '.' and '..'. The '.' (single full stop) means 'the 
  223.     current directory' and the '..' (double full stop) means 'the directory 
  224.     above the current one'. 
  225.  
  226.     Using the above example, we could get to C:\WORK\TEMP from C:\WORK\DOCS 
  227.     thus: 
  228.  
  229.     CD ..\..\WORK\TEMP  <---'
  230.  
  231.  
  232.     1.2.2 FILES
  233.  
  234.     DOS stores program data and user data such as spreadsheets, word 
  235.     processed letters etc.. in 'files'. A file is simply a collection of 
  236.     individually characters (e.g 'A','B') and is measured in 'bytes'.  
  237.     Since files are normally at least several thousand bytes long, the 
  238.     Kilobyte is usually used to refer to their size. A kilobyte is 
  239.     actually, 1024 bytes but a thousand will do.  You will probably come 
  240.     across the term 'megabyte' at some point, and a megabyte is 1024 kilo 
  241.     bytes. 
  242.  
  243.     A file is named with up to eight letters plus an extension of a further 
  244.     three letters. Between the name and extension is a '.'.  The extension 
  245.     usually defines what type of data the file contains.  There are 
  246.     essentially two types of data that files can contain: 
  247.  
  248.     Runnable or executable program files:
  249.  
  250.     Runnable (executable) files have either the extension 'BAT' (batch), 
  251.     'EXE' or 'COM'.   Batch files are slightly different from EXE or COM 
  252.     files but in average use, the appear the same.  See a proper DOS guide 
  253.     for fuller information. 
  254.     
  255.     Anything else:
  256.  
  257.     Word processing, spread sheet, help, source code files etc.. the list 
  258.     goes on and on.. Typical extension you may come across are 'DAT', 
  259.     'TXT', 'WKS', 'DOC', 'PRG', 'DBF' etc..  The  extensions  usually  show  
  260.     which applications the files relate too. i.e DOC for word processing. 
  261.     
  262.     Files are contained within directories and there is normally no limit 
  263.     to the number of files you can have, except in the disk space you have 
  264.     available.  The only exception is the root directory which has a limit 
  265.     to the number of files (or sub-directories) than can be contained 
  266.     within it. 
  267.  
  268.     Typical root-directory limits are:
  269.  
  270.     360K 5 1/4" disk    112 files, sub-dirs
  271.     1.2M 5 1/4" disk    224  " "
  272.     Hard disks     512 (may vary)
  273.  
  274.     Since it is very good practice to keep files and groups of files in 
  275.     sub-directories with their associated applications, the limit is not 
  276.     likely to become a problem. 
  277.  
  278.     1.2.3   Files and directories.
  279.  
  280.     So far,  we have  talked about  directories and files separately.  In 
  281.     general use, however, they are closely related in that you need to the 
  282.     know the directory structure to find and access the files you need. 
  283.  
  284.     Example:
  285.  
  286.     The full path of a WP file, 'LETTER.DOC' in the directory 
  287.     'C:\WORK\DOCS' is actually: 
  288.  
  289.     C:\WORK\DOCS\LETTER.DOC
  290.  
  291.     In practice, you would not normally need to use the full path since you 
  292.     are likely to be in the DOCS sub-dir anyway. 
  293.  
  294.     The problem occurs, however, if you want to move or copy files around 
  295.     your disk for back-up purposes. As can be seen, there is a fair amount 
  296.     of typing in the above line which represents part  of a very simple 
  297.     directory structure. Imagine the problem however, in a real-world 
  298.     situation with dozens, maybe hundreds of directories and thousands of 
  299.     files. Moving that many files around by hand using normal DOS commands 
  300.     is a nightmare. 
  301.  
  302.     DiskTree makes life so much easier and simpler that after using it for 
  303.     a couple of days you will not want to go back to using the command 
  304.     interpreters primitive facilities ever again! 
  305.  
  306.  
  307.     2.  BASIC FACILITIES
  308.  
  309.     There are two distinct types of function performed by DiskTree 
  310.  
  311.     2.1 Directory functions:
  312.  
  313.     Directory  functions  are  performed  on  a  pictorial representation 
  314.     of a drives directory structure which can be traversed using either the 
  315.     keyboard or mouse. 
  316.  
  317.     DiskTree's most powerful abilities are in its directory copying 
  318.     facilities.  Entire directory trees can be copied with ease and minimal 
  319.     typing effort. Copied trees can also retain their directory structure. 
  320.     
  321.     The file/directory deletion facilities are similarly powerful, allowing 
  322.     deletion across an entire drive. For example, all .BAK files within a 
  323.     drive or directory tree can be deleted with just a couple of key 
  324.     presses. 
  325.  
  326.     2.2 File functions:
  327.  
  328.     DiskTree's file functions operate on individual files or groups of 
  329.     files in a directory selected with the directory functions.  Operations 
  330.     are performed in a scrollable window showing filenames, size, date and 
  331.     time as well as file attributes. 
  332.  
  333.     Facilities are provided to edit, view, execute, delete, move, copy, 
  334.     rename and set file attributes. In addition, file viewing and editing 
  335.     can be performed by external programmes, 'hooked' into DiskTree. In 
  336.     this way you do not loose your favourite editors etc.. 
  337.     
  338.     Files may  be partially viewed automatically, when scrolling through 
  339.     the file list. A facility useful for checking the contents of a file 
  340.     without having to expressly open it. 
  341.     
  342.     2.3 Differences between directory and file functions
  343.  
  344.     Both directory and file operations include copying and deletion 
  345.     facilities, but they operate in slightly different ways.  Directory 
  346.     functions operate on ALL tagged  files and directories on  the drive 
  347.     currently being used.  File functions are only performed on tagged 
  348.     files within the current directory. 
  349.  
  350.  
  351.     3.  IMPORTANT CONCEPTS
  352.  
  353.     3.1 File / directory tagging.
  354.  
  355.     The single most important concept used in DiskTree is idea of the tag.  
  356.     A tag shows that the file or directory has been selected for further 
  357.     manipulation.  Most directory and file operations only work on tagged 
  358.     files. A tag is represented by the characters '>>' next to the 
  359.     directory or file name. 
  360.  
  361.     It is important to understand how tagging works and the difference 
  362.     between file tagging and directory tagging. 
  363.  
  364.     3.1.1   Directory tagging
  365.  
  366.     Directory tagging and un-tagging is performed on directories AND their 
  367.     contents.  If a directory is tagged, the files within it are also 
  368.     tagged (according to the current TAG MASK. See 2.2, 7.3.3).  In 
  369.     addition, if the option 'Recurse subdirectories' is on (as it is by 
  370.     default), all directories within the directory will also be tagged. 
  371.  
  372.     Example:
  373.  
  374.     Take the following directory structure:
  375.  
  376.     (before tag)    (after tagging directory WORK)
  377.  
  378.     ---WORK       ->>WORK
  379.      ---ABC       ->>ABC
  380.      ---BACKUP        ->>BACKUP
  381.        ---ABC       ->>ABC
  382.        ---TESTING       ->>TESTING
  383.  
  384.     As can be seen, the entire tree below and including work has been 
  385.     tagged. A copy or delete could then be performed on the entire tree.  
  386.     If many such trees had been tagged, the directory functions copy or 
  387.     delete would affect them all. 
  388.  
  389.     The untagging or removal of the tags are performed in exactly the same 
  390.     way as tagging. 
  391.  
  392.     NOTE: Since it is possible to tag an entire drive easily and then 
  393.     delete it, care should be taken to ensure that only desired directories 
  394.     and files are tagged. To help with this, a count of the number of 
  395.     tagged files and directories and the size of the tagged files is 
  396.     displayed on the screen. 
  397.  
  398.     See also (7.2)
  399.  
  400.     3.1.2   File tagging
  401.  
  402.     File tagging effects only files in the current directory that file 
  403.     operations are being carried out on. All files can be tagged or 
  404.     untagged and files may also be tagged individually. 
  405.  
  406.     In addition, the tag invert facility can be used to invert the file 
  407.     tags. Tagged files are untagged, untagged files are tagged. 
  408.  
  409.     Example:
  410.     
  411.     If you had 100 files in a directory and you wished keep 10 of them and 
  412.     delete the rest. Instead of tagging all the files you want to delete, 
  413.     you can tag the files you wish to keep and issue a tag invert. 
  414.     
  415.     The file operations copy, move, attrib and delete only perform on 
  416.     tagged files. 
  417.  
  418.     If any files within a directory are tagged, the directory itself will 
  419.     also be tagged, indicating that it contains one or more tagged files. 
  420.  
  421.     See also (7.3.3, 7.5.1).
  422.  
  423.     3.2 Tag masking.
  424.  
  425.     The file mask is used to control what files are selected for tagging.  
  426.     It consists of a standard DOS filename and may contain wildcards.  By 
  427.     default it is '*.*', which means that all files would be tagged. In 
  428.     many situations, however, it is desirable to specify particular files 
  429.     or groups of files for tagging. 
  430.  
  431.     Examples:
  432.  
  433.     To tag only filenames with the extension 'BAK', the tag mask would be 
  434.     set to '*.BAK'. 
  435.     
  436.     If for some reason, only files starting with 'TEST' might be required 
  437.     and in this case, the file mask would be set to 'TEST*.*'. 
  438.     
  439.     Specifying partial file masks is very useful for removing or copying 
  440.     files of a particular type. As shown in the example above, setting the 
  441.     file mask to '*.BAK' would allow the tagging of all .BAK files within a 
  442.     directory, tree or even the entire drive. Issuing a delete command 
  443.     would then delete all tagged files on the currently logged drive (in 
  444.     the case of directory functions) or all tagged files within the current 
  445.     directory (in the case of file functions). 
  446.  
  447.     Dates can also be specified, allowing files before, after or between 
  448.     given dates to taggable. 
  449.  
  450.     The file mask can be combined with the before and after dates to allow 
  451.     the masking of specific files which have date stamps between specified 
  452.     ranges. 
  453.  
  454.     Example:
  455.  
  456.     To allow all *.BAK files created after 16/3/1991 and before 1/4/1991 to 
  457.     be taggable: 
  458.     
  459.     Files mask:  *.BAK
  460.     Before date:  1/4/1991
  461.     After date:  16/3/1991
  462.     
  463.     See also (7.3.3, 7.3.1).
  464.  
  465.  
  466.     4.  SYSTEM REQUIREMENTS
  467.  
  468.     DiskTree will only run 100% IBM PC compatible machines, and although it 
  469.     will run on a standard IBM PC (8088 chip), an AT type machine or clone 
  470.     is recommended (80286,80386 or 80486). 
  471.  
  472.     The amount of memory required is dependent on the size of the disk 
  473.     drives you are going to use it with.  640K is recommended, but 256 
  474.     should be enough if only small or empty drives are to be used. 
  475.  
  476.     All of the main display adaptors (colour or monochrome) are
  477.     supported, but if extended (43 and 50 line) text resolutions
  478.     are desired, EGA or VGA will be required. Full support for
  479.     the Microsoft  mouse standard is included in the user
  480.     interface.
  481.            
  482.     Summary of requirements:
  483.  
  484.     IBM PC / PS2 compatible (80286 recommended)
  485.     >380K memory (640K recommended)
  486.     1 Floppy drive (A sub 28MS access hard-disk drive is
  487.     recommended)
  488.     Colour or monochrome, (Colour recommended)
  489.     MDA,CGA,EGA,VGA (VGA recommended)
  490.     Mouse optional.
  491.     DOS 3.1 upwards, (DOS 5 recommended)
  492.     
  493.     See also Appendix 2 (Hints and Tips) for ways of increasing performance 
  494.     of DiskTree and your system in general. 
  495.  
  496.  
  497.     5.  INSTALLING DiskTree
  498.  
  499.     Although DiskTree  needs no real installation as such, creating a 
  500.     specific area on your hard-disk for it, or copying it to an existing 
  501.     directory along DOS's search PATH makes sense.  DiskTree has its own 
  502.     install program that will copy all the required files off the 
  503.     distribution disk for you. 
  504.  
  505.     Installing DiskTree in its own directory:
  506.  
  507.     Place the disk in drive A: or B:
  508.     
  509.     Change to that drive:
  510.     
  511.     A: (and press RETURN/ENTER) (or B:)
  512.     CD \  
  513.     Type: INSTALL (and press RETURN/ENTER)
  514.  
  515.     The installation program will prompt you for the directory you wish to 
  516.     install DiskTree in.  By default this is C:\DISKTREE although you may 
  517.     change this if you want. The program will then copy all the required 
  518.     files for you. 
  519.  
  520.     Installing DiskTree by Hand
  521.  
  522.     MD C:\DISKTREE (or wherever you wish)
  523.     COPY A:\*.* C:\DISKTREE
  524.  
  525.     Having installed DiskTree and its supporting files, the file 
  526.     AUTOEXEC.BAT should be modified to include the path of the directory 
  527.     containing DiskTree. A typical PATH with DiskTree added to it might be: 
  528.  
  529.     PATH=C:\DOS;C:\WINDOWS;C:\DISKTREE
  530.  
  531.  
  532.  
  533.     6.  RUNNING DiskTree
  534.  
  535.     If DiskTree has been installed in a directory on DOS's search PATH, 
  536.     DiskTree will execute from anywhere.  If it has been set up in its own 
  537.     directory and is not on DOS's search PATH, you will have to change to 
  538.     the directory. 
  539.  
  540.     Example:
  541.  
  542.     (DiskTree has been installed in 'C:\DISKTREE')
  543.  
  544.     C:      <---' (RETURN or ENTER key)
  545.     CD \DISKTREE    <---'
  546.     
  547.     NOTE: If you run DiskTree from a directory that is different from the 
  548.     one the DiskTree files were installed in, you will have to run the 
  549.     APPEND command so that DiskTree can find its help system: 
  550.  
  551.     Example:
  552.  
  553.     You have installed DiskTree in the directory C:\DOS 
  554.     
  555.     To allow DiskTree to find the help system files, you must type the 
  556.     following before you run DiskTree: 
  557.     
  558.     APPEND C:\DOS
  559.     
  560.     This will allow DiskTree to find its help files. To avoid having to do 
  561.     this, simply change to the DiskTree directory before you run it. 
  562.     
  563.     The command syntax for running DiskTree is as followed: 
  564.  
  565.     DT {{drive}..{drive}}
  566.  
  567.     {drive}..{drive} is the name of the drive(s) you wish DiskTree to read 
  568.     at startup. 
  569.  
  570.     Example:
  571.  
  572.     To run DiskTree, reading drives 'C', 'D', and 'A' at startup: 
  573.     
  574.     DT C: D: A:    <---'
  575.     
  576.     If the configuration file (See 7.3.9) DISKTREE.CFG exists in the 
  577.     current directory, DiskTree will read it in and set the options 
  578.     accordingly. 
  579.  
  580.  
  581.     7.  USING DiskTree
  582.  
  583.     7.1 The user interface
  584.  
  585.     DiskTree's user interface is designed to work with either the mouse of 
  586.     the keyboard. The keyboard is recommended for those of you who are 
  587.     fairly proficient typists whilst other may find the mouse easier. In 
  588.     all cases, the keyboard and mouse can perform the same operations. 
  589.  
  590.     Most of DiskTree's functions are listed in reverse video boxes towards 
  591.     the bottom of the screen. The text in each box will have one letter in 
  592.     upper case, and this is the key you press to activate the option from 
  593.     the keyboard. i.e. 'T' for 'Tag'.  Moving the mouse cursor over one of 
  594.     these boxes and pressing either mouse button will also activate the 
  595.     option. In other operations such as 'Options' or 'taG mask' the same 
  596.     rules apply, but there can be other editable items as well. 
  597.  
  598.     Editable objects are usually listed down the screen together with a '<' 
  599.     next to the currently selected object. The up and down cursor keys move 
  600.     you from object to object. 
  601.  
  602.     Multi-select objects  are a list (horizontally) of the available 
  603.     options in the current object, such as 'On Off' or 'A C E F'. One of 
  604.     the items in the list will be highlighted and the highlight can be 
  605.     moved with the left and right cursor keys. 
  606.  
  607.     Editable text is entered on the keyboard and can be entered upto the 
  608.     size of the box the text is contained in. Pressing the TAB key will 
  609.     clear all text from box. The backspace key deletes text a character at 
  610.     a time. 
  611.  
  612.     General traversing of the directory tree and the files list are 
  613.     performed using the cursor keys or the mouse. Page up and page down 
  614.     move pages up or down. 
  615.  
  616.     The slide bars to the left of the directory tree and the files list are 
  617.     used (with the mouse only) to move up or down either line by line or 
  618.     page by page.  Clicking the mouse cursor over the directional arrows at 
  619.     the top or bottom of the slider will move up and down by one line. 
  620.     Clicking the mouse cursor above or below the solid bar which represents 
  621.     the position within the tree or list, will move up or down as many 
  622.     lines  as the solid part of the bar represents. Typically a page or so. 
  623.  
  624.     7.1.1   DiskTree's help system
  625.  
  626.     DiskTree has a context sensitive help system giving full help on most 
  627.     aspects of DiskTree's use. Context sensitive means that when help as 
  628.     asked for, help is given regarding the operation or function that is 
  629.     currently being carried out. 
  630.  
  631.     When DiskTree is executed, it checks for the existence of DISKTREE.HIX 
  632.     and DISKTREE.HLP in the current directory (See running DiskTree, 6). If 
  633.     they are available, the help system will be activated. 
  634.  
  635.     Help is activated by pressing the F1 (function 1) key. If help is 
  636.     available, the help window will appear giving relevant information for 
  637.     the current option or function. 
  638.  
  639.     The text can be scrolled by the cursor keys or by clicking the mouse 
  640.     cursor on required parts of the scroll bars to the left of the help 
  641.     window. 
  642.  
  643.     The information text takes two forms: 
  644.  
  645.     *  Normal text is displayed in the normal text colour.
  646.  
  647.     *  Further help topics displayed in the highlight colour. 
  648.  
  649.     Further help topics can be selected by the mouse or by using the SPACE 
  650.     bar to cycle through displayed help topics. Once a topic has been 
  651.     highlighted, pressing RETURN will activate help on that topic.  
  652.     Clicking the mouse on a previously highlighted topic will also active 
  653.     further help. 
  654.  
  655.     The 'Prev' option takes you back through the help system to previous 
  656.     help topics. 
  657.  
  658.     You can traverse the full help system at any point by selecting the 
  659.     'Index' option which selects the index of available topics of help. 
  660.  
  661.     Pressing the ESCAPE key ends the help session.
  662.  
  663.     7.2 Directory functions
  664.  
  665.     The directory functions display forms the central core of DiskTree, 
  666.     other options such as the file functions, appear as windows on top of 
  667.     this screen: 
  668.  
  669.     +-------[Drive C ]-------+---Statistics----+ +--Files...---+
  670.     | D        | Vol   DRIVE C | | IO.SYS   |
  671.     | +--DOS     | Files   1245 | | MSDOS.SYS  |
  672.     | +--WORK     | Dirs    8 | | COMMAND.COM |
  673.     |   +--ABC    | Free   18000 | | AUTOEXEC.BAT|
  674.     |   +--BACKUP    |----File mask----| | CONFIG.SYS |
  675.     |    +--ABC    | *.*    | |    |
  676.     |    +--TESTING   |---Current dir---| |    |
  677.     |       | D    | |    |
  678.     |       | Size    2456 | |    |
  679.     |       |---Current tree--| |    |
  680.     |       | Size   13609 | |    |
  681.     |       |---- Tagged -----| |    |
  682.     |       | Files    0 | |    |
  683.     |       | Dirs    0 | |    |
  684.     |       | Size    0 | |    |
  685.     +------------------------+-----------------+ +-------------+
  686.     +-------------------Directory functions--------------------+
  687.     | Tag Untag taG mask Find Copy Delete Move New dir Options |
  688.     |                 |
  689.     |Stat Log drv ^Log opt Zip RETURN to select files Quit|
  690.     +-F1 - help------------------------------------------------+
  691.  
  692.     The top-left part of the screen consists of a scrolling window showing 
  693.     the directory structure of the currently logged drive.  A highlight box 
  694.     and the scroll bar indicate the position within the directory tree. 
  695.     Information on the current directory (ie. size of files within it) and 
  696.     the current tree (all the files and directories including and below the 
  697.     current dir) is displayed to the right of the tree window.  The disk 
  698.     label, number of files and directories, plus the remaining space on the 
  699.     drive is also displayed together with the number of tagged files, 
  700.     directories and the size of the tagged files. 
  701.  
  702.     If the option 'Show files' is ON, the first 15 (depending on the number 
  703.     of lines on the screen) filenames are also listed in a window to the 
  704.     top right of the screen. 
  705.  
  706.     The directory list is always displayed in alphabetical order.
  707.  
  708.  
  709.     7.3 Directory function descriptions
  710.  
  711.     Directory functions (and file functions) are invoked either by: 
  712.  
  713.     moving the mouse cursor into the appropriate box and clicking either 
  714.     mouse button, 
  715.     
  716.     pressing the capital letter in the option you wish to select. eg. 'T' 
  717.     or 't' for 'Tag', 'O' or 'o' for 'Options'. Case is not important. 
  718.     
  719.     7.3.1   Tag
  720.  
  721.     Directory trees and the files within them can be selected (tagged) with 
  722.     this function.  Directories are only marked with a tag if one or more 
  723.     files within them match the tag mask.  Empty directories, however, are 
  724.     always marked as tagged, regardless of the tag mask.  This can lead to 
  725.     some confusion as an empty directory can be marked as tagged when, 
  726.     because it is empty, it has no files matching the tag mask. It is 
  727.     therefore best to avoid wasting diskspace with empty directories unless 
  728.     you really need them. 
  729.  
  730.     As  mentioned  previously,  if  the  option  'Recurse subdirectories' 
  731.     is ON, all sub-directories will also be tagged. 
  732.  
  733.     See also, file function tag (7.5.1)
  734.  
  735.     7.3.2   Untag
  736.  
  737.     The untag operation performs the reverse of the tag function. Unlike 
  738.     the tag option, the tag mask is not used and all tagged files, 
  739.     regardless of the tag mask are set to clear. 
  740.  
  741.     7.3.3   taG mask
  742.  
  743.     The tag mask selects which files can be tagged. There are three parts 
  744.     to the tag mask: 
  745.  
  746.     The file mask
  747.     
  748.     The file mask is a DOS format filename and can include wildcards.  Only 
  749.     file names which match the file mask will be taggable. 
  750.     
  751.     Examples:
  752.     
  753.     *.*    will allow all files to be tagged
  754.       
  755.     *.EXE   will allow all '.EXE' files to be tagged
  756.       
  757.     TEST*.*  will allow all files starting with 'TEST' to be tagged
  758.       
  759.     ????D*.* will allow all files with the fifth letter 'D' to be tagged.
  760.       
  761.     Before date
  762.     
  763.     In many circumstances, it is desirable to allow only files created 
  764.     before a given date to be tagged. If a date is placed in this option, 
  765.     only files which are created on or before this date will be taggable. 
  766.     
  767.     After date
  768.     
  769.     Just as the before date allows only files created before a date to be 
  770.     tagged, this option allows only files created after a given date to be 
  771.     tagged. 
  772.     
  773.     Dates are in the format DD/MM/YYYY.
  774.  
  775.     All the tag options apply at the same time, if a file mask, before date 
  776.     and after date are all set, only files which match all three will be 
  777.     taggable. 
  778.  
  779.     7.3.4   Find
  780.  
  781.     The find option searches for a directory or a file. A specific filename 
  782.     is expected and wild cards are not allowed. Once a file or directory 
  783.     name hes been entered, the position cursor moves to the top of the 
  784.     directory tree and moves down rapidly until either the object is found 
  785.     or the end of the tree is reached. If found, the position cursor will 
  786.     be left on the matching directory.  If not found, an message box 
  787.     appears saying so. 
  788.  
  789.     7.3.5   Copy
  790.  
  791.     The copy operation is used to copy all tagged files and directories on 
  792.     the currently logged drive. 
  793.  
  794.     The copy procedure is as follows:
  795.  
  796.     The destination path is entered:
  797.     
  798.     An dialog box will appear prompting for the destination path for the 
  799.     copy  operation.  Only valid DOS format paths can be entered and if the 
  800.     path you supply is not present, it will be created.  Pressing ESCAPE 
  801.     will terminate the copy operation. 
  802.     
  803.     If the destination you have entered is an existing FILE, the copy 
  804.     operation will terminate. 
  805.     
  806.     Retain original directory structure?
  807.     
  808.     DiskTree can retain the original directory structure if so desired, or 
  809.     all the directories contents can be copied to the destination path.  If 
  810.     the original structure is to be retained, all necessary directories 
  811.     will be created for automatically. 
  812.     
  813.     Files are copied
  814.     
  815.     The tagged files will then be copied.  A dialog box shows the progress 
  816.     of the operation and ESCAPE can be pressed to terminate the copy 
  817.     operation. If a problem occurs with the copy, such as the destination 
  818.     disk being full, write protected or otherwise, an error message will 
  819.     appear and the copy operation will terminate. 
  820.     
  821.     Results
  822.     
  823.     When finished or terminated, a message will appear informing of the 
  824.     result of the copy operation. The message will either be 'Tree(s) 
  825.     copied ok' indicating a fully successful operation or, 'Tree(s) only 
  826.     partially copied' indicating that for reasons mentioned above, the 
  827.     operation could not be fully completed. 
  828.     
  829.     7.3.6   Delete
  830.  
  831.     The delete  operation affects all tagged files on the currently logged 
  832.     drive. 
  833.  
  834.     For safety, DiskTree will ask you if you really wish to continue with 
  835.     the delete operation.  If answered in the affirmative, a final check 
  836.     will query you again before a dialog box appears detailing the progress 
  837.     of the delete operation.  ESCAPE can be used to terminate the delete 
  838.     operation. 
  839.  
  840.     A directory marked as tagged will NOT be deleted if it contains any 
  841.     files which either cannot be deleted or were not tagged.  Thus, even 
  842.     though the directory is tagged, it will not necessarily be deleted. 
  843.  
  844.     NOTE:  DiskTree will not automatically delete read-only and hidden 
  845.     files if the 'last chance' options are ON. If the last-chance checks 
  846.     are on, you will be prompted before deletion. 
  847.  
  848.     7.3.7   Move
  849.  
  850.     The move option is a combination of copy and delete. Tagged files are 
  851.     first copied and if the operation is successful, the tagged files are 
  852.     then deleted. See 7.3.5 for details. 
  853.  
  854.     NOTE: As the files are first copied before being deleted, it is 
  855.     possible to have two copies of the file trees on the drive at the same 
  856.     time.  Since this will happen if source and destination drives are the 
  857.     same, make sure that you have enough disk space free to hold the files 
  858.     during the move process. 
  859.  
  860.     7.3.8   New directory
  861.  
  862.     This option is used to create new directories.  An entire path can be 
  863.     created with this option, not just an individual directory. 
  864.  
  865.     Example:
  866.     
  867.     Creating a new directory of 
  868.     
  869.     C:\TMP\MODULA2\BACKUP
  870.     
  871.     would create all the directories in the path if they did not already 
  872.     exist.  ie. 'TMP' would be created on drive 'C', 'MOUDLA2' would 'be 
  873.     created within 'TMP' and 'BACKUP' would be created within 'MODULA2' 
  874.  
  875.     A newly created path does not have to be on the currently logged drive. 
  876.  
  877.     7.3.9   Options
  878.  
  879.     DiskTree's options and parameters are split into several sub menus: 
  880.  
  881.     7.3.9.1  Checks/flags
  882.  
  883.  
  884.     File deletion check
  885.  
  886.     If this option is ON, a check is carried out before a file is deleted. 
  887.     (Default ON). 
  888.     
  889.     Recurse directory trees
  890.     
  891.     When ON, the entire tree will be affected by the tag operation.  
  892.     Otherwise only individual directories are affected. (Default ON). 
  893.     
  894.     System/hidden last chance check
  895.     
  896.     If a file is hidden or system, a check is carried out before the file 
  897.     is deleted. (Default ON). 
  898.     
  899.     Read only last chance check
  900.     
  901.     As above except for read only files.
  902.     
  903.     Tree deletion check
  904.     
  905.     When this option is ON, two final checks are made before a tree delete 
  906.     operation is carried out. It is advisable to leave this on at all 
  907.     times. (Default ON). 
  908.     
  909.     View files within directory
  910.     
  911.     When this option is ON, a list of the first few files within the 
  912.     current directory is displayed in a window to the top right of the 
  913.     screen. (Default ON). 
  914.     
  915.     Auto view files
  916.     
  917.     This option is only applicable to the file functions. When ON, the 
  918.     first few bytes of the current file will be displayed in a window at 
  919.     the bottom of the screen. (Default OFF). 
  920.     
  921.     Use inbuilt file viewer
  922.     
  923.     DiskTree has a simple file viewing facility built into it but  should 
  924.     another  file viewing  program  be preferable, this option should be 
  925.     set to OFF.   The viewer path should point to the viewer that is to be 
  926.     used instead. 
  927.     
  928.     Untag drive after tree copy
  929.     
  930.     When this option is ON, all files/directories are untagged after a tree 
  931.     copy operation.  This minimises the risk of accidental file deletion. 
  932.     (Default ON). 
  933.  
  934.     File information
  935.     
  936.     This defines the default way DiskTree displays file information in the 
  937.     file functions screen.  If set to full information, maximum information 
  938.     is displayed about each file. If set to brief, only filenames are 
  939.     listed in three columns. 
  940.     
  941.     7.3.9.2  External links
  942.  
  943.     The external links options provide links to other applications that you 
  944.     may wish to run from inside DiskTree. 
  945.  
  946.     There are basically three different types of information that can be 
  947.     entered in the external links dialog. 
  948.  
  949.     Editor and viewer path:
  950.     
  951.     If you wish to use a text editor or an external file viewer/browser you 
  952.     must define their locations in the appropriate text boxes. 
  953.     
  954.     NOTE: If you wish to use an external file viewer, you must set the 
  955.     Checks/options 'Use internal viewer' to OFF. 
  956.     
  957.     Zip command:
  958.     
  959.     This defines the command and parameters that the PKZIP file compression 
  960.     utility uses to perform its file compression operations. By default, 
  961.     the zip command set up within DiskTree should work without 
  962.     modification, but should future  versions  of  PKZIP  use  different 
  963.     parameters, you can enter any required parameters. 
  964.     
  965.     NOTE: The  PKZIP.EXE file should be present in a directory along DOS's 
  966.     search PATH. 
  967.     
  968.     Links to external applications: 
  969.  
  970.     Applications are  linked to  DiskTree by  filename extensions.   In 
  971.     general,  most applications  give associated files  a particular  
  972.     extension.   E.G. Microsoft Word gives word format files the extension 
  973.     'DOC'. 
  974.     
  975.     To define a link to an external application/program, move the cursors 
  976.     to the appropriate extension text box line and enter the extension that 
  977.     the application you wish to link uses. 
  978.     
  979.     Example:
  980.     
  981.     DOC  { we are linking in Microsoft Word }
  982.     or
  983.     ZIP  { we are linking in PKZIP }
  984.     
  985.     Next, move the cursor right to the application location box and enter 
  986.     the full path of the application together with any parameters. 
  987.     
  988.     Example:
  989.     
  990.     C:\WORD\WORD.EXE {Word's pathname}
  991.     or
  992.     C:\DOS\PKZIP.EXE -V {PKZIP's pathname} plus the VIEW parameter}
  993.     
  994.     Links are executed on the file functions screen by moving the highlight 
  995.     cursor to the required file and pressing RETURN/ENTER.  DiskTree will 
  996.     then check its link table and if a matching extension is found, will 
  997.     attempt to load the required application and selected file. 
  998.     
  999.     Using the above examples, DiskTree would load Microsoft Word if  a 
  1000.     filename with the extension 'DOC' was selected.  If a file with the 
  1001.     extension 'ZIP' were selected, DiskTree would attempt to load PKZIP 
  1002.     with the VIEW parameter, therefore listing the contents of the ZIP 
  1003.     file. 
  1004.     
  1005.     NOTE: Bear in mind that DiskTree will remain in memory during 
  1006.     application execution and that memory will be limited by how much 
  1007.     DiskTree is taking to hold its drive tree's (See Memory Usage (Appendix 
  1008.     1) below).  As a general rule, keep applications as small as possible. 
  1009.     
  1010.     7.3.9.3  Sort criteria
  1011.  
  1012.     Files are displayed in the file functions window according to 
  1013.     DiskTree's sort  criteria.   The default sort mode is Alphabetic. 
  1014.  
  1015.     Sort criteria explanation:
  1016.     
  1017.     NoSort - Files are displayed in no particular order. 
  1018.     
  1019.     Extension - Files are sorted by extension and then by the first part of 
  1020.     the name if the extensions are the same. 
  1021.     
  1022.     Alphabetic - Files are sorted by the complete filename. 
  1023.     
  1024.     Newer - Files are sorted by the date stamp of the file. Newer files are 
  1025.     listed first. 
  1026.     
  1027.     Older - As above, but older files are listed first. 
  1028.     
  1029.     The sort criteria also affect the speed in which the drive details are 
  1030.     read into memory; NoSort is the fastest method, Newer or Older are next 
  1031.     fastest, Alphabetic is next and Extension is the slowest.  The actual 
  1032.     speed depends on the number of files in a directory.  The less, the 
  1033.     faster. In general use, however, there is no great difference between 
  1034.     any of the options. 
  1035.  
  1036.     If the file sort criteria changes, you will be given the option to re-
  1037.     read the currently selected drive with the new sort criteria.  It is 
  1038.     wise to note that DiskTree can take some time to read in large drives. 
  1039.  
  1040.  
  1041.     7.3.9.4  Variables shortcuts
  1042.  
  1043.     Variables can  reduce typing by being defined to hold frequently used 
  1044.     text.  Commands, paths, names etc can be defined and associated with a 
  1045.     letter that is used to substitute for the text in dos commands etc. For 
  1046.     DiskTree to recognise that a letter has been defined as a variable you 
  1047.     must indicate that it has by placing a '%' in front of the letter. 
  1048.  
  1049.     In addition to user defined variables, DiskTree has a couple of build 
  1050.     in variables. '%F' can be used as a substitute for the currently 
  1051.     selected filename and '%D' can be used as the currently selected 
  1052.     directory. 
  1053.  
  1054.     Example of variables in use:
  1055.  
  1056.     Suppose that you are in the directory 'C:\DOS\BACKUP' and are  in the  
  1057.     file functions  window and have highlighted the file 'COMMAND.COM'. 
  1058.     
  1059.     By typing '%D%F' you save the need to type in the full path 
  1060.     C:\DOS\BACKUP\COMMAND.COM. 
  1061.     
  1062.     Suppose that you have a directory 'D:\BACKUP\DRIVEC\' that you 
  1063.     regularly use to copy files to.  Instead of typing it every time you 
  1064.     needed to use it, you could define it as, say, '%B' so that you can 
  1065.     just type '%B' instead of the full text. 
  1066.     
  1067.     7.3.9.5  Keep (save options)
  1068.  
  1069.     Use this option to save DiskTree's current options, links, variables 
  1070.     etc.. DiskTree always saves its 'configuration' file as DISKTREE.CFG. 
  1071.  
  1072.     DiskTree will automatically read this file in upon execution and set 
  1073.     all the options accordingly. 
  1074.  
  1075.     7.3.9.6  RETURN & ESCAPE 
  1076.  
  1077.     Return to continue with new options, escape to exit, ignoring changes. 
  1078.  
  1079.  
  1080.     7.3.10  Stat 
  1081.  
  1082.     This option returns the disk statistics of the currently logged drive. 
  1083.     Information is returned on: 
  1084.  
  1085.     Bytes per sector - the number of bytes in each disk sector. Usually 
  1086.     512. 
  1087.     
  1088.     Sectors per cluster - the number of sectors in each disk cluster. 
  1089.     Usually 1,2 or 4. 
  1090.     
  1091.     Free clusters - the number of free clusters on the currently logged 
  1092.     drive. 
  1093.     
  1094.     Drive capacity (clusters) - the number of clusters on the currently 
  1095.     logged drive. 
  1096.     
  1097.     Drive capacity (KBytes) - the size of the current drive in KBytes (1024 
  1098.     bytes). 
  1099.     
  1100.     KBytes used (in files) - the number of bytes actually contained in  
  1101.     disk files.   This  is not a true representation of the amount of bytes 
  1102.     actually used but the size of the data contained in disk files. It does 
  1103.     not include the space used by directory information and slack space in 
  1104.     the unused part of a cluster. 
  1105.     
  1106.     KBytes used (real) - the real disk space used.  The minimum file size 
  1107.     is 1 cluster (normally 2048 bytes) even if the file length is just 1 
  1108.     byte. This means that disk space is often used up at a quicker rate 
  1109.     than is obvious from looking at the actual file length.  The difference 
  1110.     between this value and the kbytes used in files is called slack space. 
  1111.     
  1112.     KBytes free - number of Kbytes free.
  1113.     
  1114.     Percentage free - the percentage of the current drive that free. 
  1115.     
  1116.     7.3.11  Log drive
  1117.  
  1118.     Logging a drive is equivalent to changing to a new drive. When the log 
  1119.     drive option is invoked, a list of available drives is displayed 
  1120.     together with a tick over drives which are actually in memory.  Use the 
  1121.     left and right cursor keys to highlight the drive you wish to log. If 
  1122.     the new drive has not been previously logged, it will be read in to 
  1123.     memory. 
  1124.  
  1125.     If an 'out of memory' message appears, the drive read is cancelled.  
  1126.     Use the ^Log options (7.3.12) to remove from memory any unwanted drives 
  1127.     or, if this doesn't give enough space, remove any TSR's etc. 
  1128.  
  1129.     NOTE: Logging a drive that is already in memory will not re-read it.  
  1130.     If this is required, use the log option 'Re Read' drive. 
  1131.  
  1132.     7.3.12  ^Log options
  1133.  
  1134.     Log options contains functions to re-read a drive into memory and 
  1135.     remove drives from memory. 
  1136.  
  1137.     Remove drive from memory 
  1138.     
  1139.     If you wish to free up memory, or have no need for a particular drive 
  1140.     any more, you can remove it from memory.  However, at least ONE drive 
  1141.     must be in memory at any time.  So this operation will fail of the 
  1142.     currently logged drive is the only one. Use this option if you have 
  1143.     problems with 'Cannot run program' when attempting to run a program. 
  1144.     
  1145.     If a drive has been successfully removed from memory, the new logged 
  1146.     drive will the first one in the list of drives in memory. 
  1147.     
  1148.     Re-read drive
  1149.     
  1150.     This option is useful, for example, when you have run a program from  
  1151.     the file functions window which has effected the directory structure of 
  1152.     the drive. Also, if the file sort criteria have changed, you may wish 
  1153.     to re-read the drive with file listed in the correct order. 
  1154.     
  1155.     If you are using DiskTree with a removable drive (floppy, usually), a 
  1156.     re-read operation must be performed after each disk change to get the 
  1157.     new disks directory structure into memory. 
  1158.     
  1159.     
  1160.     7.3.13  Zip.
  1161.  
  1162.     The Zip function works on tagged files just as copy or delete does. 
  1163.     Simply tag the directories or files you want to zip up and select this 
  1164.     function.  There are two modes of operation to the zip function: 
  1165.  
  1166.     7.3.13.1 Zip all tagged files on current drive. 
  1167.  
  1168.     If you use this option, DiskTree will cause PKZIP to create a zip file 
  1169.     containing FULL paths of any zipped directories or files even if the 
  1170.     tagged files are at the bottom of a directory tree.  What this in fact 
  1171.     means is that you would only be able to really use this option for 
  1172.     back-up purposes. If you unzip a zip file created in this way, the FULL 
  1173.     path of the files will be recreated. 
  1174.  
  1175.     7.3.13.2 Zip in the currently directory and below.
  1176.  
  1177.     Use this  option if you want to create zip files of directories or 
  1178.     files without storing the full path through to the files.  DiskTree 
  1179.     will cause PKZIP to store only the necessary directory  names from  the 
  1180.     current  directory downwards through the tree. This means that you can 
  1181.     unzip a file created in this way and get an exact copy of the original 
  1182.     directory structure with out the names of the directories above the 
  1183.     start point in the tree. 
  1184.  
  1185.     This may all sound a little complicated, so probably the best way to 
  1186.     really work out what the differences between these two modes of 
  1187.     operation is to try them out. 
  1188.  
  1189.     When unzipping any zip files that have sub-directories in them, use the 
  1190.     PKUNZIP parameter '-D' to cause PKUNZIP to create any required 
  1191.     directories. For a fuller description of how the PKUNZIP & PKZIP work, 
  1192.     consult relevant documentation. 
  1193.  
  1194.     NOTE:  Try to avoid zipping up too many incompletely tagged directories 
  1195.     as PKZIP uses up more memory if it can't just uses '*.*' to deal with a 
  1196.     directories contents. 
  1197.  
  1198.  
  1199.     7.3.14  RETURN to select files 
  1200.  
  1201.     Pressing RETURN opens up the file function window (See 7.4) 
  1202.  
  1203.  
  1204.     7.3.15  Quit DiskTree 
  1205.  
  1206.     Use this option to quit from DiskTree. 
  1207.  
  1208.  
  1209.     7.4 File functions
  1210.  
  1211.     File operations are performed with file functions. The file functions 
  1212.     window appears over the directory functions screen: 
  1213.     
  1214.     +--C:\--------------------------------------[ALL]-+
  1215.     | IO.SYS    22398 02/02/1988 00:00:02 HSR |
  1216.     | MSDOS.SYS   30128 02/02/1988 00:00:02 HSR |
  1217.     | COMMAND.COM  25308 02/02/1988 00:00:02 HSR |
  1218.     | AUTOEXEC.BAT  267 07/02/1991 22:43:56   |
  1219.     | CONFIG.SYS   258 07/03/1991 22:37:20   |
  1220.     |              |
  1221.     |              |
  1222.     |              |
  1223.     |              |
  1224.     |              |
  1225.     |              |
  1226.     |              |
  1227.     | Tag ^Tag all Untag ^Untal all Copy  Delete |
  1228.     |              |
  1229.     | Move Attrib Invert  View Edit eXec Rename |
  1230.     |              |
  1231.     | taG mask Show MATCH dOs cmd disPlay  ESCAPE |
  1232.     +-Tagged  0 KBytes  0 Tagged  0 KBytes  0-+
  1233.     
  1234.     Operation of file functions is very much the same as directory ones.  
  1235.     The cursor keys or mouse move the highlight up and down the screen, 
  1236.     scrolling the list of files if necessary. The scroll bar indicates 
  1237.     position within the list of files.  The scrollable part of the window 
  1238.     lists the files within the current directory.  Each directory entry is 
  1239.     displayed as: 
  1240.  
  1241.     TAG  FILENAME SIZE    DATE   TIME  ATTRIBS
  1242.  
  1243.     eg: >> CONFIG.SYS  258  02/03/1991 22:37:20
  1244.  
  1245.     The TAG is displayed when a file is marked as tagged. FILENAME is 
  1246.     obvious.  SIZE is the file size in bytes. DATE is the date-stamp of the 
  1247.     file in the British format, DAY/MONTH/YEAR.  TIME is the time-stamp of 
  1248.     the file in the format,  HOURS:MINS:SECONDS.  ATTRIBS the files 
  1249.     attributes, R for Read-Only, H for Hidden, S for System. 
  1250.  
  1251.     Details of tagged files are displayed at the bottom of the file 
  1252.     functions window.  The first two 'Tagged, KBytes' are details of all 
  1253.     tagged files on the current drive. The second set are for the current 
  1254.     directory.  The main difference between these values is that the first 
  1255.     set apply to directory tree functions and the second apply to file 
  1256.     functions only. 
  1257.  
  1258.     The number of files listed on the screen is dependent upon the number 
  1259.     of lines down the screen and whether the option 'auto view files' is 
  1260.     ON. 
  1261.  
  1262.     NOTE:  If any files are tagged by file operations, when control is 
  1263.     returned back to the directory functions, the directory itself will 
  1264.     also be tagged.  Similarly, if there are no tagged files, the directory 
  1265.     tag will be removed. 
  1266.  
  1267.  
  1268.     7.5 File function descriptions. 
  1269.  
  1270.     File functions are invoked in the same way as directory functions (See 
  1271.     7.2). 
  1272.  
  1273.     7.5.1   Tag
  1274.  
  1275.     This operation tags individual files only.  Files are only tagged 
  1276.     (marked with '>>') if they match the tag mask. (See 3.2, 7.3.3).  After 
  1277.     the file has been tagged (or not), the highlight moves on to the next 
  1278.     file in the list. 
  1279.  
  1280.     As with directory functions, most file functions work on tagged files.  
  1281.     However, eXec, Edit, Rename and View do not. These operations work on 
  1282.     the currently highlighted file. 
  1283.  
  1284.  
  1285.     7.5.2   ^Tag all
  1286.  
  1287.     The operation, tag, mentioned above tags individual files. The tag all 
  1288.     operation tags all files matching the tag mask within the current 
  1289.     directory. 
  1290.  
  1291.  
  1292.     7.5.3   Untag
  1293.  
  1294.     Untag, unsurprising perhaps, untags the currently highlighted file. 
  1295.     Like tag, it moves down to the next file in the list. 
  1296.  
  1297.  
  1298.     7.5.4   ^Untag all 
  1299.  
  1300.     Does the exact opposite of tag all (7.5.2).
  1301.  
  1302.  
  1303.     7.5.5   Copy
  1304.  
  1305.     The file function copy is different from the directory function copy in 
  1306.     that only tagged files in the CURRENT directory function are affected.  
  1307.     Tagged files in other directories are not included in the scope of the 
  1308.     copy. Apart from this, they are identical. See 7.3.5 for details of the 
  1309.     procedure. 
  1310.  
  1311.  
  1312.     7.5.6   Delete
  1313.  
  1314.     As with the copy function, the file function delete affects only tagged 
  1315.     files within the current directory.  The file function delete does not 
  1316.     have the safeguards on accidental use as the potential for damage is 
  1317.     not so great. Apart from these differences, functionality is identical. 
  1318.     See 7.3.6 for details of the procedure. 
  1319.  
  1320.  
  1321.     7.5.7   Move
  1322.  
  1323.     Move is a combination of copy and delete.  The files are first copied, 
  1324.     and if totally successful, the originals are deleted. Hence moved. If 
  1325.     during the copy stages, any errors occur, the move operation will be 
  1326.     terminated immediately. 
  1327.  
  1328.  
  1329.     7.5.8   Attrib
  1330.  
  1331.     Under DOS, each file has a set of attributes - read-only, hidden and 
  1332.     system.  Read-only files cannot be deleted and hidden files do not show 
  1333.     up using normal DOS commands (Dir etc..).  The system attribute is a 
  1334.     throw back from the operating system CPM, and has the same effect as 
  1335.     the hidden attribute.  Normally most files will not have any of these 
  1336.     attributes set.  However, in some circumstances (Networks etc..) 
  1337.     attributes need to be set to protect the files and prevent such things 
  1338.     as sharing violations. Eg. On a Network, executable files are normally 
  1339.     set to Read Only. 
  1340.  
  1341.     On selecting this option, a dialog box will appear detailing the 
  1342.     available attributes. By default, the attributes are set to OFF, using 
  1343.     the cursor keys (or mouse), you can set them to ON. The attrib option 
  1344.     only affects tagged files. 
  1345.  
  1346.  
  1347.     7.5.9   Invert 
  1348.  
  1349.     The invert option inverts the tag marks in the current directory.  
  1350.     Tagged files become untagged and untagged files become tagged. 
  1351.  
  1352.     See also 3.1.2
  1353.  
  1354.  
  1355.     7.5.10  View (or pressing RETURN) 
  1356.  
  1357.     The view option is used to view the contents of the currently 
  1358.     highlighted file. If the option 'Use inbuilt file viewer' is OFF, 
  1359.     DiskTree will load the file viewer you have specified in the 'viewer 
  1360.     path'. Otherwise, DiskTree will use its built-in file viewing facility. 
  1361.  
  1362.     There are three modes to the file viewer: ASCII mode where NULLs and 
  1363.     carriage returns are classed as line terminators and BINARY mode where 
  1364.     they are not. The third mode, Hex, displays files in hexadecimal 
  1365.     notation. 
  1366.  
  1367.     Binary and Hex modes are intended for files such as .COM's or .EXE's.  
  1368.     The file viewer will attempt to set the viewer mode according to how 
  1369.     the data contained in the file. 
  1370.  
  1371.     View in use
  1372.  
  1373.     The file viewer displays files in pages. Use the 'U' or 'D' keys to 
  1374.     page up and down through the file or select the boxes on the screen 
  1375.     with the mouse cursor. A count of the byte position of the start of the 
  1376.     page is displayed at the bottom right of the view window. 
  1377.     
  1378.     The viewing mode can be changed by pressing either 'A' for ASCII or 'B' 
  1379.     for binary. Alternatively, the mouse can be used. 
  1380.     
  1381.     The hex mode is selected by pressing 'H' or selecting the relevant box 
  1382.     with the mouse if available. In hex mode, the display is split between 
  1383.     a HEX list of the ASCII values of the characters the right of the 
  1384.     screen. Moving through the file is as in any of the other modes. 
  1385.     
  1386.     When viewing binary files, there are usually a lot of non text 
  1387.     characters which make reading text characters difficult.  DiskTree can 
  1388.     strip these characters and replace them with dots '.'.  The strip 
  1389.     facility is toggled on and off with the 'S' key. 
  1390.     
  1391.     Pressing the ESCAPE key will exit the file viewer. 
  1392.  
  1393.     Loading an external viewer is just like running any other program and 
  1394.     as such, enough memory should be set aside. If DiskTree cannot load the 
  1395.     external viewer, it will use the inbuilt one. 
  1396.  
  1397.  
  1398.     7.5.11  Edit
  1399.  
  1400.     DiskTree does  not include  an editor as part of its facilities.  If 
  1401.     you need to use an editor, you must set the option 'editor path' to the 
  1402.     location of the one you wish to use. 
  1403.  
  1404.  
  1405.     7.5.12  eXec (or pressing RETURN)
  1406.  
  1407.     DiskTree can execute either COM, EXE or BAT files. Batch (.BAT) files 
  1408.     are executed by invoking the command line interpreter -  COMMAND.COM.   
  1409.     DiskTree will  check the environment variable COMSPEC for the location 
  1410.     of COMMAND.COM. Therefore, your systems AUTOEXEC.BAT file should 
  1411.     contain the following line: 
  1412.  
  1413.     SET COMSPEC=C:\COMMAND.COM    (or other path)
  1414.  
  1415.     DiskTree allows you to set parameters for the program you wish to run 
  1416.     and these should be entered in the field provided on the screen. 
  1417.  
  1418.     By default, DiskTree will move DOS's 'current dir' to the current 
  1419.     DiskTree directory. This will normally be desirable as it is likely 
  1420.     that the program you are trying to execute may need access other files 
  1421.     within the directory. This facility may be turned OFF if desired.  The 
  1422.     option of re-reading the directory after execution is also provided and 
  1423.     should be left ON so that an up-to-date directory list is maintained in 
  1424.     memory. 
  1425.  
  1426.     If the message 'Cannot run program' appears, it is likely that there is 
  1427.     not enough memory to run the program. Once the program you are 
  1428.     executing has finished, control is passed back to DiskTree. 
  1429.  
  1430.     7.5.13  Rename
  1431.  
  1432.     The currently highlighted file can be renamed with this function.  The 
  1433.     file will be renamed to the entered name unless the entered name exists 
  1434.     or the drive is write protected etc.. 
  1435.  
  1436.     7.5.14  taG mask
  1437.  
  1438.     Use this option to change DiskTree's tag mask. Operation is identical 
  1439.     to the directory tree function of the same name. 
  1440.  
  1441.     If the show MATCH (7.5.15) function has been activated, changing the 
  1442.     tag mask will also effect which files are listed in the window. 
  1443.  
  1444.     7.5.15  Show MATCH/ALL
  1445.  
  1446.     It is often desirable to list only files which actually match the tag 
  1447.     mask. Usually, since the tag mask matches all files, this option will 
  1448.     have no effect.  If, however the tag mask has been set to specific 
  1449.     files, only those matching the mask will be listed in the files window. 
  1450.  
  1451.     The show MATCH/ALL operation functions in a toggle fashion -if show 
  1452.     MATCH is on, selecting it again will turn it off and show all files, 
  1453.     regardless of whether they match the tag mask or not. 
  1454.  
  1455.     DiskTree will automatically turn this option on if the tag mask is 
  1456.     anything other than the default 'all files' on entry to the file 
  1457.     functions window. 
  1458.  
  1459.     7.5.16  dOs cmd
  1460.  
  1461.     Dos commands such as 'dir' or other programs can be run with this 
  1462.     option.  The command or program name must be entered together with 
  1463.     parameters if required. The option of changing to the current directory 
  1464.     is available, as is the option of re-reading the directory after the 
  1465.     command is completed. By default, DiskTree will do both. 
  1466.  
  1467.  
  1468.     7.5.17  disPlay
  1469.  
  1470.     This function changes the file display from 3 column (minimum 
  1471.     information) to 1 column (maximum information) and vice-versa. 
  1472.  
  1473.  
  1474.     7.5.18  ESCAPE to leave file functions
  1475.  
  1476.     Use this option to return control back to the main directory tree 
  1477.     functions. 
  1478.  
  1479.  
  1480.  
  1481.     APPENDICES
  1482.  
  1483.  
  1484.     APPENDIX 1   Using DiskTree over a network
  1485.  
  1486.     DiskTree makes no distinction between local and network drives and will 
  1487.     happily work on either. It is wise, however to note the following: 
  1488.  
  1489.     DiskTree reads in the directory structure in one chunk and represents 
  1490.     the structure at a point in time.  With other users on the network, it 
  1491.     is quite possible that files and the directory structure may have 
  1492.     changed. Therefore, it is best to ensure that there are as few users on 
  1493.     the system as possible.  Failing this, re-reading the drive is the next 
  1494.     best solution but slower. 
  1495.  
  1496.     NOTE:  These problems will probably only become apparent if you are 
  1497.     using a system as the network manager (or someone with sufficient 
  1498.     access).  i.e, you are using DiskTree on drives containing user areas.  
  1499.     If DiskTree is used on read-only drives etc, changes are only likely if 
  1500.     the network manager has modified the directory structure since you 
  1501.     started DiskTree. 
  1502.  
  1503.  
  1504.     APPENDIX 2   Improving system performance
  1505.  
  1506.     No one could say that DOS was particularly good as a modern operating 
  1507.     system (or even as an operating system at all) but for most of us, were 
  1508.     stuck with it.  There are, however a number of things that can be done 
  1509.     to improve it or at least make it faster. 
  1510.  
  1511.     Improving disk performance
  1512.  
  1513.     There are several things that effect disk performance apart from the 
  1514.     drive controller and the drive itself. 
  1515.     
  1516.     a) Buffers
  1517.     
  1518.     If you look at your CONFIG.SYS file, you will probably see something 
  1519.     like: 
  1520.     
  1521.     BUFFERS=20
  1522.     
  1523.     This line tells DOS how many buffers to use when accessing disk drives. 
  1524.     A reasonable figure for general use is 20, any more and you'll waste 
  1525.     memory (especially with a disk cache in operation), any less an 
  1526.     performance is likely to drop for some applications. 
  1527.     
  1528.     b) Disk caching
  1529.     
  1530.     Increasing DOS's disk buffers is one solution, but a better one is disk 
  1531.     caching. A disk cache keeps the most recently used parts of your hard 
  1532.     disk in memory and instead of having to read them disk which is slow, 
  1533.     the cache will read from memory.  A disk cache is a more efficient 
  1534.     solution than that of a ram-disk in that most frequently accessed data 
  1535.     will automatically be placed in the cache for speedy access. 
  1536.     
  1537.     There are several caching programs available, but the one most commonly 
  1538.     used is SMARTDRV.SYS 
  1539.     
  1540.     Smartdrive should be included in the CONFIG.SYS of your system. 
  1541.     
  1542.     Example:
  1543.     
  1544.     DEVICE=C:\SMARTDRV.SYS 1024
  1545.     
  1546.     This example is for a 386 equipped machine, with a megabyte or more of 
  1547.     extended memory. 
  1548.     
  1549.     If your machine has expanded memory, '/A' should be added on the end of 
  1550.     the line: 
  1551.     
  1552.     DEVICE=C:\SMARTDRV.SYS 1024 /A
  1553.     
  1554.     Obviously, the size of the disk cache you set up will be limited by how 
  1555.     much memory your machine has and how much you need to leave free for 
  1556.     other applications.  For useful purposes, 256 kbytes of disk cache 
  1557.     should be considered a minimum and there is no real advantage in having 
  1558.     much more than 1 megabyte. 
  1559.  
  1560.  
  1561.     Increasing memory
  1562.  
  1563.     The biggest single problem in MS-DOS machines is the 640K limit. All 
  1564.     DOS (not Windows3) applications have to squeeze into this space 
  1565.     together with the operating system, and any other resident 
  1566.     applications. MS-DOS 5 and MS-DOS replacements such as DR DOS 5.0 can 
  1567.     increase available space by moving portions of the operating system and 
  1568.     TSR's into memory above the 640K barrier. Expanded memory managers such 
  1569.     as QEMM.SYS (the 386 version) can also do this. However, 640K is still 
  1570.     the limit, even if your machine has 16 megabytes of memory!. An example 
  1571.     of this is the machine used for DiskTree's development.  The machine in 
  1572.     question is a 25 MHZ 80386 machine with 4 megabytes of memory, most of 
  1573.     which remains unused under DOS. 
  1574.     
  1575.     If the lack of memory becomes a real difficulty, try removing some of 
  1576.     the device drivers (with the .SYS extension) you may have in you 
  1577.     CONFIG.SYS. Also check that no TSR programs are listed in the 
  1578.     AUTOEXEC.BAT of your machine if you do not really need them. A word of 
  1579.     caution, be careful what .SYS files you remove from CONFIG.SYS as some 
  1580.     of them may be required for other applications. 
  1581.     
  1582.     Although the 640K limit is a real problem, it is not one that the 
  1583.     average DiskTree user will find a great handicap unless DiskTree is 
  1584.     being used on machines with very full hard disks or on big networks. 
  1585.  
  1586.     For further reading read the book 'Supercharging MSDOS' listed below. 
  1587.  
  1588.     DiskTree's minimum memory usage is around 191K. It stays at 191k for 
  1589.     around a 1000 files/directory and increases in stages of 64k.  Each 64k 
  1590.     will cope with a 2000 or so files and directories.  On a machine 
  1591.     running MS-DOS 5 with mouse drivers, disk caches etc , with 950 files 
  1592.     on disk, well over 400k is left free for applications. 
  1593.  
  1594.  
  1595.     APPENDIX 3   Bibliography / reading list
  1596.  
  1597.     PC System programming. ISBN 1-55755-036-0. Abacus. 
  1598.  
  1599.     If you are a serious pc system programmer who needs a complete 
  1600.     reference to the low-level features of DOS and the IBM PC machine 
  1601.     series, look no further. But beware! It weights a ton and costs a 
  1602.     fortune. Still, it does come with over a MB of source code in C, 
  1603.     Assembler, Turbo Pascal and Basic. 
  1604.     
  1605.     The NEW Peter Norton Programmer's Guide to The IBM PC & PS/2, Microsoft 
  1606.     Press, ISBN 1-55615-131-4. 
  1607.  
  1608.     A must for any serious programmer. Contains detailed information on the 
  1609.     PC's BIOS, MSDOS, video, disk and keyboard services plus many hints and 
  1610.     tips. 
  1611.     
  1612.     Microsoft MS-DOS Programmers Reference. 
  1613.  
  1614.     Contains some  useful information  and examples in assembler. 
  1615.  
  1616.     Advanced MS-DOS, Microsoft Press.
  1617.  
  1618.     Detailed information on low-level programming of the IBM'PC. 
  1619.     
  1620.     MS-DOS Functions, Microsoft Press, ISBN 1-55615-128-4. 
  1621.  
  1622.     Handy and inexpensive guide to MSDOS function calls. 
  1623.     
  1624.     Introduction to Modula-2, Prentice Hall, ISBN 0-13-488610-0 
  1625.  
  1626.     DiskTree was written in Modula-2, and this is the first book I bought 
  1627.     on the subject.  The book deals with Modula-2 in general and is not PC 
  1628.     specific. However, as an introduction to Modula-2 and programming in 
  1629.     general it is very good. 
  1630.     
  1631.     DOS the Complete Reference, McGraw hill. 
  1632.  
  1633.     A massive tomb covering everything from batch files to DOS system calls 
  1634.     and Windows. If you are only going to buy one book, this is as good as 
  1635.     any. 
  1636.     
  1637.     Supercharging MSDOS. 
  1638.  
  1639.     Gives hints and tips on getting the most out of your DOS based system. 
  1640.     
  1641.  
  1642.     APPENDIX 4   Support software.
  1643.  
  1644.     Colour configuration program - CONFIG.EXE.
  1645.  
  1646.     Included as part of the DiskTree package is a colour configuration 
  1647.     program for changing the colours you see when using DiskTree. 
  1648.  
  1649.     For general  use, the default colour scheme should be satisfactory but 
  1650.     if you are colour blind or are going to use DiskTree on a LCD display, 
  1651.     you can change all of the colour sets you see displayed by DiskTree 
  1652.     during operation. 
  1653.  
  1654.     Operation of this program is very much the same as DiskTree with use of 
  1655.     either the mouse or the keyboard to select functions.  In addition to 
  1656.     the dialog box based user interface, config  also uses drop-down menus 
  1657.     to select functions.  The menu options are displayed along the top of 
  1658.     the screen in the form of option headings: 
  1659.  
  1660.     File Colours
  1661.  
  1662.     Holding down the ALT key and the first letter of the required heading 
  1663.     will bring options in the form of a menu below the selected heading.  
  1664.     Use the up and down cursor keys to select the required function and 
  1665.     press ENTER. If you are using the mouse, move the mouse cursor over the 
  1666.     required heading and press either mouse button.  After the menu has 
  1667.     appeared, moved the menu highlight to the required option and press a 
  1668.     button. 
  1669.  
  1670.     The file menu.
  1671.  
  1672.     The file menu contains functions to load, save and reset DiskTree's 
  1673.     configuration file plus options to quit the config program. 
  1674.  
  1675.     Load - loads DISKTREE.CFG if present.
  1676.  
  1677.     Save - saves a file called DISKTREE.CFG containing colour information 
  1678.     and default DiskTree options. Any existing file of the same name will 
  1679.     be overwritten. 
  1680.  
  1681.     Reset - resets the colour scheme to the tasteful default colours. 
  1682.  
  1683.     Save and quit - saves as above and then exits the config program. 
  1684.  
  1685.     Quit - quits, not saving the colour configuration.
  1686.  
  1687.     The Colours menu.
  1688.  
  1689.     This menu contains the main colour sets that DiskTree displays during 
  1690.     operation: 
  1691.  
  1692.     Tree window colours 
  1693.  
  1694.     Colours used to display the directory tree and the files list next to 
  1695.     it. 
  1696.     
  1697.     Tree functions / general dialog box colours 
  1698.  
  1699.     Colours used to display most of the dialog boxes you see displayed when 
  1700.     performing commands.  The copy, attrib, execute etc.. dialogs use this 
  1701.     colour scheme.  The directory tree functions menu (displayed below the 
  1702.     tree window) also uses this colour scheme. 
  1703.     
  1704.     File window colours 
  1705.  
  1706.     Colours for the file functions menu. 
  1707.     
  1708.     Alert box colours 
  1709.  
  1710.     Colours for the alert boxes that appear querying options etc. 
  1711.     
  1712.     Viewer colours 
  1713.  
  1714.     Colours for the file viewer. 
  1715.                     ----------------------------------
  1716.  
  1717.     CHANGING COLOURS
  1718.  
  1719.     When any of the above options are chosen, a dialog will appear showing 
  1720.     a sample of text that would be displayed by DiskTree together with the 
  1721.     colours that can be changed. Some are background colours and some are 
  1722.     foreground colours. The following colours can be changed: 
  1723.  
  1724.     1. Window background colour (background colour) 2. Window border colour 
  1725.     (foreground colour) 3. Normal text colour (foreground colour) 4. 
  1726.     Highlighted text colour (foreground colour) 5. Box background colour 
  1727.     (background colour) 6. Box text colour (foreground colour) 
  1728.     
  1729.     When you select any of these colours to change a list displaying 
  1730.     available colours will be displayed.  Use the mouse or cursor keys to 
  1731.     select the one you wish to use. 
  1732.  
  1733.     For foreground colours, 16 colours are available, ranging from black to 
  1734.     white. 
  1735.  
  1736.     Background colours depend upon whether you have a VGA card or not. If 
  1737.     you do not, only 8 colours will be available. If you have VGA, 16 
  1738.     background colours will be available so you can create nice lurid 
  1739.     backgrounds. 
  1740.  
  1741.     NOTE: If you take a configuration file that has colours set for VGA 
  1742.     only to a CGA system, any colours above light-grey will cause blinking. 
  1743.  
  1744.  
  1745.         
  1746.  
  1747.