||------------------------------------------------------------------------||
||FArc - Find in ARChive                         FREEWARE (c) 1999 by PHaX||
||------------------------------------------------------------------------||
||http://surf.to/phax                                     phax@writeme.com||
||------------------------------------------------------------------------||

**********************
* 1. What is FArc??? *
**********************

  FArc is a small tool that searches files both in the file system and
  in archives. You simply give a filemask and FArc starts searching.

  This package should contain at least the following files:
    - FARC.EXE    - the DOS program
    - FARCW.EXE   - the Windows 95/98/NT program
    - FARC.TXT    - documentation
    - FARC.HIS    - history file
    - FILE_ID.DIZ - small BBS description file

  If you type
    FArc *.zip
  the program will search every file in the current directory and prints
  out every filename that matches - either as a file or in an archive.

  Lets suppose your directory looks like that:

||------------------------------------------------------------------------||

    FILE1.TXT      - is a dummy file
    FILE2.TXT      - is also a dummy file
    LETTER.DOC     - is a WinWord document
    OLD_LET.ARJ    - is an ARJ archive
    PETER.ZIP      - is an WinZIP archive

  OLD_LET.ARJ contains:
    JAN98\LETTERS.ZIP - letters of january 1998
    FEB98\LETTERS.ZIP - letters of february 1998
    MAR98\LETTERS.ZIP - letters of march 1998
    APR98\LETTERS.ZIP - letters of april 1998

  PETER.ZIP contains:
    program.exe
    gfx\gfx1.jpg
    gfx\gfx2.jpg

||------------------------------------------------------------------------||

  "FArc *.zip" would find:
    PETER.ZIP                       - it's a valid filename
    <old_let.arj> JAN98\LETTERS.ZIP - the filename "LETTERS.ZIP" matches
    <old_let.arj> FEB98\LETTERS.ZIP - the filename "LETTERS.ZIP" matches
    <old_let.arj> MAR98\LETTERS.ZIP - the filename "LETTERS.ZIP" matches
    <old_let.arj> APR98\LETTERS.ZIP - the filename "LETTERS.ZIP" matches

  "FArc ?E*.*" would find:
    LETTER.DOC                      - it's a valid filename
    PETER.ZIP                       - it's a valid filename
    <old_let.arj> JAN98\LETTERS.ZIP - the filename "LETTERS.ZIP" matches
    <old_let.arj> FEB98\LETTERS.ZIP - the filename "LETTERS.ZIP" matches
    <old_let.arj> MAR98\LETTERS.ZIP - the filename "LETTERS.ZIP" matches
    <old_let.arj> APR98\LETTERS.ZIP - the filename "LETTERS.ZIP" matches

  "FArc F*.*" would find:
    FILE1.TXT                       - it's a valid filename
    FILE2.TXT                       - it's a valid filename

  "FArc old*.zip" would find:
    nothing

  and so on...
  The pattern matching just works just as the "DIR" command.

***************************
* 2. Commandline switches *
***************************

   FArc supports the follwoing commandline switches:

   /?, /H   -  display a small help screen
   /Mn      -  stop after n macthing filenames
   /NA      -  do not scan archives
               if you use this switch, it's better to use DIR ;-)
   /NF      -  do not show matching filenames
   /P       -  pause after every 24 lines of output
   /S       -  search subdirectories too

********************************************
* 3. Which archives are supported by FArc? *
********************************************

  Currently FArc supports 55 different archive types.

  Here is the list of all archives supported by FArc:

