home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / utility / disk / sttls193 / st_tools.doc < prev    next >
Text File  |  1994-02-06  |  32KB  |  780 lines
  1.  
  2.  
  3.                              ST Tools Version 1.93
  4.  
  5.  
  6.                                Table of Contents
  7.  
  8.     Introduction
  9.          Copyright
  10.          Program Overview
  11.          Requirements
  12.          Limitations
  13.          Technical Notes
  14.     Using ST Tools
  15.          Icons
  16.          Windows
  17.          Drop-Down Menus
  18.               Desk Menu
  19.                    About ST Tools
  20.                    Desk Accessories
  21.               File Menu
  22.                    Save Configuration
  23.                    Open Log File
  24.                    Suspend/Continue Log File
  25.                    Close Log File
  26.                    Touch File(s)
  27.                    UnDelete File(s)
  28.                    Quit
  29.               View Menu
  30.                    Names Compressed
  31.                    Names with Periods
  32.                    Names with Spaces
  33.                    Names Unchanged
  34.                    View as Large Text
  35.                    View as Small Text
  36.               Sort Menu
  37.                    Sort Items by Name
  38.                    Sort Items by Date_Time
  39.                    Sort Items by Size
  40.                    Sort Items by Extension
  41.                    No Sort
  42.               Function Menu
  43.                    List Disk Information
  44.                    List/Edit FAT Entries
  45.                    HexDump File
  46.                    HexDump Sector
  47.                    HexDump Memory
  48.                    Search File
  49.                    Search Sector
  50.                    Search Memory
  51.                    Check File Structure
  52.                         Repair File Structure
  53.                         Optimize File Structure
  54.                         Repair and Optimization Warnings
  55.               Options Menu
  56.                    Single Tree
  57.                    Double Tree
  58.                    View Window On/Off
  59.          Start/GoTo Location Dialog Box
  60.          Search String Dialog Box
  61.          Edit Dialog Box
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                  Introduction
  70.  
  71.  
  72.                                    Copyright
  73.  
  74.     ST Tools is copyright 1991, 1992, 1993, 1994 Stephen Cornio.  All Rights
  75. Reserved.  This program is being distributed as shareware with a $10 suggested
  76. contribution.  This program may be posted on any public BBS as long as it is
  77. not modified and the documentation is included.  Any comments and/or
  78. suggestions would be appreciated.  I can be reached on CompuServe (73637,2527),
  79. or send me mail.
  80.  
  81.     Stephen Cornio
  82.     P.O. Box 1734
  83.     Woodbridge, VA  22193
  84.  
  85.  
  86.                                Program Overview
  87.  
  88.     ST Tools is reminiscent of PC Tools for MS-DOS computers.  The main display
  89. includes a directory tree and a listing of files by directory.  As the name
  90. implies, the program is a set of tools for use on the Atari ST.  Current
  91. functions include listing/editing of File Allocation Tables, Hex dumping of
  92. files, sectors or memory,  searching files, sectors or memory, check, repair
  93. and optimize file structure.  The program is entirely GEM based, with the
  94. standard drop-down menus, scrollable windows and dialog boxes.
  95.  
  96.  
  97.                                  Requirements
  98.  
  99.     ST Tools requires a minimum of 450K of free memory to execute.  The program
  100. will perform disk optimization more efficiently if there is more memory
  101. available.  The program will run in both High and Medium resolutions and has
  102. been tested with versions 1.2 and 1.4 of TOS.
  103.  
  104.  
  105.                                   Limitations
  106.  
  107.     ST Tools has the following known limitations.  Disks are limited to a
  108. maximum of 512 directories and sub-directories in the tree window.  Each
  109. directory is limited to 512 files in the file window.  There is a maximum of 9
  110. levels of directories, including the drive.  There is no limit on the size of
  111. the disk.  The program has support for BGM partitions with sectors up to 8K in
  112. size.
  113.  
  114.  
  115.                                 Technical Notes
  116.  
  117.     ST Tools is written almost entirely in FORTRAN using Prospero FORTRAN for
  118. GEM, along with the Prospero Developers Toolkit, specifically its Make facility
  119. and macro assembler.  Assembly language is used to process the File Allocation
  120. Tables, perform logical bit functions and other operations not easily performed
  121. by FORTRAN.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                 Using ST Tools
  136.  
  137.  
  138.                                      Icons
  139.  
  140.     Disk icons representing each floppy disk and hard-disk partition as well as
  141. any RAM-disk are displayed across the bottom of the screen.  The current disk
  142. will be indicated by a highlighted icon.  To make a different disk be the
  143. current disk, simply click on the desired icon.  To re-read the directory tree
  144. for a disk, hold the Shift key while clicking on the disk icon.  This is
  145. particularly useful on a system with a single floppy drive to change floppies.
  146.  
  147.  
  148.                                     Windows
  149.  
  150.     The main display consists of two windows.  The left window is a directory
  151. tree of the current floppy or hard-disk partition with the current directory
  152. indicated by a highlighted line.  The right window is a list of files,
  153. including directories, found in the current directory with the current file
  154. indicated by a highlighted line.  When the program starts, the left window is
  155. active.  To make the file window active, simply click in the right window or
  156. press the right arrow key.  To return to the directory window, either click in
  157. the right window or press the left arrow key.  To change the current directory
  158. when in the left or directory window, you can click on the desired directory or
  159. use the slider or use the up and down arrow keys.  The same methods will work
  160. to change the current file when the right or file window is active.  Note that
  161. clicking on a file will cause that file to be selected.  This will be indicated
  162. by an asterisk (*) in front of the file name.  To deselect a file, simply click
  163. on the file a second time.  Selected files are important whenever a file
  164. function is performed.  If no files are selected, then the function starts at
  165. the current file and all files in the directory are accessible.  If any files
  166. are selected, then only those files are accessible by the function, in the
  167. order that they were selected.
  168.  
  169.     Normally the file window will show the filename, size, date, time of last
  170. modification and file attributes.  By clicking on the full window button, the
  171. file window will be expanded to cover the directory window and the first
  172. cluster and sector of the file will also be displayed.  Click again on the full
  173. window button to return to normal size file window.
  174.  
  175.  
  176.                                 Drop_Down Menus
  177.  
  178.     Across the top of the screen is found a standard menu bar.  All of the
  179. program's features and functions are accessed by using the drop-down menus
  180. contained on this menu bar.
  181.  
  182.  
  183.                                    Desk Menu
  184.  
  185.     About ST Tools
  186.  
  187.     Clicking on the "About ST Tools" entry in the Desk menu will display
  188. copyright information about the program, along with my name and address.
  189.  
  190.     Desk Accessories
  191.  
  192.     Desk accessories will work within ST Tools, including MultiDesk.  The desk
  193. accessories are selected in the normal manner, by clicking on them.
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                    File Menu
  202.  
  203.     Save Configuration
  204.  
  205.     The "Save Configuration" entry will cause the standard file selector to be
  206. displayed with the standard name 'ST_TOOLS.CFG' listed as the selection.  Click
  207. on the "OK" button to save the current configuration to this file.  This file
  208. is used on program startup to alter the standard initial Name, View, Sort and
  209. Option defaults.
  210.  
  211.  
  212.     Open Log File
  213.  
  214.     The "Open Log File" entry will cause the standard file selector to be
  215. displayed with the standard name 'ST_TOOLS.LOG' listed as the selection.  Click
  216. on the "OK" button to open this file for logging output.  Note that this file
  217. will be overwritten and not appended to.  When the log file is open and not
  218. suspended, the data displayed by the functions will be output to the log file.
  219. Each standard display will occupy 22 lines, so that 3 displays will fill a
  220. printed page of 66 lines.  It is NOT recommended to have a logfile open on a
  221. disk if you plan on performing any directory or FAT modifications, since GEMDOS
  222. doesn't update the directory and FAT until after the logfile is closed and ST
  223. Tools can not see what GEMDOS has in its buffers.
  224.  
  225.     Suspend/Continue Log File
  226.  
  227.     The "Suspend/Continue Log File" entry is used to temporarily suspend and
  228. then continue writing to the log file.  When a log file is opened, the entry
  229. will read "Suspend Log File".  If this option  is selected, the entry will be
  230. changed to read "Continue Log File".
  231.  
  232.     Close Log File
  233.  
  234.     The "Close Log File" entry will cause the log file to be closed.
  235.  
  236.     Touch File(s)
  237.  
  238.     This entry will allow the user to "Touch" files in the current directory.
  239. This will cause the Archive bit to be set and the Date/Time to be updated.
  240.  
  241.     UnDelete File(s)
  242.  
  243.     This entry will allow the user to "UnDelete" files from the current
  244. directory.  The 'UnDelete' button will only be enabled for those files where
  245. enough contiguous free blocks are found where the file was before being
  246. deleted.  There is no guarantee that these blocks have the same contents as
  247. before the file was deleted.
  248.  
  249.     Quit
  250.  
  251.     Clicking on the "Quit" entry will cause the program to terminate
  252. immediately.
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                                    View Menu
  268.  
  269.     The "View Menu" is broken into two sections.  The top section is used to
  270. select the "Name" option, which determines how the names found in each
  271. directory are listed.  The bottom section is used to select the "View" option,
  272. which determines the number of directories or files that can be listed in each
  273. window.  This section is only of use in high resolution.
  274.  
  275.     Names Compressed
  276.  
  277.     The "Names Compressed" entry will cause the file names to be listed with a
  278. period between the main part of the name and its extension with any embedded
  279. blanks deleted as in 'NAME.EXT'.
  280.  
  281.     Names with Periods
  282.  
  283.     This entry is similar to the one above except that the embedded blanks will
  284. be included as in 'NAME    .EXT'.
  285.  
  286.     Names with Spaces
  287.  
  288.     This entry will cause the file names to be listed with a space between the
  289. main part of the name and the extension with embedded blanks included as in
  290. 'FILENAME EXT'.
  291.  
  292.     Names Unchanged
  293.  
  294.     This entry will cause the file names to be listed exactly as they are in
  295. the directory itself as in 'FILENAMEEXT'.
  296.  
  297.     View as Large Text
  298.  
  299.     The "View as Large Text" entry will cause the font appropriate for the
  300. current screen resolution to be used, resulting in 19 directories and files to
  301. be listed in each window.
  302.  
  303.     View as Small Text
  304.  
  305.     This entry which is only available in high resolution (monochrome) mode,
  306. will cause the medium resolution character font to be used, resulting in double
  307. the number of directories and files to be listed in each window.
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.                                    Sort Menu
  334.  
  335.     Sort Items by Name
  336.  
  337.     The "Sort Items by Name" entry will cause files listed to be sorted by
  338. name, with directories first.
  339.  
  340.     Sort Items by Date-Time
  341.  
  342.     This entry will cause the files listed to be sorted by Date and Time of
  343. last modification, with directories first.
  344.  
  345.     Sort Items by Size
  346.  
  347.     This entry will cause the files listed to be sorted by size of the file,
  348. with directories first.
  349.  
  350.     Sort Items by Extension
  351.  
  352.     This entry will cause the files listed to be sorted by their extensions,
  353. with directories first.
  354.  
  355.     No Sort
  356.  
  357.     This last entry will cause the files listed to not be sorted at all, but
  358. instead shown in the order as defined in the directory.
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.                                  Function Menu
  400.  
  401.     List Disk Information
  402.  
  403.     The "List Disk Information" entry will cause various pieces of information
  404. about the current disk to be listed.  This information includes FAT size, the
  405. total number of sectors on the disk, the number of usable clusters on the disk,
  406. and any volume label, including a NeoDesk label if it exists.
  407.  
  408.     List/Edit FAT Entries
  409.  
  410.     This entry will allow the listing and editing of FAT entries for the
  411. current disk.  A starting FAT entry dialog box will first be presented in order
  412. to allow the user to select the FAT to start listing at.  After the "List"
  413. button is clicked, the selected FAT will be displayed in hexadecimal.  For
  414. floppies, the pointer is usually 12 bits which translates to 3 hexadecimal
  415. digits.  For hard disks, the pointer is normally 16 bits or 4 hexadecimal
  416. digits.  To indicate end-of-file, negative one is used, 'FFF' for floppies or
  417. 'FFFF' for hard disks.  Seven buttons are displayed in this dialog box.
  418. "First" will display the first set of entries.  "Prev" will display the
  419. previous set of entries.  "Edit" will allow the user to edit the FATs displayed
  420. on the screen.  "Exit" will cause this dialog box to exit.  "GoTo" will present
  421. a go to FAT dialog box to allow the user to select a FAT to go to.  "Next" will
  422. display the next set of entries.  "Last" will display the last set of entries.
  423.  
  424.     HexDump File
  425.  
  426.     The "HexDump File" entry will cause the selected files, or current file if
  427. no files are selected, to be dumped to the screen in a dialog box.  The dump is
  428. both in hexadecimal and in Ascii.  The file name, sector number and cluster
  429. number within the file, and absolute disk sector will be displayed at the top
  430. of the dialog box.  Eight buttons are displayed at the bottom of the box.
  431. "Prev File" will cause the previous file to be dumped.  "First" will dump the
  432. first sector of the current dump file.  "Prev" will dump the previous sector of
  433. the current dump file.  "Edit" will allow the user to edit or modify the data
  434. displayed on the screen.  "Exit" will cause this dialog box to exit.  "Next"
  435. will dump the next sector of the current dump file.  "Last" will dump the last
  436. sector of the current dump file.  "Next File" will cause the next file to be
  437. dumped.
  438.  
  439.     HexDump Sector
  440.  
  441.     This entry will allow any sector of the current disk to be dumped to the
  442. screen in a dialog box.  A starting sector dialog box will first be presented
  443. in order to allow the user to select the sector to start dumping at.  Once the
  444. starting sector is selected and the "Dump" button is clicked, the sector will
  445. be dumped in both hexadecimal and Ascii.  The sector number and type of sector,
  446. Boot, FAT, Root or Data will be displayed at the top of the box.  Seven buttons
  447. are displayed at the bottom of the box.  "First" will dump the first sector of
  448. the disk or Boot sector.  "Prev" will dump the previous sector of the disk.
  449. "Edit" will allow the user to edit the current data on the screen.  "Exit" will
  450. cause this dialog box to exit.  "GoTo" will present a go to sector dialog box
  451. to allow the user to select a sector to go to.  "Next" will dump the next
  452. sector of the disk.  "Last" will dump the last sector of the disk.
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.     HexDump Memory
  466.  
  467.     This entry will allow any block of memory to be dumped to the screen in a
  468. dialog box.  This can be RAM, ROM or hardware chips such as DMA, video or sound
  469. chips.  A starting memory dialog box will first be presented which will allow
  470. the user to select the memory to start at.  Once this is done and the "Dump"
  471. button is clicked, the standard dump screen will be displayed.  The actual
  472. address of memory dumped is listed to the left.  Six buttons are displayed at
  473. the bottom of the box.  "First" will dump the first block of memory.  "Prev"
  474. will dump the previous block of memory.  "Edit" will allow the user to edit the
  475. data on the screen.  "Exit" will cause this dialog box to exit.  "GoTo" will
  476. present a go to memory dialog box to allow the user to select the memory to go
  477. to.  "Next" will dump the next block of memory.  "Last" will dump the last
  478. block of memory.  Note that if the memory displayed is not RAM, then the "Edit"
  479. button will be disabled.
  480.  
  481.     Search File
  482.  
  483.     The "Search File" entry will cause the selected files, or current file if
  484. no files are selected, to be searched for a 16 character long string.  The
  485. string may be input in either hexadecimal or Ascii.  The search may be case
  486. sensitive of insensitive.  The search may be in a forward or backward
  487. direction.  While the files are being searched, their names will be displayed
  488. at the top of the search dialog box.  The search may be stopped at any time by
  489. clicking on the "Stop" button or pressing the Return key.  Once the string has
  490. been found, the dump file screen will be displayed with the search string
  491. indicated by reverse video on monochrome and green text on color systems.  Six
  492. buttons are displayed at the bottom of the box.  "Search Prev" will search for
  493. a previous instance of the string.  "Prev Block" will dump the previous block
  494. of the file displayed.  "Edit" and "Exit" work as usual.  "Next Block" will
  495. dump the next block of the file displayed.  "Search Next" will search for the
  496. next instance of the string.
  497.  
  498.     Search Sector
  499.  
  500.     This entry will allow the searching of disk sectors.  The starting sector
  501. dialog box is displayed followed by the search dialog box.  Once the search is
  502. started, the sectors being searched will be displayed at the top of the search
  503. dialog box.  When the string is found, the dump sector screen will be displayed
  504. with the same six buttons found on the "Search File" dialog box, plus a "GoTo"
  505. button to allow the user to go to a particular sector.
  506.  
  507.     Search Memory
  508.  
  509.     This entry will allow the searching of memory.  The starting sector and the
  510. search dialog boxes will be displayed to determine the starting memory and the
  511. string to search for.  When the string is found, the dump memory screen will be
  512. displayed with the same seven buttons as above.
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.     Check File Structure
  532.  
  533.     This entry will allow the user to check the file structure of the current
  534. disk.  Each file on the disk is checked for various problems.  The file
  535. currently being checked will be displayed.  Whenever an error occurs, a message
  536. describing the error will be displayed and the user can either continue
  537. checking or cancel.  Even when no errors occur, the user can stop at any time
  538. by clicking on the "Stop" button or pressing the Return key.  A single press of
  539. the Return key works better since the keyboard controller will buffer the
  540. keystroke, whereas the mouse click must occur during the short period of time
  541. that is waited between each file.
  542.     The file '.' in each directory is checked to verify that it points to the
  543. current directory.  The file '..' in each directory is checked to verify that
  544. it points to the directory's parent directory.  The clusters of each file are
  545. traced to check for unused and illegal clusters in the path.  Collisions
  546. between a file and itself or between one file and another file are tested for.
  547. The size of the file is compared with the number of clusters assigned.  After
  548. all of the files have been checked, the File Allocation Table is scanned to
  549. check for orphan files, that is files beginning at clusters marked as used but
  550. not pointed to by a directory entry.  If any orphan files are found, each of
  551. them is traced in the same way as normal files.  Once the checking process has
  552. completed, a display will be presented showing the results.  One of two
  553. functions will be enabled depending on the results of the file check.  If any
  554. errors exist, the user may Repair the file structure.  If no errors exist, the
  555. user may Optimize the file structure.  In either case, the user may Exit after
  556. viewing the results.  The following statistics will be displayed.
  557.     Total FAT Clusters - The total number of usable clusters on the disk.
  558.     Total File Clusters - The total number of clusters assigned to files,
  559.                            both normal and Orphan.
  560.     Total Free Clusters - The total number of unused clusters on the disk.
  561.     Free Cluster Fragments - The number of parts of contiguous free clusters.
  562.                              Ideally this should equal 1.  The higher the
  563.                              number, the more fragmented free space is.
  564.     Total Files - The total number of files (including directories)
  565.                   referenced by entries in directories.
  566.     Zero Length Files - The number of these files of size 0 with no clusters
  567.                         assigned.
  568.     Contiguous Files - The number of these files where all file cluster are
  569.                        contiguous on disk.
  570.     Fragmented Files - The number of these files where at least one file
  571.                        cluster is not contiguous with the previous cluster.
  572.     Total Good Files - The number of these files that have no problems.
  573.                        (I.E. zero length, contiguous and fragmented files)
  574.     Directory File Starts - The number of files pointed to by a directory
  575.                             entry (must have at least one cluster).
  576.     FAT File Starts - The number of clusters marked as in use, but not
  577.                       pointed to by another cluster.
  578.     FAT File Endings - The number of clusters marked as EOF.
  579.     Orphan File Starts - This is the number of FAT file starts that have no
  580.                          corresponding Directory file start.
  581.     Invalid File Endings - This is the number of files, both normal and
  582.                            orphan, that end in an unused cluster or an illegal
  583.                            cluster or have the wrong number of file clusters
  584.                            assigned based on file size.
  585.     File Collisions - The number of files that collide with themselves or
  586.                       with another file.
  587.     Invalid Current Dirs - The number of current directory files, '.', that
  588.                            don't point to the correct cuurent directory.
  589.     Invalid Parent Dirs - The number of parent directory files, '..', that
  590.                           don't point to the correct parent directory.
  591.     Total Errors - This is the sum of the five previous numbers, which are
  592.                    all considered to be errors.
  593.  
  594.  
  595.  
  596.  
  597.     Repair File Structure
  598.  
  599.     This function is only reachable from within the Check File Structure
  600. function.  If the number of errors from the Check File Structure is not 0, then
  601. the "Repair" button will be enabled on the File Statistics display.  If the
  602. user clicks on this button a warning will be displayed allowing the user to
  603. change their mind.  If the "Continue" button is selected, the repairs will be
  604. performed automatically.  The file path of each file being repaired along with
  605. the type of error will be displayed.  The user may stop at any time by clicking
  606. on the "Stop" button or pressing the Return key.  As in the Check function
  607. above, the Return key is more reliable than clicking.  The program will stop
  608. after the current repair is finished.  Once stopped, the user may cancel the
  609. function or continue the repairs.  During repairs, file starting clusters, file
  610. sizes and date-time stamps may be changed.  If there are any Orphan files, an
  611. Orphan directory will be created in the Root directory to hold them.  If two
  612. files are in collision, the clusters shared by the two files will be duplicated
  613. so that both files contain the contested data.  After all repairs have
  614. finished, the disk directory tree is read again to ensure that any files
  615. created or deleted are properly indicated.  Once any disk is repaired, the
  616. program will re-boot the computer when "Quit" is selected from the File menu.
  617.  
  618.     Optimize File Structure
  619.  
  620.     This function is only reachable from within the Check File Structure
  621. function.  If the number of errors from the Check File Structure is 0, then the
  622. "Optimize" button will be enabled on the File Statistics display.  When the
  623. "Optimize" button is selected, an Optimization Options display will be
  624. presented to allow for a choice of option.  The first option is to delete zero
  625. length files.  The second option is to move directories to the front of the
  626. disk.  If this option is selected, then all directories will be moved in the
  627. order they are listed in the directory tree window.  The third option is to
  628. compress directories.  This option will cause any deleted file entries to be
  629. erased from the directory and, if possible, delete any un-needed clusters from
  630. sub-directories.  This display has a "Continue" and a "Cancel" button.  If the
  631. user clicks on the "Continue" button, a final warning will be displayed
  632. allowing the user to change their mind.  If the "Continue" button is selected,
  633. the optimization will be performed automatically.  First, all zero length files
  634. will be deleted if that option was requested.  Secondly, any fragmented files
  635. are moved to contiguous free blocks at the end of the disk.  The file path of
  636. each file deleted or defragmented will be displayed.  The user will be notified
  637. of any files which are not able to be defragmented due to not enough contiguous
  638. free clusters at the end of the disk.  These files will most likely be
  639. defragmented as part of the free cluster bubble up process.  Next, if the
  640. compress directories option was selected, all directories will be compressed.
  641. If the move directories option was selected, this will be done next. Lastly the
  642. free clusters are bubbled to the end of the disk by moving files towards the
  643. front of the disk.  The user may stop at any time by clicking on the "Stop"
  644. button or pressing the Return key.  As in the Check function above, the Return
  645. key is more reliable than clicking.  The program will stop after the current
  646. file action is finished.  Once stopped, the user may cancel the function or
  647. continue the optimization.  Every time a file is moved, the file starting
  648. cluster will be changed.  After the optimization process is completed, the
  649. directory tree is processed again to ensure that any files deleted are properly
  650. indicated.  Once any disk is optimized, the program will re-boot the computer
  651. when "Quit" is selected from the File menu.
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.     Repair and Optimization Warnings
  664.  
  665.     Please note that the disk repair and optimization functions perform a great
  666. deal of modification to the directory and FAT sectors of the disk.  Disk
  667. backups should be performed before either of these functions is selected.  The
  668. author of ST Tools is not responsible for any damage caused by the use or
  669. misuse of this program.  If any disk I/O errors occur during these functions,
  670. the function will be stopped immediately to minimize any damage caused.  A log
  671. file can not be opened on a disk being repaired or optimized or on any disk
  672. already repaired or optimized during this session.  This is to ensure that the
  673. operating system doesn't conflict with the repair or optimization process.  A
  674. log file may be open on a disk not being repaired or optimized.  If a log file
  675. is open, any errors found during the check process will be written to it along
  676. with the error message.  Also all files repaired, deleted or defragmented will
  677. be listed on the log file.
  678.  
  679.  
  680.                                  Options Menu
  681.  
  682.     Single Tree
  683.  
  684.     This entry, which is only enabled when in double tree mode, will switch the
  685. display to the normal single pair of windows.  If the two sets of windows are
  686. displaying different disks when this option is selected, then the disk on the
  687. active pair of windows when this entry is selected will become the disk
  688. displayed in single tree mode.
  689.  
  690.     Double Tree
  691.  
  692.     This entry, which is only enabled when in single tree mode and the view
  693. window is not active, will cause a copy of the two windows to be opened below
  694. the original pair of windows.  The directory tree window of this set of windows
  695. will become the active window.  Once opened, this second set of windows is
  696. totally independent of the first set of windows.  Different directories on the
  697. same disk or different disks may be displayed in each set of windows.
  698.  
  699.     View Window On/Off
  700.  
  701.     This entry, which is only enabled when in single tree mode, will toggle the
  702. opening and closing of a view window below the directory and file windows. The
  703. current file will be displayed in this window in both hexadecimal and Ascii
  704. similar to the hexdump displays.  A vertical scroll bar is present which will
  705. allow scrolling through the file.
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.                         Start/GoTo Location Dialog Box
  730.  
  731.     The Start location dialog box is used any time the List/Edit FAT Entries
  732. function or a dump or search of disk sectors or memory is requested from the
  733. "Function" drop-down menu.  The title of the box will reflect the function
  734. requested.  For FAT functions, the maximimum FAT of the current disk is
  735. displayed.  For disk sector functions, the maximum disk sector on the current
  736. disk is displayed.  For memory functions, the maximum memory (FFFFFF or 16
  737. megabytes) is displayed.  By clicking on the '+' and '-' buttons, each digit of
  738. the starting FAT/sector/memory can be increased or decreased.  A "Cancel"
  739. button is provided to cancel the requested function.  The other button will be
  740. "List", "Dump" or "Search" to reflect the type of function to be performed.
  741. Clicking on this button will cause the program to proceed to the next step.
  742. For FAT functions the desired FAT will be listed.  For "Dump" functions the
  743. desired sector or memory will be dumped.  For "Search" functions, the Search
  744. String dialog box will be displayed and processed.  From within FAT lists, and
  745. sector and memory dumps, a "GoTo" button will be available for selection.
  746. Selecting this button will cause the GoTo location dialog box to appear.  This
  747. dialog box functions the same as the Start location dialog box.
  748.  
  749.  
  750.                            Search String Dialog Box
  751.  
  752.     This dialog box is used any time a search of files, disk sectors or memory
  753. is requested from the "Function" drop-down menu.  The title of the box will
  754. reflect the type of string being searched for, hexadecimal or Ascii.  The type
  755. of string may be toggled by clicking on the desired search type.  The case of
  756. the search may also be selected, sensitive or insensitive.  The case only
  757. applies to the letters A-Z whether the search type is hexadecimal or Ascii.  A
  758. "Cancel" button is provided to cancel the search function.  When doing a
  759. hexadecimal search, the input digits must be between 0-9 and A-F.  An error in
  760. the search string will be indicated by grey text on monochrome systems and red
  761. text on color systems.  Once the desired string has been entered, the search
  762. direction is selected by clicking on the "Search Forward" or "Search Backward"
  763. button as desired.  While the search is proceeding, the "Cancel" button will be
  764. relabelled as a "Stop" button.  Clicking on this button will cause the search
  765. to stop and two additional buttons to appear.  They are used to indicate the
  766. point at which to continue the search from.  "Start Point" will cause the
  767. search to be restarted from the original starting point.  "Current Point" will
  768. cause the search to be restarted from where it was stopped.
  769.  
  770.  
  771.                                 Edit Dialog Box
  772.  
  773.     This dialog box is used any time the "Edit" button is clicked from a
  774. display.  Two buttons are displayed at the bottom of the dialog box.  "Do It"
  775. will cause any changes made to the current screen to be written to disk or
  776. memory.  Each hexadecimal digit will be checked for validity first and any
  777. errors will be flagged with grey text on monchrome systems and red text on
  778. color systems.  A "Cancel" button is provided to allow the user to cancel the
  779. edit function with no changes being made to disk or memory.
  780.