home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / archivers / infozip / zip-readme < prev    next >
Text File  |  1995-03-30  |  6KB  |  142 lines
  1.                Acorn Risc OS Port of InfoZip's Zip v2.0j
  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. Zip 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. With the Acorn Desktop C compiler and linker, typing 'amu' in the
  60. main zip directory will compile the programs. If you used
  61. the Unzip$exts option to pull out the c code, then make sure you
  62. copy the makefile from the acorn directory to the main zip directory
  63. before attempting amu.
  64.  
  65. Acorn-specific usage instructions
  66. ---------------------------------
  67.  
  68. When adding files to a zipfile; to maintain FileCore compliance, all
  69. files named "file/ext" will be added to the archive as "file.ext".
  70. This presents no problem if you wish to use UnZip to unzip them on any
  71. other machine, as the files are correctly named. This also presents no
  72. problem if you use the accompanying UnZip we have ported, as the files
  73. are converted back to "file/ext" format. The only problem appears when 
  74. you use Spark to decompress the files, as a file called "file.ext" will
  75. be extracted as "file_ext", not what it was added as. You must be careful
  76. about this.
  77.  
  78. Case Specific. Depending on how you type the command, files will be added
  79. exactly as named; in this example:
  80. *zip new/zip newfile
  81. *zip new/zip NewFile
  82. *zip new/zip NEWFILE
  83. will create an archive containing 3 copies of the same Risc OS file 'newfile'
  84. canned 'newfile', 'NewFile' and 'NEWFILE'. Please be careful.
  85.  
  86. The Acorn port conserves file attributes, including filetype, so if you
  87. zip on an Acorn, and unzip on another Acorn, filetypes will be maintained
  88. precisely as if you used uncompressed files. If you de-archive on another
  89. machine (PC, Mac, Unix etc..), filetypes will be ignored, but the files
  90. will be identical despite this.
  91.  
  92. An additional feature went into this port to cope better with c-code
  93. and extensions. This allows the acorn files "c.foo" to be added to the
  94. archive as "foo/c", eventually appearing in the archive as "foo.c", allowing
  95. for better handling of c or c++ code. Example:
  96. *Set Zip$Opts "dir1:dir2:dir3"
  97. *zip new/zip dir1.file
  98. *zip new/zip dir2.help
  99. *zip new/zip dir3.textfile
  100. Creates a zipfile new/zip, with entries file.dir1, help.dir2, textfile.dir3.
  101. The usual settings for Zip$Opts are "h:o:s:c", allowing c code to be added
  102. to the archive in standard form.
  103.  
  104. Bugs
  105. ----
  106. Known  :
  107.         None.
  108. Unknown:
  109.         Please feel free to contact the authors regarding Acorn-specific
  110.         Bugs, at either of their email addresses, or the InfoZip-bugs
  111.         group using zip-bugs@wkuvx1.wku.edu.
  112.  
  113. Additions/Changes
  114. -----------------
  115.         Suggestions for alterations or additions are welcome, but if
  116.         they're concerned with things to do with the Acorn port
  117.         specifically, please email the authors directly. If, however,
  118.         there is something you'd like to see changed in the overall
  119.         InfoZip senario, or something you want added, then send it to
  120.         info-zip@wkuvx1.wku.edu
  121.         Although there is no specific copyright maintaining over this
  122.         port, we'd prefer it if you didn't release altered versions of
  123.         it, seeing as we have to answer all the questions when things
  124.         go wrong.
  125.  
  126. Contacting the Authors
  127. ----------------------
  128.  
  129.  
  130. Sergio Monesi                              Karl 'RiscMan' Davis
  131. Via Trento e Trieste 30                    PO BOX B23
  132. 20046 Biassono (MI)                        Boronia Park 2111
  133. Italy                                      AUSTRALIA
  134. ----------------------------               --------------------------------
  135. pel0015@cdc8g5.cdc.polimi.it               riscman@geko.com.au
  136. sergio@phantom.com                         http://www.geko.com.au/riscman/
  137. sergio@g386bsd.first.gmd.de                RiscMan@f510.n712.z3.fidonet.org
  138. B
  139. B
  140. B
  141.  
  142.