home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT131.ZIP / MATCHEM.ZIP / MATCHEM.DOC next >
Text File  |  1990-07-09  |  12KB  |  366 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                    MATCH'EM
  18.  
  19.                             File Comparison Utility
  20.  
  21.                                   Version 1.1
  22.  
  23.                               Copyright (c) 1990
  24.  
  25.                                       by
  26.  
  27.                                  David Gannon
  28.  
  29.  
  30.  
  31.                                 Distributed by
  32.  
  33.                              G&G Computer Services
  34.  
  35.                                 39 Cathy Circle
  36.  
  37.                              Portsmouth, RI 02871
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.     SHAREWARE NOTICE
  65.     ----------------
  66.  
  67.          Match'em is released as SHAREWARE.  A $6.00 registration fee is 
  68.     requested if you use the program and find it to be beneficial.  In any 
  69.     case, please feel free to copy and share this program with others.  I 
  70.     will only support those who contribute toward the development of this 
  71.     SHAREWARE product, but I will accept useful suggestions from ANYBODY!  
  72.     An order form is included at the end of this documentation file.  Use 
  73.     it to register Match'em or send along any comments.
  74.  
  75.  
  76.  
  77.  
  78.     DISCLAIMER
  79.     ----------
  80.  
  81.          MATCH'EM is provided on an 'as is' basis.  Any damages arising 
  82.     from the use of this program are entirely the responsibility of the 
  83.     user.  In other words, neither the author (David Gannon) nor the 
  84.     distributor (G & G Computer Services - or its employees) can be held 
  85.     responsible for any damages.
  86.  
  87.     INTRODUCTION
  88.     ------------
  89.  
  90.          You've been working on an important program (or text file) and 
  91.     have now written several different versions.  You finally decide which 
  92.     variation will work best but discover that, on your disk, you have the 
  93.     files PROG1, PROG2, PROG21, PROG3, PROG4, etc. and no recollection 
  94.     which contains the version you really want.  They're all fairly close 
  95.     in content so you wind up printing out each version and doing a line by 
  96.     line comparison of the hard copies.  Pretty time consuming and quite a 
  97.     pain!
  98.  
  99.          Enter Match'em....
  100.  
  101.          Match'em gives you the capability to compare a file in two ways.  
  102.     First, it will perform a 'quick' comparison of two files of any type 
  103.     (text, binary, etc.) and tell you whether the files are the same or 
  104.     different.  Secondly, for text (ASCII) files, it will perform a line by 
  105.     line comparison (showing the results on the screen) with several useful 
  106.     options to choose from.
  107.  
  108.  
  109.  
  110.     SYSTEM REQUIREMENTS
  111.     -------------------
  112.  
  113.          Match'em will run on any true IBM compatible machine (XT, AT, 
  114.     etc.) with any type of video display.
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.     EXECUTING THE PROGRAM
  123.     ---------------------
  124.  
  125.          MATCH'EM can be executed in one of two ways:
  126.  
  127.     1. Interactive Mode.  To run the program in this mode, simply type     
  128.        MATCHEM at the dos prompt and press the <ENTER> key.  MATCH'EM will 
  129.        then begin and guide you through the file comparison procedures.
  130.  
  131.     2. Command Line Mode.  To save keystrokes, the user can designate the 
  132.        files for comparison when executing the program.  To do this, type 
  133.        MATCHEM, followed by a space, then type the name of the files to 
  134.        compare (with drive and path parameters) separating the file names 
  135.        with a space.  Follow this by pressing the <ENTER> key.
  136.  
  137.          Examples:
  138.  
  139.                         MATCHEM file.1 file.2<ENTER>
  140.                         MATCHEM a:\file.1 b:\dos\file.2
  141.  
  142.       { entries can be made in upper case, lower case or a combination }
  143.  
  144.  
  145.     MAIN MENU OPTIONS
  146.     -----------------
  147.  
  148.          Upon program execution, the user is presented with a list of five 
  149.     options:
  150.  
  151.               1. Choose File #1
  152.               2. Choose File #2
  153.               3. Quick File Comparison
  154.               4. Text File Comparison
  155.               5. More About MATCH'EM
  156.               6. Exit to Dos
  157.  
  158.          In addition, pressing the <F1> function key will provide some 
  159.     useful help with the program.
  160.  
  161.     SELECTING A MAIN MENU OPTION
  162.     ----------------------------
  163.  
  164.          You may select an option by one of three methods.  You can simply 
  165.     'point and shoot' by pressing the number which appears in front of the 
  166.     item you wish.  You may use the up and down arrow keys to move the 
  167.     highlight bar.  When the option you wish to execute is highlighted, 
  168.     press the ENTER key.  Or, if you have a Microsoft compatible mouse, you 
  169.     may use it to move the highlight bar.  Your choice is then made by 
  170.     pressing the left mouse button.
  171.  
  172.     MAIN MENU OPTIONS EXPLAINED
  173.     ---------------------------
  174.  
  175.          CHOOSE FILE #1
  176.          --------------
  177.  
  178.               Upon selecting this option, you will be presented with a File 
  179.          Selection Box.  Pressing the up/down arrow key (or moving the 
  180.  
  181.  
  182.  
  183.          mouse) will move the highlight bar.  Pressing <ENTER> (or the left 
  184.          mouse button) will specify the file.
  185.  
  186.               The information displayed in the File Selection Box is as 
  187.          follows:
  188.  
  189.               1. Files are listed in white, with their name and extension,
  190.          their size in bytes, the date and time they were created and their
  191.          attribute.
  192.  
  193.               2. Directories are listed in yellow and display the same      
  194.          information as files except that the term '<DIR>' appears where a
  195.          file's size is indicated.  The directory with a '..' listed as its 
  196.          name is the current directory's parent directory.
  197.  
  198.               3. The information box at the top of the selection box      
  199.          provides the following additional disclosures:
  200.  
  201.                    a. The currently logged drive and directory.
  202.  
  203.                    b. The number of bytes contained in that directory.
  204.  
  205.               4. Pressing <F1> at this point will allow the user to change 
  206.          drives.  If selected, the user will be asked what drive they would 
  207.          like to log to.  If an invalid drive is given, the program will 
  208.          let you know and allow you to try again.
  209.  
  210.               5. Pressing <ALT><H> (the Alt key and the H key at the same 
  211.          time) will display a help screen which will list the following 
  212.          additional commands:
  213.  
  214.                    a. <ALT><D> sorts the file listing in native dos order.
  215.  
  216.                    b. <ALT><N> sorts the file listing alphabetically by 
  217.               file name.
  218.  
  219.                    c. <ALT><E> sorts the file listing alphabetically by 
  220.               file extension.
  221.               
  222.                    d. <ALT><S> sorts the file listing by file size.
  223.               
  224.                    e. <ALT><T> sorts the file listing by time/date of file 
  225.               creation.
  226.               
  227.                    f. <ALT><O> toggles the sort in ascending/descending
  228.               order.
  229.               
  230.                    g. <SPACE> displays the file box in the 'wide' format.
  231.               
  232.                    h. <ALT><Z> displays the file box in the 'long' format.
  233.               
  234.                    i. <F1> allows user to change logged disk drives.
  235.               
  236.                    j. <ALT><B> moves back up to parent directory.
  237.  
  238.          CHOOSE FILE #2
  239.          --------------
  240.  
  241.               Same as choosing file number one!
  242.  
  243.  
  244.  
  245.          QUICK FILE COMPARISON
  246.          ---------------------
  247.  
  248.               This option performs a byte by byte comparison of the two 
  249.          files, showing the number of bytes compared.  If the two files 
  250.          match, the user is told.  If they do not match, the user is 
  251.          informed of how many bytes matched before the mismatch occurred.
  252.  
  253.          TEXT FILE COMPARISON
  254.          --------------------
  255.  
  256.               Upon executing this option, the user is presented with two 
  257.          windows, one for displaying each of the designated files, and the 
  258.          first line from each file in its own window.
  259.  
  260.               At the top of the screen is a list of possible commands to be 
  261.          used in the text comparison procedure.  Pressing the following 
  262.          keys will carry out the designated action.
  263.  
  264.               <F1>  Lists one line from file number one.
  265.               <F2>  Lists one line from file number two.
  266.               <F3>  Lists two lines from file number one.
  267.               <F4>  Lists two lines from file number two.
  268.               <F5>  Lists four lines from file number one.
  269.               <F6>  Lists four lines from file number two.
  270.               <F7>  Continuously scrolls file number one.
  271.               <F8>  Continuously scrolls file number two.
  272.               <F9>  Carries out a continuous comparison.
  273.               <F10> Quits to the Main Menu.
  274.  
  275.               If one of the continuous scroll options (<F7> or <F8>) is 
  276.          chosen, the user may pause the scroll by pressing any key.  Once 
  277.          paused, pressing <ESC> (the escape key) will abort the scroll, 
  278.          pressing any other key will continue it.
  279.  
  280.               The list options associated with <F1> through <F6> are useful 
  281.          when carrying out a continuous compare and a mismatch is found.  
  282.          The user can then list one, two or four lines from each file in an 
  283.          effort to get them back into synch to allow continuation of the 
  284.          comparison.
  285.  
  286.          MORE ABOUT MATCH'EM
  287.          -------------------
  288.  
  289.               Displays a little program advertisement.
  290.  
  291.          EXIT TO DOS
  292.          -----------
  293.  
  294.               Selecting this option will quit the program and return the 
  295.          user to the operating system.
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.                     G&G Computer Services Registration Form
  306.  
  307.                      for MATCH'EM file comparison utility.
  308.  
  309.    Please fill out the following registration form and enclose a
  310.    check or money order for $6.00 (U.S. funds only) payable to 
  311.    G&G Computer Services.
  312.  
  313.    Remit both to:
  314.  
  315.    G&G Computer Services
  316.    39 Cathy Circle
  317.    Portsmouth, RI     02871
  318.    -----------------------------------------------------------------
  319.  
  320.    Name:  Last _____________________  First ________________________
  321.  
  322.    Company: ________________________________________________________
  323.  
  324.    Address: ________________________________________________________
  325.  
  326.    City _____________________________  State ________  Zip _________
  327.  
  328.    Area Code ______  Phone ____________________
  329.  
  330.    -----------------------------------------------------------------
  331.    The ability of G&G to continue to provide programs to computer
  332.    users depends largely on the registration support. Please help us
  333.    in this effort by returning this form with your payment promptly.
  334.  
  335.    What make and model IBM/compatible do you use (Tandy, IBM XT)?
  336.  
  337.  
  338.    Check which type of disk drive(s) is on your machine:
  339.  
  340.         360K 5.25in.(DSDD)   ______
  341.         1.2meg 5.25in.(DDHD) ______
  342.         720K 3.5in.(DSDD)    ______
  343.         1.44meg 3.5in.(DSHD) ______
  344.         Hard (fixed) disk    ______
  345.  
  346.    What type of video card you are using:
  347.  
  348.         Hercules ______
  349.         CGA      ______
  350.         EGA      ______
  351.         VGA      ______
  352.         Other    ______  If other, please explain. ______________________
  353.  
  354.    _________________________________________________________________
  355.  
  356.    Comments or suggestions on this program for future releases:
  357.  
  358.    _________________________________________________________________
  359.  
  360.    _________________________________________________________________
  361.  
  362.    _________________________________________________________________
  363.  
  364.    Thank you
  365.    G&G Computer Services
  366.