home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util2 / sherlock.lzh / SHERLOCK.DOC next >
Text File  |  1989-01-01  |  13KB  |  358 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                  S H E R L O C K
  16.  
  17.                         An ASCII File Comparison Utility
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                      Copyright 1989 John P. Bauernschub, Jr.
  38.                                14809 Clavel Street
  39.                                Rockville, MD 20853
  40.                                   301-460-0354
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.            Member of the Association of Shareware Professionals (ASP)
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.                                     SHERLOCK
  58.  
  59.      SHERLOCK is designed to do one job, compare two ASCII files line by
  60.      line.  When they don't match, SHERLOCK raises a flag.  At that point,
  61.      you may scroll either or both files passed the mismatch to put them in
  62.      sync and then continue.  SHERLOCK contains features for jumping around
  63.      the files, restarting, and copying lines to a printer.  SHERLOCK does
  64.      not write to either file.
  65.  
  66.      SHERLOCK is designed as a tool for programmers, writers and
  67.      workstation support personnel.  It is best on files like program
  68.      source files, AUTOEXEC.BAT, CONFIG.SYS, and text documents.
  69.  
  70.      SHERLOCK displays five lines of each file in separate windows.  The
  71.      line from each file that is being compared is in the center of the
  72.      window and highlighted.  The line number of the center line is
  73.      displayed in the upper left corner of the window frame.  When they do
  74.      not match, a message pops up between the windows.  The top line of
  75.      each window frame displays the number of the center line and the name
  76.      of the file.
  77.  
  78.      SHERLOCK is started by entering one of the following commands:
  79.  
  80.                          SHERLOCK
  81.  
  82.                          SHERLOCK filename1
  83.  
  84.                          SHERLOCK filename1 filename2
  85.  
  86.                          SHERLOCK filename1 *
  87.  
  88.      If you do not enter a filename or filenames, SHERLOCK will prompt you.
  89.      If you want to have the exact same file in both windows for learning
  90.      SHERLOCK, enter only an asterisk for the second file name.  SHERLOCK
  91.      will substitute the first file name for the asterisk.
  92.  
  93.      If you are comparing two files with the same name that are on
  94.      different disks or in different directories, enter the filename that
  95.      is in the current directory as filename1, either on the DOS command
  96.      line or at the prompt.  For the second file name, enter the drive or
  97.      path followed by an asterisk (no space between the path and the
  98.      asterisk).  Again, SHERLOCK will substitute the first file name for
  99.      the asterisk.
  100.  
  101.      SHERLOCK starts by displaying the title screen.  It explains how to
  102.      register this Shareware program.  The bottom line of the screen
  103.      prompts for an M if you are using a monochrome monitor, otherwise
  104.      press any other key to continue.  If there is NOT a border line around
  105.      the title screen on your display, press M.
  106.  
  107.      The following is a list of operations that can be activated by
  108.      function keys.
  109.  
  110.  
  111.                                       -2- 
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                              FUNCTION KEYS
  119.  
  120.                          FK 1    Help
  121.                          FK 2    Jump to Line
  122.                          FK 3    Quit Now
  123.                          FK 4    Jump to DOS
  124.                          FK 5    Open a New File
  125.  
  126.                          FK 7    Print Highlighted Line
  127.                          FK 8    Print Registration Form
  128.                          FK 9    Toggle Display ON/OFF
  129.                          FK 10   Toggle Auto SCAN ON/OFF
  130.  
  131.      Functions 1, 2, 4, 5, 7 and 8 open a window with information or a
  132.      menu.  Function 10 starts the auto scan that continues until a line is
  133.      found that does not match, the end of either file is reached, function
  134.      key 10 is pressed again, or the ESC key is pressed.
  135.  
  136.      Function key 9 controls whether the text lines will be displayed
  137.      during autoscan.  The reason for not having the text displayed during
  138.      autoscan is to speed the scan rate.  Function key 9 toggles a flag
  139.      that indicates the status of the display mode.  This flag is not
  140.      visible until the toggle is first pressed.  The text is always
  141.      displayed when the autoscan mode is off.
  142.  
  143.      Function key 10 toggles autoscan on and off.  When a mismatch is found
  144.      during autoscan, autoscan stops.
  145.  
  146.      The ESC key can be used to stop any activity in SHERLOCK.
  147.  
  148.      Function Key 1 produces the following list of action keys that move
  149.      the text in the windows.
  150.  
  151.                                    ACTION KEYS
  152.  
  153.                     Page Up            Scroll both windows up
  154.                     Page Down          Scroll both windows down
  155.                     Up   Arrow         Scroll top  window  up
  156.                     Down Arrow         Scroll top  window  down
  157.                     Shift Up   Arrow   Scroll botm window  up
  158.                     Shift Down Arrow   Scroll botm window  down
  159.                     Left  Arrow        Shift midlines left  20
  160.                     Right Arrow        Shift midlines right 20
  161.                             Home       Beginning of Both files
  162.                             End        End of       Both files
  163.                     Control Home       Beginning of Top file
  164.                     Control End        End of       Top file
  165.                       Shift Home       Beginning of Bottom file
  166.                       Shift End        End of       Bottom file
  167.  
  168.                     Ins          Scroll top window until Match
  169.                     Del          Scroll botm window until Match
  170.                     ESC                STOP any activity
  171.  
  172.  
  173.  
  174.                                       -3- 
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.      Always use the NUMERIC keypad keys for performing the actions listed
  182.      above.  The SHIFTED commands used with Up, Down, Home, and End are NOT
  183.      activated by the keys on the separate cursor keypad.
  184.  
  185.      If the auto scan mode is off, pressing ESC will open a window to ask
  186.      if you really want to quit SHERLOCK.  Pressing function key 3 causes
  187.      the program to terminate immediately.
  188.  
  189.      SHERLOCK uses the arrow keys on the numeric keypad.  SHERLOCK turns
  190.      the NUM Lock off when it starts.  It turns it on again when you press
  191.      a function key that requests numeric input, then turns it off again.
  192.      So don't touch the NUM Lock key when using SHERLOCK.  Again, the arrow
  193.      keys on the separate cursor keypad do not work as SHERLOCK actions
  194.      should.  So if you are using a larger keyboard, only use the numeric
  195.      cursor keypad.
  196.  
  197.  
  198.                                   SHAREWARE
  199.  
  200.      SHERLOCK is NOT a public domain program.  It is copyrighted and
  201.      distributed as SHAREWARE.  SHERLOCK may be distributed on bulletin
  202.      boards, by computer user groups and by others who distribute it for
  203.      $10 or less.  SHERLOCK.EXE and SHERLOCK.DOC, must be distributed
  204.      together and unaltered.
  205.  
  206.      If after evaluating SHERLOCK, you decide to use it or keep it for when
  207.      you will need it, then you must submit the registration fee.  The
  208.      registration form is at the end of the documentation and a copy can be
  209.      printed by pressing function key 8 in the program.
  210.  
  211.      There is no warranty, expressed or implied with respect to this
  212.      manual, the software or any related items, their quality, performance,
  213.      or fitness for any particular use.  It is the user's responsibility to
  214.      determine their suitability for any particular purpose.
  215.  
  216.      The author will in no event be held liable for direct, indirect or
  217.      incidental damages resulting from any defect or omission in this
  218.      manual, floppy disks, or other related items and processes, including
  219.      but not limited to any interruptions of service, loss of business or
  220.      anticipatory profit, or other consequential damages.
  221.  
  222.      The animated title of SHERLOCK can be stopped by pressing any key
  223.      after the animation starts.  A reward for those who have read this
  224.      far.
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.                                       -4- 
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.                                  PC-ACCOUNT
  245.  
  246.           Another program written by the author of SHERLOCK is PC-ACCOUNT.
  247.      PC-ACCOUNT is a Shareware personal accounting system with data base
  248.      retrieval capabilities.  With it, you can discard your checkbook
  249.      ledger.  Its most unique feature is its ability to print on any
  250.      personal check.
  251.  
  252.           Personal checks are usually not designed for the normal line
  253.      spacing of 6 lines per inch.  This program utilizes the variable line
  254.      spacing of most printers to achieve the efficiency and accuracy of
  255.      having your computer print on your checks.  A utility lets you create
  256.      formats for fifteen different checking accounts.  The check is
  257.      printed as soon as the transaction is completed.  The amount is
  258.      printed on the check in words.
  259.  
  260.           A directory is maintained of check payees and memo data to be
  261.      printed on the check, such as its purpose or your account number with
  262.      the payee.  Payees are selected by number, and the name and memo are
  263.      automatically transferred to the check.
  264.  
  265.           Searches can be made for all transactions against an account,
  266.      for a user defined code, for an amount, for a text string within the
  267.      comment, or for a check number.  These searches can be made through
  268.      any selected consecutive months, so a full years transactions in a
  269.      specific category can be retrieved at tax time.
  270.  
  271.           Recurring transactions such as loan payments and cash
  272.      distributions to accounts can be saved, edited and invoked on command
  273.      for auto entry.  There is a routine that can reconcile your bank
  274.      statement swiftly.  Another routine double checks the line by line
  275.      totals in your checkbook.
  276.  
  277.           This system makes full use of the features of the IBM PC.  All 10
  278.      function keys are used.  Listings of accounts and transactions can be
  279.      output to the screen, to the printer, to a disk text file, or to a
  280.      file that can be imported by Lotus 1-2-3.
  281.  
  282.           This software works on the IBM PC/XT/AT with 256K of free
  283.      memory and at least 1 double sided disk drive.  It runs under PC DOS
  284.      2.0 and later versions.  It is distributed on bulletin boards,
  285.      CompuServe, and by Shareware disk vendors.  It comes in three files:
  286.      PCACT220.TXT, PCDOC220.ARC, and PCACT220.ARC
  287.  
  288.  
  289.                        GET PC-ACCOUNT WITHOUT DOWNLOADING
  290.  
  291.           You may order a disk with the latest PC-ACCOUNT system from the
  292.      author to save the time of downloading.  Send $45.00 to register it
  293.      right away and get the benefit of immediate telephone assistance, or
  294.      send $3.00 for a copy.  The same software will be sent First Class
  295.      whether you register now or not.  With the $3.00 offer, you will
  296.      receive a coupon for a $2.00 rebate from the $45.00 registration fee.
  297.  
  298.  
  299.  
  300.                                       -5- 
  301.  
  302.  
  303.  
  304. SDN Distribution
  305.    JPB010189
  306.  
  307.                   SHERLOCK REGISTRATION FORM
  308.  
  309.  
  310.        I am using Version ___________________________
  311.  
  312.        Name    ______________________________________
  313.  
  314.        Address ______________________________________
  315.  
  316.        City    ______________________________________
  317.  
  318.        State   _________________  ZIP _______________
  319.  
  320.        Phone   ( __ __ __ )   __ __ __ -- __ __ __ __
  321.  
  322.        Date you acquired SHERLOCK ___________________
  323.  
  324.        How did you acquire SHERLOCK?
  325.  
  326.        ____ From a friend    ____ Bulletin Board
  327.  
  328.        ____ User Group       ____ Commercial distribution service
  329.  
  330.             Which one? ______________________________
  331.  
  332.        Computer _____________________________________
  333.  
  334.        Printer ______________________________________
  335.  
  336.  
  337.        You are required to register your license of SHERLOCK if you continue
  338.        to use it or keep it for when you need it.  You will then obtain
  339.        telephone and mail support, receive information on future updates,
  340.        support user developed software and the Shareware concept.
  341.  
  342.        Send this form with the $20.00 registration fee to:
  343.  
  344.                            John P. Bauernschub, Jr.
  345.                            14809 Clavel Street
  346.                            Rockville, Maryland 20853
  347.  
  348.           You can also register directly through the Public (Software)
  349.           Library 1-800-2424-PSL (for orders only. For information
  350.           call 1-713-665-7017) or by writing PSL; P.O.Box 35705;
  351.           Houston, TX 77235-5705.  MC/Visa Accepted.
  352.  
  353.             Member of the Association of Shareware Professionals (ASP)
  354.  
  355.                     Thank you for your interest and support.
  356.  
  357.  
  358.