home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / archivers / infozip / unzip-read < prev    next >
Text File  |  1995-03-30  |  6KB  |  153 lines
  1.                Acorn Risc OS Port of InfoZip's Unzip v5.13
  2.                -------------------------------------------
  3.  
  4.                                            by: Karl Davis and Sergio Monesi
  5.  
  6.  
  7. Introduction
  8. ------------
  9.  
  10. This is a command-line version of the InfoZip group's machine-independent
  11. UnZip program.
  12. Why use Zip - Spark is better? The Zip routines in this distribution
  13. are better than Spark in a number of ways:
  14. * Portability - the files produced are able to be de-archived on many
  15.   hundreds of computer platforms
  16. * Speed - the routines in Zip, especially deflate, produce a much better
  17.   compression over a wider variety of files than the ARC-procedures in
  18.   Spark.
  19. * Security - a Non-US distribution of this release will have, or can
  20.   have, a crypt routine, which is much more secure than that used in
  21.   Spark. This is in turn able to be read, with the correct pass phrase,
  22.   on the aforementioned hundreds of computer platforms.
  23.  
  24. Unfortunately, InfoZip is a CLI (Command Line Interpreter) program. You
  25. will have to learn how to type. Running it in a taskwindow will maintain
  26. multitasking, though.
  27.  
  28. Source
  29. ------
  30. Acorn Risc OS source files will appear as part of the normal infozip
  31. releases. Simply compiling them should suffice, as the machine type
  32. and details are noted on compilation, and the bits for unix, mac etc
  33. are not used.
  34.  
  35. Executables
  36. -----------
  37. Released versions of Zip and Unzip, with assorted utilities, will
  38. shortly appear as executables at:
  39. ftp://zonk.geko.com.au/pub/acorn/infozip/zip
  40. ftp://zonk.geko.com.au/pub/acorn/infozip/unzip
  41. with everything else in
  42. ftp://zonk.geko.com.au/pub/acorn/infozip/
  43. as zipfiles.
  44. BINARY TRANSFERRING these files to your Acorn (ftp, DOS discs, etc),
  45. filetyping as 'Absolute' and command-line running them should enable
  46. you to de-archive the remaining files, including the source files and
  47. other tools.
  48.  
  49. Compiling
  50. ---------
  51.  
  52. This release is able to be compiled with Acorn's Desktop C version 4
  53. and hopefully later versions.
  54.     [It has not been tested, but should also work with GNU GCC.]
  55. Before compiling, run the !RunMe1st obey file in the Acorn directory. It
  56. will move the files from the foo/c to the c.foo for the Acorn compiler.
  57.        ( Alternatively, if you already use InfoZip on your Acorn, )
  58.        (  see the specific usage instructions about Unzip$Exts    )
  59. Now read the "INSTALL" file for details on how to 'make' the executable.
  60.  
  61. Acorn-specific usage instructions
  62. ---------------------------------
  63.  
  64. As ZIP files can come from a variety of sources apart from Acorn machines,
  65. consideration had to be given to the handling of dot-extensions, a-la
  66. DOSFILE.TXT, unix-filename.tar.gz . What was decided that they would
  67. be extracted as DOSFILE/TXT and unix-filename/tar/gz, and then truncated
  68. to 10-characters, for FileCore compliance. This can quickly be altered
  69. for any new releases of FileCore that Acorn may make for longer filenames.
  70. Unfortunately, this means that you must be REALLY careful about
  71. extracting files from Zips. The files
  72.  
  73. crypt_dummy.c and crypt_dummy.h
  74.  
  75. will both be extracted as
  76.  
  77. crypt_dumm
  78.  
  79. Unzip will prompt you for confirmation of the over-writing of these files
  80. but you must be really careful unless you wish to loose files (eh?)
  81. Also, because unzip is a unix-ported program, the filenames are CASE
  82. SENSITIVE.
  83.  
  84. *unzip new/zip newfile
  85.  
  86. will extract 'newfile', but not 'NewFile', 'NEWFILE' or any other
  87. combinations. Anyway, you can use the -C option to force case insensitive
  88. filenames match.
  89.  
  90. The Acorn Unzip port has an additional feature to cope with the
  91. extraction of files containing 'c' code. As you may be aware, Acorn
  92. Desktop C requires all files called "foo.c" to be renamed to "c.foo",
  93. ie "foo" in a directory called "c".
  94.  
  95. To cope with this, a colon-separated environment variable has been
  96. set up called "Unzip$Exts". Any extensions found in this variable will
  97. be extracted to directories named after the extension, with the extension
  98. stripped. For example:
  99. *Set Unzip$Exts "c:h:o:s" will extract all the files called
  100.  'foo.c' to a directory called 'c'
  101. This can be used to include "c:h:o:s:txt" to pull all the text files
  102. out to a separate directory. It should be noted, though, that if the
  103. zip file was NOT created on an Acorn machine, the filetypes will ALL
  104. be 'Data', not text, however, having them in a separate directory may
  105. simplify the filetyping process.
  106.  
  107.  
  108. Future
  109. ------
  110.  
  111. This version of unzip uses a special message-passing function message().
  112. This is anticipated to provide more desktop-feedback in the future, with
  113. dialogue boxes appearing and dissapearing, hopefully leading to a
  114. completely desktop-compliant version in the near future.
  115.  
  116. + Semi-intelligent filetyping of files from non-Acorn formats.
  117.  
  118. Bugs
  119. ----
  120. Known  :
  121.         None.
  122. Unknown:
  123.         Please feel free to contact the authors regarding Acorn-specific
  124.         Bugs, at either of their email addresses, or the InfoZip-bugs
  125.         group using zip-bugs@wkuvx1.wku.edu.
  126.  
  127. Additions/Changes
  128. -----------------
  129.         Suggestions for alterations or additions are welcome, but if
  130.         they're concerned with things to do with the Acorn port
  131.         specifically, please email the authors directly. If, however,
  132.         there is something you'd like to see changed in the overall
  133.         InfoZip senario, or something you want added, then send it to
  134.         info-zip@wkuvx1.wku.edu
  135.         Although there is no specific copyright maintaining over this
  136.         port, we'd prefer it if you didn't release altered versions of
  137.         it, seeing as we have to answer all the questions when things
  138.         go wrong.
  139.  
  140. Contacting the Authors
  141. ----------------------
  142.  
  143.  
  144. Sergio Monesi                              Karl 'RiscMan' Davis
  145. Via Trento e Trieste 30                    PO BOX B23
  146. 20046 Biassono (MI)                        Boronia Park 2111
  147. Italy                                      AUSTRALIA
  148. ----------------------------               --------------------------------
  149. pel0015@cdc8g5.cdc.polimi.it               riscman@geko.com.au
  150. sergio@phantom.com                         http://www.geko.com.au/riscman/
  151. sergio@g386bsd.first.gmd.de                RiscMan@f510.n712.z3.fidonet.org
  152.  
  153.