home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / comm / bbs / 002 / compare.doc next >
Encoding:
Text File  |  1991-01-18  |  8.8 KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.         _________________________________________________________________
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                      COMPARE
  30.                          BBS File List Comparing Utility
  31.  
  32.                                   User's Manual
  33.  
  34.                                   Version 1.05
  35.                          Copyright (c) 1991 Edward Gause
  36.  
  37.  
  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.                        Thank you for supporting Shareware
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      ABOUT COMPARE
  72.  
  73.      Compare is a handy utility for comparing file lists obtained from
  74.      Bulletin Board Systems (BBS).  Optionally, you may also build your
  75.      own list of files that you already have. How many times have you
  76.      tried uploading a file to a particular BBS and received the
  77.      "File already exist" notice?  By using COMPARE, you can determine
  78.      what files a BBS has (or possibly one or two you may not have!) and
  79.      save some online time and frustration.  Hence, my reason for
  80.      developing this program in the first place!
  81.  
  82.  
  83.      SYSTEM REQUIREMENTS
  84.  
  85.      The following configuration is the minimum required to run COMPARE:
  86.  
  87.          IBM PC/XT/AT or Compatible with 256k
  88.          2 Disk Drives (5.25 and/or 3.50)
  89.          CGA (or above) adaptor card
  90.          PC/MS-DOS 2.0 or higher
  91.  
  92.      A hard drive is highly encouraged if comparing very large files.
  93.      Several temporary files are created during operation and if disk
  94.      space is limited runtime errors may occur.  Also, a hard drive will
  95.      speed up read/write process during the file comparisons.
  96.  
  97.  
  98.      USING COMPARE
  99.  
  100.      Floppy Disk Users:
  101.  
  102.        1.  Place the diskette containing COMPARE.EXE in drive A.
  103.  
  104.        2.  Place a blank, formatted diskette in drive B.
  105.  
  106.        3.  At the "A:" prompt, type "COMPARE" (without quotes).
  107.  
  108.        4.  Shareware users will get a copyright notice screen is displayed
  109.            for 10 seconds.  Afterwards, press any key to continue to the
  110.            Main Menu.
  111.  
  112.  
  113.      Hard Disk Users
  114.  
  115.        1.  Make a sub-directory called "COMPARE" or whatever name you
  116.            choose.
  117.  
  118.        2.  Copy the program COMPARE.EXE to the newly created sub-
  119.            directory.
  120.  
  121.        3.  Type "COMPARE" (without quotes).
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.        ___________________________________________________________________
  130.        COMPARE Version 1.05                                         Page 1
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.        MAIN MENU
  138.  
  139.        The Main Menu is the heart of the program.  From here you may build
  140.        your own file lists,  compare file lists that you've downloaded
  141.        from a BBS or quit the program.
  142.  
  143.        Build File Lists
  144.  
  145.        Selecting this option prompts you for a filename to build and the
  146.        path where the files are stored.  The default filename is
  147.        "FILELIST.TXT" but you may choose another path and/or name if
  148.  
  149.        desired.  The default path is the current working directory.
  150.        Floppy disk users will enter "B:" here.  Hard disk users will enter
  151.        the path where they keep their downloaded files.  If reading from
  152.        floppy diskettes, you will have to repeat this process for each
  153.        diskette.  Hard Drive users should copy all their files to one
  154.        specific sub-directory (ie: C:\TEMP).  Once the new file is created
  155.        you can then delete all the files and remove the sub-directory
  156.        (refer to your DOS manual for creating and removing sub-
  157.        directories).
  158.  
  159.        Compare File Lists
  160.  
  161.        This is where the actual comparisons take place.  After selecting
  162.        this option you are prompted for the name of the files to compare.
  163.        If the files are located in the current working directory, all you
  164.        need to type in is the filenames, otherwise, input the path and
  165.        filename.
  166.  
  167.                EXAMPLE: C:\TEMP\MY_FILE.LST  or  B:FILELIST.TXT
  168.  
  169.        COMPARE will then begin to extract filenames from both lists and
  170.        store them in two separate temporary files.  It will match file 1
  171.        against file 2 and create a new file which will contain the file-
  172.        names that are not listed in file 1 (are you with me?).  Next, it
  173.        will repeat the process, creating another file contain-ing the
  174.        names of files not listed in file 2.  The new files will have the
  175.        same filenames but the extension "OUT" is added.  You can then
  176.        look at each file to see which files a BBS already has or that you
  177.        don't have.
  178.  
  179.        Quit
  180.  
  181.        Select this option to quit the program and return to DOS.
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.        ___________________________________________________________________
  196.        COMPARE Version 1.05                                         Page 2
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.        ACKNOWLEDGEMENTS
  204.  
  205.        I would like to thank Craig LaCoss for giving me this "Assignment".
  206.        While developing this program Craig, along with Jim Smoot were very
  207.        helpful in the debugging and suggestion departments (hopefully,
  208.        they didn't miss anything).  Thanks for keeping me "chk" guys!  By
  209.        the way, Craig is the SysOp of MEGABYTE BBS (408) 883-0604 and Jim
  210.        is SysOp for the VIKING BBS (408) 883-2853.  Both BBSs are located
  211.        on the Monterey Penisula, CA.  Give 'em a call sometime.
  212.  
  213.  
  214.        SHAREWARE AGREEMENT
  215.  
  216.        COMPARE, version 1.05 is distributed has shareware, therefore, you
  217.        may make copies of the program and its documentation and distribute
  218.        them freely to others under the following conditions:
  219.  
  220.        1.  No fee or other consideration is to be charged for copying or
  221.        distributing the program without written permission from the
  222.        author.
  223.  
  224.        2.  The program and its documentation are not to be modified in any
  225.        form.
  226.  
  227.        3.  Commercial users are required to register their copies.
  228.  
  229.  
  230.        REGISTRATION
  231.  
  232.        If you like this program and find it useful, a registration fee of
  233.        $15.00 is requested.  For your convenience, a registration form is
  234.        included. (See REGISTER.DOC)
  235.  
  236.        Registration entitles you to the following:
  237.  
  238.        1.  A serialized diskette of the latest version available at time
  239.        of registration.
  240.  
  241.        2.  Registered users will have the option available to sort file
  242.        list in alphabetical order.  Also, three new file extensions have
  243.        been added to the registered copy. The Shareware version searches
  244.        for ZIP, ARC, EXE, TXT, LZH, GIF, DOC, and LST extensions.  The
  245.        three extensions added are FLI, GL, and COM.
  246.  
  247.        3.  You will receive my telephone number for any support or
  248.        questions you require assistance on.
  249.  
  250.        4.  Notifications of future upgrades to this program.
  251.  
  252.        5.  Notification of new products developed.
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.        __________________________________________________________________
  262.        COMPARE Version 1.05                                        Page 3
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.        DISCLAIMER
  270.  
  271.        COMPARE is provide "as is" without warranty of any kind, either
  272.        expressed or implied, including but not limited to the loss of
  273.        business profits or information, business interruption or any other
  274.        loss arising out of the use or inability to use this software
  275.        product.
  276.  
  277.  
  278.        REVISION HISTORY
  279.  
  280.        12-27-90    Ver 1.0      Released to public.
  281.  
  282.        12-29-90    Ver 1.01     Fixed bug if file manipulation routine.
  283.                                 If there was only one filename listed in
  284.                                 output file, Compare would delete it.
  285.  
  286.        12-30-90    Ver 1.02     Set larger text buffer to speed up the
  287.                                 filename extraction process.
  288.  
  289.        12-31-90    Ver 1.03     Fixed bug in building files.  Adding new
  290.                                 filenames would erase old text file.
  291.  
  292.        01-10-91    Ver 1.04     Modified the "Build List" Option to repeat
  293.                                 file name and path during repeat scans.
  294.  
  295.        01-18-91    Ver 1.05     Added code to notify user of how many files
  296.                                 with "OUT" extensension were created.
  297.  
  298.  
  299.        Questions or comments will be deeply appreciated.  If there's
  300.        something about this program that you like or dislike, please tell
  301.        me.  It makes me try that much harder.  You may contact me on one
  302.        of the BBSs listed above or write to:
  303.  
  304.  
  305.                                 Edward Gause
  306.                                 1037 Scott Ct
  307.                                 Ft Ord, CA 93941
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.        __________________________________________________________________
  328.        COMPARE Version 1.05                                        Page 4
  329.  
  330.  
  331.