home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT081.ZIP / NOAHSARC.EXE / lha / NOAH.DOC < prev    next >
Text File  |  1990-05-04  |  16KB  |  463 lines
  1.  
  2.  
  3.  
  4.  
  5.     INTRODUCTION
  6.  
  7.         NOAH's archive utility is a file compression program which uses a
  8.     new compression algorithm I developed while engaged in research in the
  9.     computer graphics laboratory at a major University.
  10.  
  11.         Originally designed to compress screens containing graphics
  12.     characters for transmission to a raster display, the algorithm has been
  13.     incorporated into NOAH's archive utility and provides a higher degree
  14.     of compression than any other archive utility.
  15.  
  16.  
  17.     FILES IN THE SHAREWARE ARCHIVE FILE
  18.  
  19.         NOAH.EXE - For use on 8088/8086 processors.
  20.         NOAH.DOC - Documentation in ASCII format.
  21.      NOAH286.EXE - For use on 80286/80386/80486 processors.
  22.        NOAHD.EXE - Stand alone decompression utility.
  23.     NOAHMAKE.EXE - Creates batch files for use with NOAH.
  24.  
  25.  
  26.     COPYRIGHT INFORMATION
  27.  
  28.         The programs on this disk have received copyrights in 1989 and
  29.     1990. These programs are not in the public domain. These programs have
  30.     been released as shareware. Shareware is a concept where the author
  31.     allows you to test and evaluate the software for a reasonable trial
  32.     period before you decide whether or not to purchase the software.
  33.  
  34.  
  35.     INSTALLING THE SOFTWARE
  36.  
  37.         I suggest that you make a backup of the distribution disk before
  38.     using the software. The steps listed below be followed to be sure you
  39.     have a complete working backup.
  40.  
  41.         1) Use DISKCOPY to copy the distribution disk.
  42.         2) Use DISKCOMP to verify the backup is identical.
  43.         3) Place a write protect tab on both disks.
  44.  
  45.         Once the backup has been made, you will have to extract the files
  46.     from the archive storage file. Please see the READ.ME file on the
  47.     shareware distribution disk for complete information.
  48.  
  49.  
  50.     USING NOAH'S ARCHIVE UTILITY
  51.  
  52.         There are just two commands you have to know about. These are used
  53.     on the command line when you call the program.
  54.  
  55.         C    compresses a file
  56.         D    decompresses a file
  57.         For example, to compress the file FOO.EXE and store it in a file
  58.     named FOO.1 the command line would be as follows:
  59.  
  60.                               NOAH C FOO.EXE FOO.1
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.         To decompress the file FOO.1 and store it in a file named FOO.EXE
  72.     the command line would be as follows:
  73.  
  74.                               NOAH D FOO.1 FOO.EXE
  75.  
  76.                                        or
  77.  
  78.                              NOAHD D FOO.1 FOO.EXE
  79.  
  80.         The second command would be used with NOAHD.EXE the stand alone
  81.     decompression utility. It is faster than using NOAH with the D command.
  82.  
  83.         NOAH does not compress multiple files into one file. NOAH works on
  84.     a file by file basis which allows optimum compression to occur. NOAH
  85.     does not force you to use any particular file extension. You have total
  86.     control over what file extensions are used. You are required to enter
  87.     the name of the file to be processed and the name of output file.
  88.  
  89.  
  90.     USING NOAH IN BATCH FILES
  91.  
  92.         NOAH can be used in a batch file to install software. This is the
  93.     easiest way to use NOAH for software distribution. You can provide
  94.     either an ASCII batch file, or use one of the batch file compilers if
  95.     you desire. The NOAHMAKE.EXE utility is provided on the disk and is a
  96.     great help when using batch files. The use of this utility will be
  97.     discussed in detail further along in the documentation.
  98.  
  99.         A very simple batch file named INSTALL.BAT might look like this:
  100.  
  101.         @ECHO OFF
  102.         NOAHD D %1FOO.1 %2FOO.EXE
  103.         NOAHD D %1FOO.2 %2FOO.OVL
  104.         NOAHD D %1FOO.3 %2FOO.OVR
  105.         NOAHD D %1FOO.4 %2FOO.DOC
  106.  
  107.         In this case you would instruct the user to place the disk
  108.     containing the compressed files in a floppy drive and then enter the
  109.     following command:
  110.  
  111.         INSTALL x: y: <ENTER>
  112.  
  113.         Of course the user would have to substitute the proper drive
  114.     letters for x: and y: for the procedure to operate properly. This is
  115.     just a simple example of a batch file. You can extend it to any lengths
  116.     you require.
  117.  
  118.     TEST RESULTS
  119.  
  120.         Tests have confirmed that NOAH has a higher compression ratio than
  121.     any other archive utility currently available. Due to its proprietary
  122.     algorithm, NOAH CAN compress files which other archive utilities cannot
  123.     compress. In several instances NOAH compressed files while other
  124.     utilities produced compressed files larger than the original file. I
  125.     have enclosed excerpts from the tests to allow you to get a better idea
  126.     of how NOAH performs.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.         1) ASCII FILE COMPRESSION TESTS
  138.  
  139.            For the test of compression on ASCII files we compressed 38
  140.            ASCII files ranging in size from 96 to 163,197 bytes.
  141.  
  142.         2) .COM FILE COMPRESSION TESTS
  143.  
  144.            For the test of compression on .COM files we compressed 27 files
  145.            ranging in size from 213 to 31,127 bytes.
  146.  
  147.         3) .EXE FILE COMPRESSION TESTS
  148.  
  149.            For the test of compression on .EXE files we compressed 32 files
  150.            ranging in size from 1,977 to 331,725 bytes.
  151.  
  152.         4) SPREADSHEET COMPRESSION TESTS
  153.  
  154.            For the test of compression on spreadsheet files we compressed
  155.            24 Lotus 123 spreadsheet files ranging in size from 6,197 to
  156.            31,262 bytes.
  157.  
  158.         5) HARD TO COMPRESS FILES
  159.  
  160.            There are certain files which resist compression. These include
  161.            files processed by a program compression utility as well as
  162.            dictionary files for numerous word processors and graphics files
  163.            from programs like Animator. We compressed 11 of these files
  164.            ranging in size from 4,0288 to 338,780 bytes.
  165.  
  166.         After computing the totals for the tests it was determined that
  167.     NOAH consistently achieved the highest degree of compression followed
  168.     by PKZIP, LHARC and ARC.
  169.  
  170.  
  171.             FILES   ORIGINAL      NOAH     PKZIP     LHARC       ARC
  172.  
  173.             ASCII     598955    203687    216489    240766    281860
  174.  
  175.              .COM     176671    127601    132720    128645    152763
  176.  
  177.              .EXE    1166291    601215    623084    629002    825421
  178.  
  179.               123      81055     30262     34932     37776     42092
  180.  
  181.              HARD     440145     38243    440867    426331    440352
  182.  
  183.            TOTALS    2463117   1001008   1448092   1462520   1742488
  184.  
  185.         As you can see from the chart above NOAH provided the highest
  186.     degree of compression in all of the tests. This is due to the fact that
  187.     NOAH compresses each file as an individual unit. Many of the other
  188.     archive utilities select one compression method and use that method for
  189.     all of the files being compressed.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.     REPORTING A SOFTWARE PROBLEM
  204.  
  205.         In the event that discover a problem, the author would like to
  206.     hear about it. After you have read the documentation to be sure you are
  207.     not doing something wrong, please fill out and return the enclosed
  208.     Problem Report Form, by U.S. mail.
  209.  
  210.         Please fill out the form completely so the author can understand
  211.     what the problem is. If possible include screen dumps of the problem
  212.     you have found. If you have any unusual hardware installed please be
  213.     sure to include this information as well.
  214.  
  215.  
  216.     SOFTWARE WARRANTY
  217.  
  218.         This software has been tested and found to be error free. The
  219.     author has taken all reasonable steps to be certain that this software
  220.     will perform as indicated. However it is impossible for any author to
  221.     test their software on every computer in existence today. The author
  222.     and his distributors cannot be held responsible for any damage, real or
  223.     otherwise that occurs from the use of this software.
  224.  
  225.         For a period of ninety (90) days from the date of purchase the
  226.     author will attempt to fix any problems you might discover. If this is
  227.     not possible the author will refund your purchase price.
  228.  
  229.               _______
  230.          ____|__     |                (R)
  231.       --|       |    |-------------------
  232.         |   ____|__  |  Association of
  233.         |  |       |_|  Shareware
  234.         |__|   o   |    Professionals
  235.       -----|   |   |---------------------
  236.            |___|___|    MEMBER
  237.  
  238.  
  239.         This program is produced by a member of the Association of
  240.     Shareware Professionals (ASP). ASP wants to make sure that the
  241.     shareware principle works for you. If you are unable to resolve a
  242.     shareware related problem with an ASP member by contacting the member
  243.     directly, ASP may be able to help you.
  244.  
  245.         The ASP Ombudsman can help you resolve a dispute or problem with an
  246.     ASP member, but does not provide technical support for member's
  247.     products. Please write to the ASP Ombudsman at P.O. Box 5786, Bellevue,
  248.     Washington 98006 or send a CompuServe message via easyplex to ASP
  249.     Ombudsman 70007,3536.
  250.  
  251.  
  252.     REGISTERING NOAH'S ARCHIVE UTILTIES
  253.  
  254.         Registration of this shareware is REQUIRED if you continue to use
  255.     the software after a reasonable trial period. I consider a reasonable
  256.     trial period to be thirty days. There are several registration options
  257.     available to select from. The first is a PERSONAL registration. This
  258.     allows you to run the software on one computer at a time. A PERSONAL
  259.     registration DOES NOT allow you to run the software on a network server
  260.     or under a multi-user operating system!
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.         A COMMERCIAL registration is available for corporate, commercial or
  270.     governmental use where more than one person might run the software at
  271.     one time. This registration includes a site license for unlimited use
  272.     at one location and a network server license for use on multiple
  273.     networks at one location.
  274.  
  275.         An EDUCATIONAL registration is also available. To qualify for this
  276.     you must attach the enclosed order form to your school's purchase order
  277.     or letterhead. Purchase orders are accepted from schools provided they
  278.     clearly indicate NET 10 DAY terms. An EDUCATIONAL registration includes
  279.     a distribution license allowing you to distribute copies to faculty,
  280.     staff and students.
  281.  
  282.         All registrations include updates for a period of one year from the
  283.     date of purchase and technical support as required. After one year,
  284.     updates can be purchased for an update fee equal to thirty percent of
  285.     the license fee in effect.
  286.  
  287.         To obtain an update during the one year period following your
  288.     purchase you must send a check or money order for five ($5) dollars to
  289.     the author to cover shipping and handling costs. Please use the
  290.     REGISTER.DOC file on the shareware distribution disk to register this
  291.     software.
  292.  
  293.  
  294.     USING NOAHMAKE
  295.  
  296.         NOAHMAKE is used to create batch files for use with NOAH. These
  297.     batch files can be used to compress files or to decompress files. The
  298.     following procedure should be followed to use NOAHMAKE.
  299.  
  300.         1) Change to the directory where the files to be compressed are
  301.            stored or create a new directory and copy the files to be
  302.            compressed to this directory.
  303.         2) Copy NOAHMAKE to the directory.
  304.  
  305.         3) Run NOAHMAKE and read the information screen displayed.
  306.  
  307.         4) Allow NOAHMAKE to create the batch files.
  308.  
  309.         At this point in time the directory will contain the original files
  310.     plus two new batch files named COMPRESS.BAT and INSTALL.BAT. I have
  311.     included samples of the batch files below.
  312.  
  313.     @ECHO OFF
  314.     REM CREATED ON 04-19-1990 AT 14:01:28 - FILE I.D. NUMBER 147894
  315.     REM THIS IS THE COMPRESSION BATCH FILE
  316.     NOAH C %1PW.COM %2PW.1
  317.     NOAH C %1MASTER1.SPC %2MASTER1.2
  318.     NOAH C %1MASTER2.SPC %2MASTER2.3
  319.     NOAH C %1MASTER3.SPC %2MASTER3.4
  320.     NOAH C %1PERSONAL.SPC %2PERSONAL.5
  321.  
  322.         The COMPRESS.BAT file shown above contains the names of the files
  323.     found in the directory. NOAHMAKE.EXE, COMPRESS.BAT and INSTALL.BAT are
  324.     excluded from the list. Each line of the batch file calls NOAH with the
  325.     C (compress) switch and compresses a file. The programs keeps track of
  326.     the number of files and adds the number as the file extension.
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.     You can see that I have added a variable to allow you to designate the
  336.     source and destination drives.
  337.  
  338.         Calling the COMPRESS batch file as follows:
  339.  
  340.                               COMPRESS C:\PFS\ D:\
  341.  
  342.     would instruct COMPRESS.BAT to compress the files in C:\PFS\ and store
  343.     them on drive D in the root directory.
  344.  
  345.     @ECHO OFF
  346.     REM CREATED ON 04-19-1990 AT 14:01:28 - FILE I.D. NUMBER 147894
  347.     REM THIS IS THE INSTALL (DECOMPRESSION) BATCH FILE
  348.     IF %1dr == %2dr goto samedrive
  349.     NOAHD D %1PW.1 %2PW.COM
  350.     NOAHD D %1MASTER1.2 %2MASTER1.SPC
  351.     NOAHD D %1MASTER2.3 %2MASTER2.SPC
  352.     NOAHD D %1MASTER3.4 %2MASTER3.SPC
  353.     NOAHD D %1PERSONAL.5 %2PERSONAL.SPC
  354.     goto end
  355.     :samedrive
  356.     ECHO --- THE SOURCE AND DESTINATION DRIVES MUST BE DIFFERENT!
  357.     goto end
  358.     :end
  359.     REM The files will require 357683 bytes to install.
  360.  
  361.         The second example above is the INSTALL (decompression) batch file.
  362.     This could be used (after being edited and/or compiled) to INSTALL the
  363.     files from the distribution disk. Note that the last line will display
  364.     the total amount of disk space required by the files. This number is
  365.     calculated by adding the size of each file included in the batch file.
  366.  
  367.         NOAHMAKE creates very simple batch files. Each set of batch files
  368.     contain a file I.D. number. These I.D. numbers are used to be sure that
  369.     the COMPRESS file matches the INSTALL file. All of the lines starting
  370.     with 'REM' can be deleted once you are finished editing the batch
  371.     files.
  372.  
  373.         The batch files are compatible with BATCOM a batch file compiler.
  374.     I suggest that you use the batch files created by NOAHMAKE as a
  375.     starting point and edit them to your specifications.
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.                               PROBLEM REPORT FORM
  402.  
  403.         Please fill out this form completely and return it to the author.
  404.     Certain questions require you to fill in answers and others require you
  405.     to circle an answer.
  406.  
  407.     Program: ______________________         Version: ___________________
  408.  
  409.     Date: _________________________         Phone: _____________________
  410.  
  411.     DOS version: __________________         DOS:   PC  -  MS  - 386MOS
  412.  
  413.     EMAIL address: _____________________________________________________
  414.  
  415.     Processor: 8086  80286  80386SX  80386DX  80486  NEC V20  NEC V30
  416.  
  417.     Co-Processor: None  8087 80287 80387SX 80387 Weitek 1167  3167  4167
  418.  
  419.     Floppy 1: 360k  720k  1.2m  1.4m  Floppy 2: 360k  720k  1.2m 1.4m
  420.  
  421.     Hard disk manufacturer:________________________________________
  422.  
  423.     Hard disk capacity:____________________________________________
  424.  
  425.     Disk controller: XT type  AT type  Interface: RLL  MFM  SCSI ESDI IDE
  426.  
  427.     Please describe the problem in as much detail as possible. If possible
  428.     please include screen dumps commented to show the problem and any error
  429.     messages DOS or the program may have displayed.
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.     Please return this form to the author. I will evaluate and attempt to
  450.     correct the error as soon as possible. If I require more information I
  451.     will contact you by phone or by EMAIL.
  452.  
  453.                                  Richard Levey
  454.                                151-28 22nd Avenue
  455.                            Whitestone, New York 11357
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.