home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / APPS / macutils.lzh / MACUTILS / UNSIT / unstuffit.1 < prev    next >
Text File  |  1995-09-17  |  3KB  |  91 lines
  1. .TH UNSTUFFIT L "December 1990"
  2. .UC
  3. .SH NAME
  4. unstuffit \- unpack a Stuffit archive file to CAP aufs files
  5. .SH SYNOPSIS
  6. .B unstuffit
  7. [
  8. .B \-rdulM
  9. ] [
  10. -vqfm
  11. ] file(s)
  12. .br
  13. .SH DESCRIPTION
  14. For the Stuffit archive(s) file listed, 
  15. .I unstuffit
  16. extracts the files in the archive into separate files.
  17. This makes it possible, for example, to separate a large StuffIt file
  18. into component files for selective downloading, rather than
  19. downloading the larger archive file just to extract a single, small
  20. file.  It also allows the use of StuffIt to compress a group of files
  21. into a single, smaller archive that can be uploaded to a Unix system
  22. for storage, printing, etc.
  23. .PP
  24. .I Unstuffit
  25. stores extracted files in CAP aufs format in the current directory, which
  26. must be a CAP aufs folder.
  27. Characters in the Mac file name that are
  28. illegal (or unwieldy, like spaces) are changed to underscores in the Unix file
  29. name.
  30. .PP
  31. StuffIt version 1.5 has the ability to archive a group of files and folders
  32. in such a way that the hierarchical relationship of the files and folders
  33. is maintained.
  34. .I Unstuffit
  35. version 1.5 can unpack files archived in this manner and place them in
  36. corresponding subdirectories, which it will create in CAP aufs folder format,  so as to maintain the hierarchy.  As an option,
  37. the hierarcy can be flattened out and all the files stored in the current
  38. directory.
  39. .PP
  40. .TP
  41. .B \-f
  42. For StuffIt files containing a "Hierarchy Maintained Folder" entry, extract the
  43. files into a "flat" organization (all in the current directory) rather than
  44. maintaining the hierarchy by creating new directories, etc.
  45. Default is to maintain the hierarchical folder organization.
  46. .TP
  47. .B \-l
  48. List the files in the archive but do not extract them.  The name, size,
  49. type, and creator of each file is listed.
  50. .TP
  51. .B \-m
  52. Assumes the input file in MacBinary format rather than aufs
  53. format and skips over the MacBinary header.
  54. .TP
  55. .B \-r
  56. Extract resources forks only.
  57. .TP
  58. .B \-d
  59. Extract data forks only.
  60. .TP
  61. .B \-q
  62. Query user before extracting files and folders.  If a "n" answer is given for
  63. a folder, none of the files or folders in that folder will be extracted.
  64. .TP
  65. .B \-v
  66. Verbose option.  Causes 
  67. .I unstuffit
  68. to list name, size, type, and creator of each file extracted.
  69. .SH BUGS
  70. The
  71. .I compress
  72. program has been observed to go into strange states when uncompressing a 
  73. damaged file.  Often it will get stuck writing out bogus data until the
  74. disk fills up.  Since 
  75. .I unstuffit
  76. sends data through 
  77. .I compress,
  78. the same problem could occur when extracting files from a damaged Stuffit
  79. archive.
  80. .SH FILES
  81. For archives that have been compressed with the Lempel-Ziv method, the 
  82. .I compress 
  83. program must be present on the system and in the search path since 
  84. .I unstuffit 
  85. uses it for the uncompressing.
  86. .I Compress
  87. is available from the comp.sources.unix archives.
  88. .SH AUTHOR
  89. Nigel Perry (np@doc.ic.ac.uk) based upon unsit by
  90. Allan G. Weber (weber@sipi.usc.edu).
  91.