home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / ON_DISC / ONDISC03.MSA / ACC_ARC.DOC next >
Encoding:
Text File  |  1985-11-19  |  6.5 KB  |  158 lines
  1. ARC Introduction and short docs.
  2.           ARC (short for archive) is a file library and compression
  3.           utility.  It may be thought of as an improved version
  4.           of LU and SQUEEZE all rolled into one program.
  5.  
  6.           ARC analyzes each file to see which of a number of
  7.           compression techniques will generate the smallest code.
  8.           The following estimates give the user a general idea of
  9.           how much compression may be gained by using ARC.
  10.  
  11.                 ARC Text -            45-55% reduction from original
  12.                 SQUEEZED Text -       30-40% reduction
  13.  
  14.                 ARC Programs -        25-30% reduction
  15.                 SQUEEZED Programs -   15-20% reduction
  16.  
  17.                 ARC Pictures -        45-55% reduction
  18.                 SQUEEZED Pictures -   40-50% reduction
  19.                 TINY Pictures -       40-50% reduction
  20.  
  21.           The user should see that compressing files with ARC
  22.           will allow easier telecommunications by combining files
  23.           and shortening their transfer time.
  24.  
  25.      Usage from TOS
  26.           - double-click-left on ARC.TTP icon
  27.           - observe OPEN APPLICATION menu for ARC.TTP parameters
  28.           - enter switch, archive name and file template
  29.             (ex: lh arc.arc *.*)
  30.           - hit return or click-left on OK box to begin execution
  31.           - "press any key to continue" after completion
  32.  
  33.      History
  34.           ARC has been in use in the CP/M and MS-DOS world for many
  35.           years.  Thom Henderson developed the version which I
  36.           converted for use on the Atari ST.  I am not sure but he
  37.           may also be the original author.
  38.  
  39.           It is important to note that no matter who developed this
  40.           program, ARC is based on the file compression theories
  41.           developed by Huffman, Welch, Knott, Knuth, and many other
  42.           scientists.
  43.  
  44.      Bug Reports
  45.           Since I developed this version of ARC, I will be responsible
  46.           for any erroneous features.  Please relay any problems with
  47.           a written discription of what happened and the .ARC file
  48.           which caused the problem to:
  49.  
  50.                         Harvey Johnson
  51.                         2398 Oaklyn St NE
  52.                         Palm Bay, FL 32907
  53.  
  54.                              - or -
  55.  
  56.                       QUILL BBS 305-724-2303
  57.  
  58.  
  59.      Future Products
  60.           It would be nice to have a version of ARC written to utilize
  61.           GEM.  I would also like to write a picture display feature
  62.           that will show compressed pictures directly to the screen.
  63.           This will be useful in that ARC squeezes file 5 to 10% smaller
  64.           than TINY format.  If anyone has the C source to dump NEO,
  65.           Degas, or other pictures to the screen please upload a copy
  66.           to QUILL BBS.
  67.  
  68.           If you have any ideas for additional capabilities, then send
  69.           them to me with a detailed explanation.  All thoughts are
  70.           welcome.
  71.  
  72.      Donations
  73.           It would be nice to be supported if you think that ARC
  74.           is any good.  Make no mistake, I did NOT write the original
  75.           version of ARC, but I have spent all my extra time for
  76.           two months making it a reality on the Atari ST.
  77.  
  78.           As I do recieve contributions, I will consider improvements
  79.           more seriously.  Any donations may be sent to address
  80.           specified in Bug Report section.
  81.  
  82.           Thank you one and all in advance for considering this
  83.           request, but if you are like me (lazy) then I don't
  84.           really expect to ever see a single dime.
  85.  
  86. ARCHIVE (ARC.TTP)
  87.  
  88.      Usage
  89.           arc {amdxelvth} <filename.ARC> [<filename> ...]
  90.  
  91.                a   = add files to archive
  92.                m   = move files to archive
  93.                d   = delete files in archive
  94.                x,e = extract files from archive
  95.                l   = list files in archive
  96.                v   = verbose listing of files in archive
  97.                t   = test archive integrity
  98.                h   = hold screen before returning to Desktop
  99.  
  100.      Description
  101.           This program is a general archive utility, and is
  102.           used to maintain an archive of files.  An "archive"
  103.           is a single file that combines many files, reducing
  104.           storage space and allowing multiple files to be
  105.           handled as one.
  106.      Switches
  107.  
  108.           a - add files to archive.  This switch will force update
  109.               or addition the indicated reguardless of creation
  110.               time and date.
  111.  
  112.           m - move files to archive.  Same as "a" switch except
  113.               that the files are deleted from the directory as
  114.               they are moved to the archive.
  115.  
  116.           d - delete files in archive.  The files are lost forever
  117.               and the archive is recompacted to remove the data
  118.               for these files.
  119.  
  120.           x,e - extract files from archive.  A copy of the files
  121.               in the archive are created in the current directory
  122.               in an uncompacted state.
  123.  
  124.           l - list files in archive.  Limited information listing
  125.               of files contained in an archive.  Displays only the
  126.               filename.
  127.  
  128.           v - verbose listing of files in archive.  Complete
  129.               information listing of files contained in an archive.
  130.               Displays the filename, original length, storage method,
  131.               storage factor (% savings), compacted size, date, time,
  132.               and CRC.
  133.  
  134.           t - test archive integrity.  Check the archive to make sure
  135.               it does not have any bad files contained.
  136.  
  137.           h - hold screen before returning to Desktop.  This switch
  138.               should be used whenever ARC is executed from the
  139.               Desktop, except in conjunction with file redirection.
  140.  
  141.      Examples when executed from GEM Desktop:
  142.  
  143.      ah FILES.ARC *.PRG      Creates a new archive file called FILES.ARC
  144.                              and puts all files ending in .PRG inside.
  145.  
  146.      xh FILES.ARC *.*        Extracts all files from FILES.ARC.
  147.      xh FILES.ARC            ""
  148.      xh FILES                ""
  149.  
  150.      xh FILES.ARC *.DOC      Extracts all files ending in .DOC.
  151.  
  152.      In each case, the 'h' holds the display instead of immediately returning
  153.      to the GEM Desktop so you can view filenames, messages, etc.
  154.      These are just to help you get started.  ARC seems to be the most 
  155.      reliable of the 'masher' programs and has the best overall size
  156.      reduction.
  157.  
  158. əəəəəəəəəəə