home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / utility / archiver / arc521e / readme < prev   
Text File  |  1991-11-01  |  5KB  |  106 lines
  1. Notes for ARC 5.21e                    October 31, 1991
  2.  
  3.     ARC 5.21 for Unix is currently at patch level 6. The code provided
  4. here has been used on 4.3 BSD based Unix systems and on the Atari ST. (The
  5. GNU C compiler, version 1.40, was used to make the ST version. It should
  6. still compile with Mark Williams C, but I haven't bothered to try it.) The
  7. current version is over twice as fast as previous releases, for all file
  8. compression and decompression operations. It also fixes longstanding bugs
  9. in the squash code and in the tmclock DST code.
  10.  
  11.     The Arcinfo file describes the ARC 5.xx directory format. The 6.xx
  12. format contains additional information that is not supported here.
  13.  
  14.     System V support in the shar file Sysvarcstuf was provided by Jon
  15. Zeeff, Janet Walz, and Rich Salz. You will probably also need the dirent
  16. directory library written by Doug Gwyn; this can be obtained from uunet or
  17. many other comp.sources.unix archive sites.
  18.  
  19.     The tmclock.c file was stolen from Jef Poskanzer's tws library,
  20. as distributed in PHOON, PHase of the mOON, and slightly hacked by me.
  21.  
  22.     The man page was originally from Leo Wilson, with updates by me.
  23.  
  24.          /                 Howard Chu
  25.    ___  /_ , ,_.     Jet Propulsion Laboratory
  26.        / /(_/(__     hyc@hanauma.jpl.nasa.gov
  27.            /
  28.  
  29. Notes for ARC 5.21                                        June 6, 1988
  30.  
  31. This program is based on the MSDOS ARC program, version 5.21, plus
  32. a few enhancements... 
  33.  
  34.  o ARC also performs Huffman Squeezing on data. The Huffman Squeeze
  35.    algorithm was removed from MSDOS ARC after version 5.12. It turns
  36.    out to be more efficient than Lempel-Ziv style compression when
  37.    compressing graphic images. Squeeze analysis is always done now,
  38.    and the best of packing, squeezing, or crunching is used.
  39.  
  40.  o Compresses and extracts Squashed files. "Squashing" was created
  41.    by Phil Katz in his PKxxx series of ARC utility programs for
  42.    MSDOS. Dan Lanciani wrote the original modifications to ARC's
  43.    Crunch code to handle Squashing. I've made minor changes since
  44.    then, mostly to reduce the amount of memory required. The 'q'
  45.    option flag must be specified to Squash files. The Squashing
  46.    algorithm will be used instead of the usual Crunch algorithm,
  47.    and will be compared against packing and squeezing, as before.
  48.  
  49. System specific notes:
  50.  
  51.    On MTS, an additional option flag, 'i' for "image mode," was
  52. used. ARC assumes files are text, by default, and will translate
  53. MTS files from EBCDIC to ASCII before storing in an archive, and
  54. translates from ASCII to EBCDIC upon extraction. Specifying the
  55. 'i' flag will inhibit this translation. This would most commonly
  56. be used when shipping binary images such as TeX DVI files, other
  57. .ARC files stored within an archive, etc... The 'r' (run) command
  58. is omitted. It just doesn't seem very useful. Also, ARC cannot
  59. restore MTS files with their original time stamps. (Maybe in a
  60. future release...)
  61.  
  62.    On Unix(tm) systems, the 'i' flag is also present. Unix ARC
  63. assumes a binary file, by default. Here the only translation
  64. involved is in end-of-line processing. When storing text files, ARC will
  65. change '\n' to '\r\n', and does the opposite when extracting files.
  66. Carriage returns in any other location are preserved when extracting.
  67. This translation only occurs if the 'i' flag is given.
  68.  
  69.    On the Atari ST, the 'h' (for "hold screen") option is present,
  70. which simply delays exiting the program. This is typically used when
  71. executing ARC from the desktop, to allow reading all of ARC's output
  72. before the screen is cleared and the desktop is redrawn. The program
  73. will prompt and wait for a keypress before exiting. Note that since
  74. there are no "options" for the MARC program, the "hold screen" option
  75. is always active for MARC.
  76.  
  77.    On both Unix and Atari systems, ARC & MARC will search for an
  78. environment variable named "ARCTEMP" or "TMPDIR." If present, any
  79. temporary files will be created in the specified directory. This is
  80. probably insignificant for Unix users, but can be handy on the Atari,
  81. in combination with a RAMdisk. Highly recommended for floppy users.
  82. (Unfortunately, you can only take advantage of this when running some
  83. form of command shell that allows setting environment variables. Thus,
  84. you won't see any speed gains when running from the desktop.)
  85.  
  86. That about covers things. The enclosed documentation is taken directly
  87. from the MSDOS distribution of ARC. Unless specified differently here,
  88. the programs behave indentically. Note that ARC521.DOC is identical to
  89. ARC520.DOC - the differences between the two versions are described in
  90. the file CHANGES.521.
  91.  
  92. Oh yeah - this program may be distributed freely so long as you don't
  93. modify it in any way. You may not charge for distributing it. (Don't
  94. feel bad, I can't charge for it either. }-) It'd be nice if you kept
  95. this and the other enclosed doc files with it when distributing, but
  96. I'm not going to make a fuss about it. Most people are so familiar
  97. with the program by now that it wouldn't matter much anyway. You
  98. should keep this README file around, so bug reports & such will find
  99. their way back to me. (Bugs? What bugs? Nah, there aren't any bugs...)
  100.  
  101.          /                 Howard Chu
  102.    ___  /_ , ,_.     University of Michigan
  103.        / /(_/(__     hyc@umix.cc.umich.edu
  104.            /                umix!hyc
  105.           '     
  106.