GarboIDX v2.3:  Create a SimTel-compatible .IDX file for Garbo

Purpose:
  The program generates an index file for Garbo MsDos or Windows
  archive in a format compatible to SimTel's SIMIBM.IDX, so that
  it can be used by other programs to process, such as Schmidt's
  SIMDIR.

Usage:
  GarboIDX [ file-name ]

Input Files (ASCII):
  INDEX     - filenames and descriptions
  _dir.lst  - file sizes, dates

Output Files (ASCII):
  GARBO.IDX - SIMIBM.IDX format-compatible file
  file-name - optional list of inconsistent entries
              in INDEX and _dir.lst

Requirements:
  Lines in the input files must be terminated by MS-DOS
  end-of-lines (CR+LF).  You can find the properly formatted
  files at Garbo in /pc/INDEX.ZIP and /pc/_dir.zip, or
  /windows/WINDEX.ZIP and /windows/_dir.zip.

Disclaimer:
  This program is released to the public domain.  Use this
  program at your own risk.  The authors disclaim any
  responsibility for any consequences from using this program.

History:
  The version 2.0+ of this program is based on GarboIDX v1.0
  written by Gongquan Chen, Norman, Oklahoma, USA.  Thanks for
  his initial development of v1.0 and releasing the source to
  the public domain, and for his kind permission to declare
  this extended program as GarboIDX v2.

  The enhancements of v2.0 over v1.0:
  - improved matching of entries between INDEX and _dir.lst;
    it is now based on directory and file names as opposed
    to position-based matching in v1.0 that tended to fail
    with inconsistent input files
  - added search for entries that are inconsistent between
    INDEX and _dir.lst; such entries are displayed and
    optionally written to a file
  - improved handling of recent file dates

 v2.1 (June 1993 - not released to public):
  - added detection of the main directory, so that GarboIDX could
    be used for Garbo archives other than /pc
  - improved search for the next directory in INDEX
  - fixed reading file size from _dir.lst

 v2.2 (October 1993):
  - adapted to a slightly changed format of _dir.lst that caused
    GarboIDX to misinterpret directory names and fail

 v2.3 (February 1995):
  - the format of _dir.lst changed again; adapted

Authors' e-mail addresses:
  v1.0:  gchen@geohub.gcn.uoknor.edu or gchen@essex.ecn.uoknor.edu
  v2.0+: marko.bohanec@ijs.si

Marko Bohanec
Ljubljana, Slovenia
February 27, 1995
