    ____      ____            _
   /  _/___  / __/___  ____  (_)___
   / // __ \/ /_/ __ \/_  / / / __ \
 _/ // / / / __/ /_/ / / /_/ / /_/ / version 305
/___/_/ /_/_/  \____/ /___/_/ .___/
                           /_/      A front-end for the Info-Zip routines

I, Harriet Bazley, accept no credit (and likewise take no blame) for the performance of the zip/unzip procedures used by this program.   They are nothing to do with me whatsoever.   There may well be more recent versions available (current versions used by Infozip are UnZip 550 and Zip 23).

Hardware required: RISC-OS 31 or greater and enough free memory to run both a taskwindow and this program - at least 400k during the actual compression / decompression.  Sorry.

How to use:
----------
          Drag a zipfile to the iconbar icon and a window will be displayed showing its contents.   Drag the icon(s) out of this window into a Filer directory window in order to decompress and save the contents into that directory.   A taskwindow will appear, showing the progress so far.
          Drag any other type of file/directory/application to the iconbar icon and a standard savebox window will be displayed.   Drag the zipfile icon out of this window into a Filer directory window in order to compress and save your files into that directory.  A taskwindow will appear, showing the progress so far.
         Note that you can still use your desktop while a taskwindow is on screen - the computer doesn't 'lock up' - but DON'T close the taskwindow until it has finished!

