home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / program / boota / !Compare / !Help < prev    next >
Encoding:
Text File  |  1991-12-15  |  2.6 KB  |  65 lines
  1. Compare Utility
  2. ---------------
  3.  
  4. This is a very simple utility that compares two files and reports
  5. on any difference in:
  6.  
  7.  -   file type
  8.  -   file length
  9.  -   contents
  10.  -   date stamp.
  11.  
  12. If the contents are different it does not attempt to report on
  13. what the differences are.
  14.  
  15. To use it, the !Compare icon should first be installed on the
  16. icon bar. Then two files should be selected (using the mouse
  17. ADJUST button) and then dragged to the !Compare icon.
  18.  
  19. The '!RunA' file works by saving the identification for the first
  20. dragged to it in a system variable and then running the actual
  21. compare program when the second file is dragged to it. Clicking
  22. on the !Compare icon on the icon bar (instead of dragging file
  23. icons to it) will clear the system variables used and can be used
  24. to 'reset' !Compare' if it gets out of synch.
  25.  
  26. Two versions of the utility are provided (for no particular
  27. reason other than interest). Both are written in Basic and are
  28. very similar, but one version has been compiled with the ABC
  29. Basic Compiler while the second version is intended to run under
  30. the Basic Interpreter and has been optimised with some assembler
  31. code to speed up the actual comparison of the contents. The
  32. distributed !RunA file will invoke the compiled version and
  33. requires the Acorn Floating Point Emulator and ABCLibrary
  34. relocatable modules to be present.
  35.  
  36. The files corresponding to the two versions are:
  37.  
  38.  
  39.                          Filename          Function
  40.                          --------          --------
  41.  
  42.  Compiled version:       !RunA             Obey file
  43.                          Source            Source code
  44.                          Object            Compiled object code
  45.                          ABClib            ABC Basic Library module
  46.  
  47.  Interpreted version:    !RunA_int         Obey file
  48.                          !RunImage         Basic program
  49.  
  50.  
  51. In order to change from the compiled to the interpreted version,
  52. rename the "!RunA" file to some other name (e.g. "!RunA_cpl") and
  53. then rename the "!RunA_int" file to "!RunA".
  54.  
  55. This application also uses the 'BootA$util' program which resides
  56. in the !BootA application directory. This program is run to send
  57. a message to the BootA application requesting a change of sprite
  58. name for the icon installed on the icon bar. The !sprites file
  59. for !Compare contains three sprites: '!compare', which is the one
  60. initially used when the client application is installed;
  61. 'compare0', which is used when one file has been dragged to the
  62. icon; and 'compare1', which is used when two files have been
  63. dragged and the comparison is under way. After the comparison is
  64. complete, the icon reverts back to displaying '!compare' to show
  65. that it is ready for use again.