home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1995 November / PCWK1195.iso / inne / podstawy / dos / mac / unsit.exe / UNSIT.DOC next >
Text File  |  1991-05-02  |  5KB  |  128 lines
  1.  
  2.             UNSIT -- StuffIt Archive File Disassembler
  3.             ------------------------------------------
  4.  
  5. INTRODUCTION:
  6.      UNSIT is a simple utility for PC users to extract files from a
  7. StuffIt file.  StuffIt files usually appear with the ".SIT" extension.
  8.  
  9.      StuffIt is a program for Macs similar to ARC for PCs.  It collects
  10. several files in a single file and also compresses the data using run
  11. length, Huffman, or LZW compression.  Unfortunately, this means Mac files
  12. are frequently inaccessible to PC users as they are now "stuffed" to save
  13. transmission costs and disk space.
  14.  
  15.      UNSIT does not handle PackIt archive files which usually appear with
  16. the ".PIT" extension.  An extract-only utility called UnPackIt is
  17. available for the PC.
  18.  
  19.      UNSIT does not handle Compactor archive files.  I'm not aware of a PC
  20. program to handle Compactor files.
  21.  
  22.      UNSIT does not handle any of the growing number of Self-Extracting
  23. Archive (SEA) formats.
  24.  
  25.  
  26. VERSION:
  27.      UNSIT Version 3.0    2 May 1991
  28.  
  29.  
  30. PURPOSE:
  31.      List files in and extract files from a StuffIt archive file on a PC.
  32.  
  33.  
  34. COMMAND OPTIONS:
  35.      unsit [l|v|x|e|xb|eb] StuffItFile[.SIT]
  36.  
  37.      l, v   = list directory of files
  38.      x, e   = extract all files with CR to CR LF translation  on  text
  39.               files
  40.      xb, eb = extract all files with no translation
  41.      t      = test archive integrity
  42.  
  43.      Mac files have two parts, the resource and data forks.  UNSIT can
  44. extract each fork as a separate file or as a single file with a MacBinary
  45. header.
  46.  
  47.      The  normal EXTRACT options, 'x' or 'e', will automatically convert
  48. Mac text files to PC text files.   The only difference appears to be Mac
  49. text file lines end with only a carriage return (CR) while PC text file
  50. lines end with carriage return (CR) and line feed (LF).
  51.  
  52.      If the translation causes any problems,  use the EXTRACT BINARY
  53. options, 'xb' or 'eb' to turn off the translation.  Non-text files are
  54. always extracted without translation.
  55.  
  56.  
  57. NOTICES:
  58.      (C) Copyright  1988, 1991 by Brian K. Uechi.  Portions of this
  59. program written and copyrighted by Raymond Lau.   You may copy and
  60. distribute this  program  freely,  provided  that it is distributed ONLY
  61. in its original, unmodified state.
  62.  
  63.      DISCLAIMER:   No warranty of any kind is made with regard to this
  64. program.  The Authors shall be not liable for errors contained herein or
  65. for incidental or consequential damages in connection with furnishing,
  66. performance, or use of this material.
  67.  
  68. Brian K. Uechi
  69. GEnie:  B.UECHI
  70. CompuServe:  72330,155
  71. Internet:  brian_u@verifone.com
  72.  
  73.  
  74. VERSION 3.0    2 May 1991
  75.      Add processing of Mac folders.  Folders are similar to directories
  76. on PCs.  Folders may contain files and (sub-)folders.  The lack of support
  77. for folders caused most of the reports of problems with older versions.
  78. The folder name is now appears before the file name.
  79.  
  80.  
  81. VERSION 2.4    10 Feb 1991
  82.      Added "t" option to test archive intergrity.  This is a fast way to
  83. check for corrupt or incomplete files.
  84.  
  85.      Fixed bug resulting in machine lockup when decompressing large files.
  86. If the decompressed file size was greater than about 2 Megabytes, various
  87. counters and buffers overflowed.
  88.  
  89.      Still no support for encrypted files.  However, encrypted files are
  90. flagged with a lowercase E before the compression type in the file
  91. directory display.  For example, "LZW" means LZW compression while "eLZW"
  92. means LZW compression but also encrypted.
  93.  
  94.  
  95. VERSION 2.3    23 Nov 1988
  96.      Earlier versions always assumed the archive file started with a
  97. MacBinary header.  This is not always true.  UNSIT refused to process
  98. these files.  This version can handle zero or more MacBinary headers on
  99. the archive file.
  100.  
  101.  
  102. VERSION 2.2    27 May 1988
  103.      Older versions reversed LZW and Huffman compression types on the file
  104. directory listing.  Decompression was always done correctly; problem only
  105. affects report.
  106.  
  107.  
  108. VERSION 2.0    26 Feb 1988
  109.      UNSIT 2.0 now has an option to add a MacBinary header.   Some DOS
  110. program require this header for proper operation.   An extracted file with
  111. the MacBinary header should now exactly match the file uploaded directly
  112. from a Mac.  A MacBinary header is added to Mac files when they are
  113. transmitted by almost all Mac terminal programs.  The header contains
  114. information from the Mac directory entry for that file such as file name,
  115. file type, and attribute flags.
  116.  
  117.      A Mac file with a MacBinary header contain a resource fork and a
  118. data fork, either of which may be empty.   Some DOS programs do not work
  119. correctly if the Mac file contains a non-empty resource fork so there is
  120. an option to extract just the data fork even if both forks are present in
  121. the SIT file.  It is also possible to extract both forks into a single
  122. file.
  123.  
  124.      No new option flags have been added.  You will have the option to
  125. put a MacBinary header or not when extracting each file.  This makes it
  126. easier to extract a binary data file with a header then extract a text
  127. file without a header in one pass through the Stuffit file.
  128.