home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / utils / 00readme.txt < prev    next >
Text File  |  1994-07-27  |  6KB  |  119 lines
  1.  
  2.         .ARK   for files archived (same as MS-DOS "ARC").
  3.         .LBR   for library files.
  4.         .?Q?   for squeezed files (middle letter is a Q).
  5.         .?Z?   for crunched files (middle letter is a Z).
  6.  
  7.      A library is a group of files collected together into one file in
  8. such a way that the individual files may be recovered intact.  A library
  9. file can be identified by the "LBR" as the extent of the file name.  LU
  10. (Library Utility) is a CP/M utility used to maintain libraries of files.
  11. LU does not perform any compression.  Because of this, most people will
  12. squeeze or crunch files before adding them to a library if they want to
  13. save space.  If you want to remove the component files (members) from a
  14. LBR file, you should have a copy of LU310.COM, NULU152A.COM, or other
  15. LBR extractor utility.  (LU and NULU are 8080/8085/Z80 compatible.)
  16.  
  17.      Recently, popular CP/M Public Domain software files and information
  18. files are being distributed using ARCHIVE files.  Archive files are
  19. similar to library (LBR) files, in that they take a logical group of
  20. files and put them together in a single file.  The main difference, is
  21. that the members of the "ARC" or "ARK" file are automatically
  22. compressed.  The compression algorithm chosen is one of three which will
  23. produce the smallest file.
  24.  
  25.      Archive files have been available to the MS-DOS and PC-DOS areas,
  26. but, and been made useful in the CP/M environment with the introduction
  27. of the "UNARC" program.  The current version is 1.6, and is available
  28. with extensive documentation, and two executable COM files, a 8080/8085
  29. version and a Z80 version.  The Z80 version takes advantage of the
  30. expanded Z80 (and equivalent) instruction set for speed and size, and
  31. therefore is machine dependent.  There is also a modification overlay to
  32. adapt the program to non-standard CP/M 2.2 and 3.0 operating systems,
  33. such as CP/M68k and CP/M emulators.  Programs are available on many
  34. machines to process "ARC" files, the Atari ST, systems running the UNIX,
  35. systems running MS-DOS, and CP/M.
  36.  
  37.      ARK11.COM is the CP/M utility available to make an "ARK" file.
  38. Archive files may also be made in the MS-DOS/PC-DOS or UNIX environment.
  39. (ARKs made on other systems may produce different results as the CP/M
  40. ARK program -- UNARC16 is able to extract and decompress these files.)
  41. To avoid confusion on RCP/Ms that support both MS-DOS and CP/M callers,
  42. Archive files have a file extension of "ARK" for CP/M software and
  43. information files.
  44.  
  45.      Some files in the SIMTEL20 CP/M software libraries have been
  46. compressed, using one of the standard public domain utilities, to
  47. minimize download time and to save storage space.
  48.  
  49.      Files that have been compressed can be identified by the filetype
  50. (the last 3 letters of a filename after the ".") that signifies the
  51. compression.  These are:
  52.  
  53.         .?Q?   for Squeezed files (middle letter is a Q).
  54.         .?Z?   for Crunched files (middle letter is a Z).
  55.  
  56.      USQ120.COM is used to unsqueeze, or expand files that have a "Q" as
  57. the middle letter of the filetype.  Such files have been squeezed, or
  58. compressed with SQ111.COM or similar utility.  These programs use
  59. Huffman Encoding to reduce the size of the target file.  Depending on
  60. the distribution of data in a file it can be reduced in size by 30% to
  61. 60% by squeezing it.  If you download a file with a filetype indicating
  62. that it is squeezed, you will need USQ120.COM to expand it before you
  63. can use it.  There are other programs available, written in different
  64. languages and take advantage of special hardware, but USQ120 is
  65. 8080/8085/Z80 compatible.
  66.  
  67.      Other utilities are available that have the unsqueeze coding
  68. imbedded and function with squeezed or unsqueezed files.  There are
  69. programs that perform file maintenance functions (NSWP), bi-directional
  70. display utilities (BISHOW), and string search programs, (FYNDE and
  71. FINDU).  This method of compressing files has been used for some time
  72. now and programs to uncompress the files are available to several micro
  73. processors and main frame computers.
  74.  
  75.      CRUNCH uses the Lempel-Ziv-Welch (LZW) techniques to compress
  76. files. These "crunched" files are identified with a "Z" as the second
  77. character of file type.  This method is fast and offers compression
  78. ratios around 55%.  Highest compression is achieved with graphics data,
  79. values of 90% are typical, followed by text, with 50%, and COM files and
  80. other binary file of around 20%.  See CRUNCH24.LBR for the Z80 CRUNCH
  81. and UNCRunch programs.  See FCRNCH11.LBR for the 8080/8085 and V20
  82. CRUNCH and UNCRunch programs.
  83.  
  84.      Since this method of compression is relatively new, there are only
  85. a few utilities available that processes crunched files are "typer"
  86. utilities such as TYPELZW, TYPEQZ, LT, and QL which also type members of
  87. libraries and squeezed files.  If running a 8080/8085 processor, check
  88. the documentation to determine if the utility will only process files on
  89. systems using the Z80 processor.  PD1:<MSDOS.COMPRESS>UNCR233.ARC contains
  90. a program to uncrunch files in the MS-DOS/PC-DOS environment.
  91.  
  92.      MicroSoft BASIC programs are always saved as ASCII files.  (Saved
  93. with the ",A" operand.)  They may than be squeezed or crunched.  This
  94. has been done to allow them to be converted for use with other BASIC
  95. compilers without the need to convert them with MBASIC first.
  96.  
  97.      Some executable files have a file extension of "OBJ".  These are
  98. really "COM" files that have been renamed to "OBJ" to avoid execution on
  99. RCP/M systems.  Rename them back to "COM" for use them as commands on
  100. your system.
  101.  
  102.  
  103.      Below is a list of utilities in the CP/M software libraries that
  104. work with the above mentioned files.  For the current version, check the
  105. directory.
  106.  
  107. ARK11.ARK         ARK maker for Z80 systems
  108. FCRNCH11.COM      Uncruncher for 8080/8085 systems
  109. UNARC16.COM       Unarcer for Z80 processors
  110. UNARCA16.COM      Unarcer for 8080/8085 CP/M systems
  111. UNCR24.COM        Uncruncher for Z80 processors
  112. USQ120.COM        Unsqueezer for all CP/M systems
  113. NULU152A.COM      Library maintenance utility
  114.  
  115. Keith Petersen
  116. Maintainer of the MSDOS, MISC and CP/M archives at SIMTEL20 [192.88.110.20]
  117. Internet: w8sdz@TACOM-EMH1.Army.Mil     or       w8sdz@Vela.ACS.Oakland.Edu
  118. Uucp: uunet!umich!vela!w8sdz                          BITNET: w8sdz@OAKLAND
  119.