||------------------------------------------------------------------------||
|| Archiver           Copyright by
||------------------------------------------------------------------------||
|| 777 0.04b1     -=- 1997-98 by Igor Pavlov
|| ACE 1.1        -=- 1997 by Marcel Lemke
|| AMG 2.2        -=- 1993 by Milen Georgiev
|| AR 1.1         -=- by Haruhiko Okumura
|| ARC > 6.00     -=- 1985-91 by System Enhancement Ass.
|| ARG 1.01      -=- 1994 by Igor Pavlov
|| ARHANGEL       -=- 1997-98 by George Lyapko
|| ARI > 2.15     -=- 1997 by A. Ratushnyak / RAO Inc.
|| ARJ > 2.41     -=- 1990-99 by ARJ Software Inc.
|| ARQ 3.2        -=- 1993-1997 by DC Micro Development
|| ARX 1.0        -=- 1994 by Michael A. Kosior
|| ASD 0.13       -=- 1996 by Topologi Software
|| BIX 1.00b2     -=- 1998 by Igor Pavlov
|| BOA 0.58       -=- 1997-98 by Ian Sutton
|| BS2 2.0        -=- 1992 by ???
|| BSA 2.00       -=- 1992-1994 by PTS Ltd.
|| Cabinet        -=- by Microsoft
|| CHZ 1.2        -=- 1990 by ???
|| Compress 5.0   -=- by Microsoft
|| DPA 1.1a       -=- by Dirk Paehl
|| DWC 5.10       -=- 1990 by Dean W. Cooper
|| ELI 5750       -=- 5750 by Jules Revsin
|| GZip 1.2.4     -=-   GNU public license
|| HA 0.999      -=- 1995 by Harri Hirvola
|| HAP 3.0        -=- 1992 by Hamarsoft
|| Hyper 2.5      -=- 1990 by Peter Sawatzki
|| Hyper 2.6      -=- 1992 by Peter Sawatzki
|| ICE 1.14       -=- 1988-89 by Yoshi
|| JRC 1.10       -=- 1992-95 by JAYAR Systems
|| LHA > 2.13     -=- 1988-92 by Haruyasu Yoshizaki
|| Limit 1.2      -=- 1994 by J. Y. Lim
|| Links LS       -=- by Access Software
|| MAR 1.0        -=- by Micrognosis
|| MSXIE 1.4      -=- 1995-97 by MercurySoft
|| PACK           -=- by IBM
|| PAK 2.51       -=- 1988-90 by NoGate Consulting
|| PHP 1.0        -=- 1997-98 by PHaX
|| PKZIP 2.04 g   -=- 1989-93 by PKWARE Inc.
|| ProPack 2.14   -=- 1991-92 by Rob Northen Computing
|| Q > 0.90       -=- 1993-95 by Cinematronics
|| QFC            -=- 1993-98 by George G. Lyapko
|| RAR > 1.50     -=- 1993-97 by Eugene Roshal
|| RAX 1.02       -=- 1998 by GeCAD srl
|| SQZ 1.08.3     -=- by Jonas I. Hammarberg
|| SWG            -=- by SoftWare Archival Group
|| Synetic        -=- by Synetic Software
|| TAR            -=-   GNU public license
|| UFA 0.00       -=- 1996 by Igor Pavlov
|| UFA 0.01/0.02  -=- 1996-97 by Igor Pavlov
|| UFA 0.03/0.04  -=- 1996-98 by Igor Pavlov
|| XLink 2.02     -=- 1994, 95 by J. E. Hoffmann
|| ZOO 2.10       -=-   GNU public license
|| ZPack 1.0      -=- 1992 by SpeedSOFT
|| "EX_"          -=- 1990-95 by Stirling Technologies
|| "LIB"          -=-   used with installSHIELD
||------------------------------------------------------------------------||

  And here are some archives that cannot be listed by FArc :(((

   Archiver           Copyright by
||------------------------------------------------------------------------||
|| AIN 2.21       -=- 1993-94 by Transas Marine (UK) Ltd.
|| AR7 1.2        -=- by Timothy R. Erickson
|| BZip 0.21      -=-   GNU public license
|| CrossePAC      -=- by Digital Strategies
|| ESP 1.92       -=- 1997 by GyikSoft
|| HPA            -=- 1997 by HPA
|| IMP 1.01       -=- 1998 Technelysium (sorry Szymon)
|| ISC            -=- 1990-97 by Stirling Technologies
|| JAR > 1.01     -=- by Robert Jung
|| PAR            -=- by Philipp Druyts
|| RKive 1.4      -=- 1996 by Malcolm Taylor
|| RKive 1.92     -=- 1996-97 by Malcolm Taylor
|| UC II 3.05     -=- 1991-95 by Ad Infinitum Software
|| YamazakiZipper -=- 1997-98 by Binary Technologies
||------------------------------------------------------------------------||

******************************************
* 4. How to get a newer version of FArc? *
******************************************

   - visit my homepage at http://surf.to/phax
   - write me an eMail to phax@writeme.com

********************
* 5. Known bugs :( *
********************

   - none ??

******************
* 6. Good ideas? *
******************

   Yes, very many, but they take time ...

**********
* 7. EOF *
**********
