home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / starter- / usq120.doc < prev    next >
Encoding:
Text File  |  1985-12-02  |  2.6 KB  |  70 lines
  1.                                  USQ.COM
  2.  
  3.      USQ.COM is an assembler version of the standard Unsqueeze program,
  4. written in C.  The advantages of this version are MUCH faster execution, same
  5. syntax for operation (including multiple files and wildcards), and much
  6. smaller size (only 2k!).
  7.  
  8.      To use this program on files which have been compressed by SQ, simply
  9. type:
  10.  
  11. USQ filename
  12.  
  13.      Where filename is the full name and extension of the file you wish to
  14. decompress.
  15.  
  16.      You may also use the multiple file option, and you may also specify a
  17. different drive for the output files.  As well, you may just type:
  18.  
  19. USQ
  20.  
  21.      This will place you into a command line driven mode, indicated by a '*'
  22. on the screen.  All normal filename combinations will work now, but the disk
  23. drives will be reset before any operations are preformed.  This allows you to
  24. change disks without returning to CP/M.
  25.  
  26.      As mentioned earlier, this program will also accept wildcards.  You may
  27. wish to decompress, for example, all .AQM and all .DQC files on drive A, and
  28. put the destination files on drive C.  To do this, you would type:
  29.  
  30. USQ *.AQM *.DQC C:
  31.  
  32.  
  33. Possible errors:
  34.  
  35.      While unsqueezing, you may encounter some errors.  The most common will
  36. be BDOS errors of the bad sector nature.  Everyone knows how to handle these!
  37.  
  38.      Less common will be messages like "Illegal decode table size", which
  39. usually indicates that the file in question is not a squeezed file, but
  40. appears to be.  If a file is not a squeezed file, but is included in a
  41. wildcard specification (like *.*!), the file will not be altered, and the
  42. message "is not squeezed.  Ignored" will appear.
  43.  
  44.      A very uncommon error will be "Checksum error.".  This error indicates
  45. that the file does not match the original.  It is usually caused by either an
  46. undetected BDOS error, or possibly a file transmission error.  Try to obtain
  47. another copy of the file, and attempt the decompress again.
  48.  
  49. Differences between the C version and this one:
  50.  
  51.      None of the "-" switches operate in this version, as I have seen no call
  52. for them.  Directed I/O will not work, but using the command line mode, and a
  53. public domain package like "EX 1.21" will give you the same effect for input.
  54. Wildcards can usually solve the problem, though, since files that are not
  55. squeezed are ignored.
  56.  
  57. Disclaimer and Warning:
  58.  
  59.      While this program has been tested, no liablity will be assumed for its
  60. operation, or lack thereof.
  61.  
  62.      Feel free to use this for personal use, but if you wish to bundle it with
  63. other software, or sell it itself, please contact me for more information.
  64.  
  65. Dave Rand
  66. 10232-160 Street
  67. Edmonton, Alberta
  68. Canada
  69. T5P 3E9
  70.