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