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