home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / d / disccomp / !DiscComp / !Help < prev    next >
Encoding:
Text File  |  1995-06-18  |  12.3 KB  |  236 lines

  1.  
  2.  ABOUT THIS PROGRAM
  3.  ---------------------------------------------------------------------------
  4.  Name    : DiscCompact
  5.  Version : 1.07 (03 Jun 1995)
  6.  Purpose : Easy compaction of ADFS discs
  7.  Author  : Andrew Berry
  8.  Licence : Freeware. Please see conditions at the end of this file.
  9.  
  10.  
  11.  PURPOSE
  12.  ---------------------------------------------------------------------------  DiscComp is a small utility designed to make compacting discs easier. At
  13.  the moment the only way to compact a disc is to use the command line.
  14.  DiscComp makes disc compacting easier by providing a user interface for
  15.  the *Compact command.
  16.  
  17.  
  18.  SELECTING A DISC
  19.  ---------------------------------------------------------------------------  Discs are compacted from the main window. To open the main window click on
  20.  the DiscComp icon on the icon bar. The window is divided into two halves.
  21.  The left-hand side of the window is used for selecting the disc to
  22.  compact. To select a drive click on its corresponding radio icon. If your
  23.  drive has a number other than those in the window you can enter it into the
  24.  'Other number:" icon. For instance, to compact a disc in drive 6 you would
  25.  enter '6' into the writable icon to the right of 'Other number:'. The
  26.  final option can be used to name specific discs to compact. For instance,
  27.  entering 'MyDisc' would cause the disc 'MyDisc' to be compacted. You are
  28.  prompted to insert the disc if it is not present. This option can also be
  29.  used to select your hard disc by name. For instance, 'IDEDisc4' can be
  30.  entered here instead of selecting drive 4.
  31.  
  32.  COMPACTING THE SELECTED DISC
  33.  ---------------------------------------------------------------------------  Compacting a disc can be done in a number of different ways, depending on
  34.  the disc selected on the left-hand side of the window.
  35.  
  36.     1) Clicking on 'Compact' in the bottom right of the window will compact
  37.        the disc selected on the left.
  38.          
  39.     2) If the caret is in the 'Other number' or 'Disc name' writable icons
  40.        then pressing return will do one of two things:
  41.            a) If the icon is selected then pressing return will compact
  42.               the disc, the same as clicking Compact.
  43.            b) If the icon is not selected then pressing return will select
  44.               it.
  45.        Therefore, if drive 4 is selected (for example) then to compact a
  46.        disc called 'MyDisc' enter 'MyDisc' into the 'Disc name' writable
  47.        icon and press return twice.
  48.          
  49.     3) Pressing return in the 'Repeat' writable icon will compact the
  50.        disc, the same as clicking 'compact'.
  51.        
  52.  DiscCompact is semi-intelligent, in that it times each compaction, so that
  53.  if you select a large repeat number it will stop trying to compact the disc
  54.  when no more compaction is possible.
  55.  
  56.  
  57.  THE PERCENTAGE HOURGLASS
  58.  ---------------------------------------------------------------------------
  59.  During compaction a percentage hourglass will appear to give an indication
  60.  of progress. The percentage given is NOT the time taken, as there is no way
  61.  of predicting how long a compaction will take, but shows the number of times
  62.  the disc has been compacted out of the specified repeat number. Therefore
  63.  the first few percent will take longer than the rest, and the percentage may
  64.  never get above 10% due to the intelligent compaction.
  65.  
  66.  
  67.  OPTIONS
  68.  ---------------------------------------------------------------------------  The right-hand side of the window contains various options. Click on an
  69.  option button to alter its state.
  70.  
  71.     1) Confirm: This asks you to confirm every compaction, so that you can't
  72.        compact a disc by mistake. This is not included as a safety measure
  73.        because no harm can be done by compacting most discs, but because it
  74.        is annoying having to wait for a disc to compact that you didn't want
  75.        compacting!
  76.  
  77.     2) Repeat: Sometimes a disc doesn't compact fully on the first attempt,         so I have included a repeat option. When it is switched on it will
  78.        compact the disc the number of times shown in the white box next to
  79.        'Repeat'. To alter the number, click on the box and enter the new
  80.        number.
  81.          
  82.     3) Show free: This option is used to display disc information when
  83.        compaction is complete. When selected, it brings up a new window.
  84.        This is described later.
  85.  
  86.  To close the main window, click on the close icon. All options are
  87.  remembered when the window is closed, and can be saved by clicking on
  88.  'Save options'. Once saved, the options will be set automatically whenever
  89.  you run DiscComp. All settings in the main window are saved, including the
  90.  information in the writable icons.
  91.   
  92.  
  93.  OTHER BUTTONS 
  94.  ---------------------------------------------------------------------------  On the right of the main window, underneath the options, are three buttons.
  95.  They are:
  96.      
  97.       1) Show free...  : Analyses the currently selected disc and displays
  98.                          the Disc Information window which is described
  99.                          above. This function is included so that the exact
  100.                          space on a disc can be worked out.
  101.                          
  102.       2) Save options  : Saves the current options to disc, as described
  103.                          above.
  104.                                      
  105.       3) Compact       : Compacts the currently selected disc as described
  106.                          above.
  107.       
  108.       
  109.  DISC INFORMATION
  110.  ---------------------------------------------------------------------------  If 'Show free space on disc' is selected then a disc information window
  111.  will open once compaction is complete. This shows the disc name, the size
  112.  of the disc, the amount of free and used space and how full the disc is (as
  113.  a percentage).
  114.  
  115.       
  116.  HISTORY   
  117.  ---------------------------------------------------------------------------  1.00 (10 Aug 1994) : • First version - fully working.
  118.  ---------------------------------------------------------------------------
  119.  1.01 (02 Sep 1994) : • Bug fix - Compact button now deselects after an
  120.                         error. Was staying selected if named disc wasn't
  121.                         inserted.
  122.  ---------------------------------------------------------------------------
  123.  1.02 (04 Sep 1994) : • Bug fix - Now works with RISC OS 2.                                        • Changed '*Filer_Run' to '*Type' for RO2
  124.                         compatibility.
  125.                       • Now gives error if disc name is less than two
  126.                         characters.
  127.  ---------------------------------------------------------------------------  1.03 (28 Sep 1994) : • Top box of 'Disc information' window now shows the
  128.                         disc name whether the disc was selected by name or
  129.                         drive number. This only works on RISC OS 3 or
  130.                         greater because of the SWI used.
  131.  ---------------------------------------------------------------------------
  132.  1.04 (20 Dec 1994) : • All options can now be saved to disc
  133.                       • Intelligent repeat.
  134.                       • Better error handling. Recognises certain common
  135.                         errors (drive empty, etc.) and provides only an OK
  136.                         box and no 'Click OK to continue...'.
  137.                       • Changed title of main window
  138.                       • Removed 'Cancel' and 'Help...' icons from main
  139.                         window.
  140.  ---------------------------------------------------------------------------
  141.  1.05 (27 Jan 1995) : • Altered disc info window
  142.                       • Removed hourglass option. Now permanently on due to
  143.                         intelligent repeat.
  144.                       • Bug fix - Now does *IconSprites from !Run file
  145.                         (whoops!). Sorry if earlier versions caused problems
  146.                         when using Menon, QuickDirs, etc.
  147.                       • Changed licence to Freeware.
  148.  ---------------------------------------------------------------------------
  149.  1.06 (23 Feb 1995) : • Big fix - free space information was unavailable for
  150.                         anything other than ADFS discs. This should now be
  151.                         fixed for RISC OS 3 but still doesn't work on OS 2.
  152.                         Thanks to Dave McCartney for testing this.
  153.  ---------------------------------------------------------------------------
  154.  1.07 (03 Jun 1995) : • Removed RISC OS 2 compatibility
  155.                       • No longer guaranteed to work with anything other
  156.                         than ADFS (see note below)
  157.                       • Disc is now always referred to by name in the
  158.                         'Disc Information' window
  159.                       • Various minor internal changes
  160.                         
  161.                                         
  162.  THINGS TO DO
  163.  ---------------------------------------------------------------------------
  164.  After many versions which only half worked, I think this one should work
  165.  with all ADFS discs. It's possible that you may be able to compact SCSI
  166.  discs, but the free space information won't work.
  167.  
  168.  If possible I'll try and get something sorted out for SCSI discs, but
  169.  nothing's guaranteed because I have no way of testing what I write! My
  170.  knowledge of filing systems is limited, and any help with adapting the
  171.  code for use with SCSI would be most appreciated. I need to be able to find
  172.  out the filing system for a particular drive which is selected and use the
  173.  appropriate SWI to get the free space information.
  174.   
  175.  The uncompressed Basic file is available on request if you send a disc, and
  176.  any help will be acknowledged in the next release!
  177.  
  178.  
  179.  LEGAL BIT
  180.  ---------------------------------------------------------------------------
  181.  This program is Freeware, NOT public domain. This means that I retain the
  182.  copyright but give everyone the right to distribute it by any means,
  183.  anywhere, as long as all files are supplied and I am fully credited.
  184.  
  185.  Although this program has been fully tested, I (the author) cannot be held
  186.  responsible for any loss or damage caused by the use or misuse of this
  187.  program. It is used entirely at your own risk.
  188.  
  189.  
  190.  CONTACT
  191.  ---------------------------------------------------------------------------
  192.  Please feel free to write to me at the address below. Let me know if you
  193.  can think of any ways to improve the program, or if you find any bugs. Any
  194.  donations will be greatly appreciated, and you can obtain the latest
  195.  versions of all my programs by sending either:
  196.  
  197.     a) A cheque for £1.00
  198.  or b) A disc, a first class stamp and a suitable method of returning your
  199.        disc. (If you send me the disc in a Jiffy bag then I can re-use it to
  200.        send the disc back).
  201.  
  202. Currently (17/6/1995) my other programs are as follows:
  203.  
  204.    - DirOpen   1.01 (04 Feb 1995) : Drag directories and apps to icon bar to
  205.                                     open them. Reopen last dir from icon bar
  206.    - IconSprit 1.10 (28 Jan 1995) : IconSprites, ToolSprites, save RAM and
  207.                                     ROM sprites to disc
  208.    - LoseCaret 1.12 (23 Feb 1995) : Force applications to lose the caret.
  209.                                     Useful if the app. doesn't pass on
  210.                                     unknown keypresses.
  211.    - NumberGen 1.00 (14 Jun 1995) : Random number generator, control over
  212.                                     range, accuracy and output type.
  213.    - PinExtend 1.15 (29 May 1995) : Easy method of putting sprites on the
  214.                                     backdrop, lots of options, load backdrop
  215.                                     on startup, etc.
  216.    - RAMstore  1.00 (09 Apr 1995) : Semi-permanent RAM disc. Automatic
  217.                                     loading and saving of data on RAM disc.
  218.    - ShowFile  1.01 (13 Feb 1995) : Display files using *Type/List/Dump,
  219.                                     various options.
  220.    - SmallSave 1.00 (17 Jun 1995) : Small, fast screensaver. Three savers,
  221.                                     hide icon, instant blank.
  222.    - TextInfo  1.12 (05 Mar 1995) : Counts words, characters, lines and
  223.                                     sentences in text files.
  224.    - TidyApp   1.01 (04 Mar 1995) : Rename !Boot, !Run in app. directories
  225.                                     (to correct wrong case, e.g. !boot) 
  226.                                    
  227.  
  228.  Please write to:
  229.  
  230.     Andrew Berry
  231.     39 Lancaster Avenue
  232.     Sandiacre
  233.     Nottingham
  234.     NG10 5GW
  235.     
  236.  ---------------------------------------------------------------------------