
 ******    *****   ******
 **   **  **   **  **   **       unRAR utility version 1.01
 ******   *******  ******        ~~~~~~~~~~~~~~~~~~~~~~~~~~
 **   **  **   **  **   **         FREE portable version
 **   **  **   **  **   **         ~~~~~~~~~~~~~~~~~~~~~

    The unRAR utility is a freeware program, distributed with source 
    code and developed for extracting, testing and viewing the 
    contents of archives created with the RAR archiver, version 1.50 
    and above.  For the usage and distribution license please read the 
    file LICENSE.TXT.

    The unRAR utility is a minor part of the RAR archiver and contains
    RAR uncompression algorithm. UnRAR requires very small volume of
    memory to operate. THIS SOURCE CODE DIFFERS FROM THE DOS unRAR
    UTILITY, BECAUSE ALL OPTIMIZED ASM-ROUTINES PORTED IN C-CODE AND
    THERE ARE NO SWITCHES NOR HANDLING OLD ARCHIVE TYPE IMPLEMENTED.

    The unRAR utility does not depend upon the RAR environment 
    variable or the configuration file RAR.CFG, for default options. 

    The portable C source code of UNRAR contains files: 

            UNRAR.C       Main code and functionality
            UNPACK.C      Unpacking procedures
            UNRAR.H       Definitions

    You should uncomment one of initial strings in UNRAR.H to define
    the Operating System you are using (generic DOS, OS/2 and UNIX types
    are currently supported).

    Compile it using the Compact, Large or Huge memory model.

    You can define the optional macro SETFILETIME in UNRAR.H in order to
    allow UNRAR properly handle the time format of your operating media.
    The first argument of SETFILETIME is FILE *DestFile, and the second
    one - pointer to the DOS time structure. You can disable SETFILETIME
    by single ';' after the macro name.

    To build UNRAR executable you need to compile UNRAR.C module only.

    Usage:
            UNRAR <command> -<switches> <archive> <files...>

  Commands:

  e             Extract files to current directory
  l             List contents of archive
  t             Test archive files
  v             Verbosely list contents of archive
  x             Extract files with full path

---------------------------------------------------------------------------

This is my second port of the UnRar utility to the Amiga, based on UnRar
sources version 1.01 by Eugene Roshal. This version finally manages to convert
the time-date structure used by Unrar (and by Borland Turkish-C ) into an Amiga
compatible datestamp. To cut it short: now the date of the extracted files are
ok.

As version 1.01, this port of Unrar correctly handles error codes, so you can
use it in scripts or such enviromnents that relie on return codes for
determinig the outcome of a dos command (like Arexx). There's also an Amiga-Dos
compliant version string and three compiled versions, one for each processor
category (68000, 68020, 68040).
Protection bits are set to the default, because those of MS-Dog differs very
much from that of Amiga (h stands for 'hold', NOT hidden!).

Included in the package are:
- 3 versions of the executable (install the one that suit you best).
- the sources (slightly) modified to compile under GCC 2.7.0 Amiga.
- the original Unrar sources, instructions and legal stuff.

Installation: well, kinda complex.... copy the executable you want anywhere in
your search path (usually C:), and rename it to 'unrar'. :-))
BTW: unrar is pure, so you can make resident, if you want.

If you want to compile the sources, the commandline for GCC is:
gcc -O3 -m680x0 -resident -noixemul -o unrar.0x0 unrar.c
             ^                                ^
             |--------------------------------|
                             |
              You choose this (either 0,2 or 4)
.. and don't worry if GCC gives two warnigns about double 'define's, it's
ok.


Please: SEE THE ORIGINAL DOCUMENTATION FOR INSTRUCTION AND COPYRIGHT CONDITIONS.
(Anyway... it's freeware!)

Author of the Amiga port: Andrea Vallinotto 
FidoNet: 2:334/21.13  AmigaNet: 39:101/402.13
Internet : a.vallinotto@agora.stm.it

Mail me if you have any suggestions, ideas, etc. .