More details:
------------
 Filetypes:
          Infozip ignores the filetype of files dragged to its icon.   Instead it performs a quick check (see "Technical details" below) to decide whether they are zipfiles or not.   This is necessary because files from a DOS source are not filetyped, and because many RISC OS files of type "Archive" (the type created by this program) are not archived by zip routines but by native RISC OS methods, and cannot be decompressed by this program.
          In its contents window, Infozip distinguishes only between directories, applications and files.   There is no way of reading the correct sprite for an application or the correct filetype of a file using the command-line interface (which is all this program actually does), so all applications use the default sprite and all files appear as untyped files.

 The zipfile contents window:
          Unlike the RISC OS FIler, only one contents window can be open at a time, so the pane at the top of the window displays the 'internal path' (in the zipfile's internal UNIX file format) of the currently-displayed directory.
          Double-clicking on a directory or application icon will 'open' that directory and display its contents in the window.   To go back up to the previous directory, click on the up arrow icon at the top left of the contents window, or select 'Open parent' from the menu.   ADJUST-clicking will open a Filer window showing the zipfile itself.
          Double-clicking on a file will decompress and Filer_Run it.   If you hold down SHIFT while double-clicking the file will instead be loaded into a text editor.
          Dragging an icon out of the window will decompress it.   Choosing 'Select all' from the menu allows you to drag out the entire contents of a directory at once.    Dragging any object - even another zipfile! - *into* the window will cause it to be added to the contents of the zipfile.   The display will be updated to reflect this.   Hold down SHIFT to move the object into the zipfile, i.e. to delete the original after zipping it.
          The 'Display' submenu allows you to sort the icons in the window by name order instead of by the order in which they were originally added to the zipfile.
          Selecting 'Delete' from the 'File "name"' submenu allows you to delete that object.   The entry 'Info' on this submenu displays a window giving information on the file's date and size.
          Selecting 'New directory' allows you to create a new empty directory within the zipfile.

 Options:
          "Convert text files to LF": Any text files (as opposed to machine code, graphics files, etc.) will be decompressed with RISC OS line endings rather than the CR+LF combination.   Text files will be reported as [text] while decompressing (unless you have "Quiet output" selected) - if you notice it getting one wrong, you can switch this option off.
          "Ignore directory structure": All the files within all the directories in the archive will be saved into the same output directory.   Note that this could cause you to exceed the old ADFS 77-file directory limit!
          "DOS names in lowercase":  In theory any files archived on a DOS-based computer should be translated into lowercase.   Uppercase filenames archived on a RISC OS machine are *not* affected.
          "Quiet output": the taskwindow will only open if there is an error, or if you are asked to confirm that you wish to overwrite a file (unless "Overwrite silently" is selected).
          "Only extract newer": files will only be extracted, overwriting existing files, if the datestamp of the archived version is more recent.   In addition, if you are extracting from the top level of the zipfile, you will be asked to confirm overwriting.
          If this option is off, archived files will automatically be extracted whether or not non-archived versions exist in the destination directory - be careful!
          "Zip images as single files": image files are no longer translated into directories when zipped.

The current option settings are saved when you click on 'Save' in the Configure window.

 The savebox:
          When this appears, drag the icon to a directory window to determine where the new zipfile will be created.

 The iconbar:
          If a zipfile catalogue is open, then clicking SELECT on the iconbar icon will bring it to the front of the window stack. Clicking ADJUST will allow you to create a new (empty) zipfile.   Clicking SHIFT-ADJUST will open the Configure window. The iconbar menu additionally provides access to the application manual.

  Self-extracting archives:
          Dragging an existing archive to the iconbar while holding down CONTROL allows you to convert it to a self-extracting archive which will decompress itself when double-clicked.  Note that the resulting archives will work on RISC-OS computers ONLY.
          Dragging a self-extracting archive to the iconbar while holding down CONTROL gives you the option to convert it back to a normal zipfile.

Possible causes of error
------------------------
"This file is already compressed":  There is no point trying to compress this file since the filetype indicates that it is already compressed.   The list of filetypes to be rejected is set in the !Boot file and can be edited.

"This archive is not a zip file":  Not all files of type &DDC are zip archives.   Sorry.

Infozip thinks my (uncompressed) file is an archive and opens a window full of non-existent files with silly names:   Your file happens to meet my (rather loose) zipfile detection criteria - sorry.   Try splitting up the 'P' and the 'K' if you can (see below under "Technical details"), or add it to the contents of another archive rather than trying to drag it to the iconbar on its own.

"zip warning: name not matched":  This error is almost invariably caused by problems in DOS/RISC-OS filename conversion.   Note in particular that RISC-OS filenames will cause trouble if they have more than one slash character "/" in them, i.e. 'Cash1/8/98'.   Try using the 'Select all' option from the top level of the archive, even if there is only one file in the archive.

"A previous copy of Infozip still seems to be running":  Trying to run two copies simultaneously is likely to cause both to crash, so you should normally click on Cancel!   However, if Infozip crashes really badly, or is quit via Alt-Break on a RISC-PC, it may get confused and believe that the crashed copy is still running - if this was the case you will need to click OK.

"Task still in progress":     This error usually occurs when you drag a selection of icons out of a Filer window into Infozip, rather than just one.   It can also occur if you try to <add> an object to the contents window while Infozip is still in the middle of compression/decompression.
   Unfortunately Infozip isn't capable of keeping track of more than one external task (in this case, a taskwindow) at a time.   If you want to zip a selection of files, the best way to do it is to put them all in one directory and to zip that.

Note that there is a non-fatal bug in the Info-ZIP zip routine under RISC OS 4 when zipping directly to RAMdisc which causes it to do so *twice*, resulting in an error for the second attempt.   I have reported this behaviour but have no great hopes of seeing it fixed in the near future.

Technical details:
------------------
  Infozip's 'type-checking' is extremely crude since I have no idea what the correct specification for a zipfile is!   It simply checks whether the two characters occurring 22 bytes before the end of a file are the letters "PK" or not, and assumes that any file without these letters is to be compressed and not decompressed.

  Infozip adds the !Infozip.Routines directory to <Run$Path> - this means that you can access the 'zip' and 'unzip' routines directly from the command line. If you already have a copy of the Info-ZIP routines (for instance in your library directory), these will override the copies inside !Infozip.

Copying, altering or borrowing from this program:
------------------------------------------------
        The desktop front-end program !Infozip is freeware.   Anybody may give it to as many other people as they like - and they may also improve it in any way they see fit, and may appropriate any good ideas they find therein for their own programs.

        Sources for the zip/unzip command-line routines used are available from Info-ZIP's home Website, http://www.info-zip.org/pub/infozip/ and many other sites - see the documentation in the !Infozip.Routines directory.   These routines are copyright Info-ZIP and modified versions should *not* be redistributed without contacting them first.  (Try Zip-Bugs@lists.wku.edu)