This is a port of GNU Gperf 2.7.2 to MSDOS/DJGPP.

1.:     DJGPP specific changes.
        =======================

        There are no DJGPP specific changes to the sources at all.
        Only a couple of testsuit files need a minor change to get the testsuit
        working under Win9X/MSDOS. The changes are performed by tscript.sed.
        I have only added the usual DJGPP subdirectory, that contains the batch
        file and sed scripts needed to configure, compile and test the package.


2.:     Installing the binary package.
        ==============================

2.1.:   Copy the binary distribution into the top DJGPP installation
        directory. Unzip the binary distribution running *ONE* of the
        following commands:
          unzip32 gprf272b.zip      or
          djtarx gprf272b.zip       or
          pkunzip -d gprf272b.zip

2.2.:   To create an entry for the gperf info docs in your dir file
        run from the top DJGPP installation directory the command:
          install-info --info-dir=./info ./info/gperf.info


3.:     Building the binaries from sources.
        ===================================

3.1.:   To build the binaries you will need the following binary packages:
          djdev203.zip (NOT a prior version)
          bsh203b.zip  (NOT a prior version)
          gcc2952b.zip, gpp2952b.zip, lgp2952b.zip,
          bnu2951b.zip, mak3791b.zip, fil316b.zip,
          shl112b.zip, txt20b.zip, txi40b.zip,
          grep24b.zip, sed302b.zip and diff272b.zip

        All this packages can be found in the v2gnu directory of any
        Simtel.NET mirror.
        You will need bsh203b.zip and *NOT* a prior version or the build will
        fail. The same applies to djdev203.zip. You *MUST* use the updated
        version of fil316b.zip (date: 2000-05-30) and shl112b.zip (date: 2000-08-11).
        This updated versions have been recompiled with djdev203.zip and know
        about the "/dev/env" functionality introduced with djdev203.zip. All the
        other packages are the ones I have used to build the binaries from this
        sources. Previuos versions of this packages may do the job as well but
        I have not tested this.
        Please not that source code is almost completely written in C++,
        so you will need the C++ compiler, the C++ library and the C++ driver
        (gxx) included in the djdev203.zip package.

3.2.:   Create a temporary directory. Copy the source package: gprf272s.zip
        into the directory and unzip it runnig ONE of the following commands:
          unzip32 gprf272s.zip      or
          djtarx gprf272s.zip       or
          pkunzip -d gprf272s.zip

3.3.:   This package is preconfigured for djdev203. The configuration batch
        file of this package, located in the djgpp subdirectory, allows you
        to compile from a different partition than from where the sources
        are located. config.bat always configures the package for in-place
        compilation if no options are given.

        If for some reason you want to reconfigure the package, run the
        following commands from the top srcdir (gperf-2.72):
          - make distclean
          - djgpp\config

        Please note that you *MUST* use the "distclean" option or the config.cache
        file will *NOT* be deleted. In this case you are *NOT* reconfiguring
        because the configuration informations is read from the cache file
        instead of being newly computed.
        To build the programs in a directory other than where the sources
        are, you must add the parameter that specifies the source directory,
        e.g:
          x:\src\gnu\gperf-2.72\djgpp\config x:/src/gnu/gperf-2.72

        Lets assume you want to build the binaries in a directory placed on a 
        different drive (z:\build in this case) from where the sources are,
        then you will run the following commands:
          z:
          md \build
          cd \build
          x:\src\gnu\gperf-2.72\djgpp\config x:/src/gnu/gperf-2.72

        You *MUST* use forward slashes to specify the source directory.

        This batch file will set same environment variables, make MSDOS
        specific modifications to the Makefile.ins and supply all other
        needed options to the configure script.


3.4.:   To compile the package run from the top srcdir the command:
          make

3.5.:   Now you can run the tests if you like. From the top srcdir run
        the command:
          make check

        Non test should fail.
        If the testsuit breaks because the lu2out.exe program dies
        with a SISEGV, then you have used an unzip program that "silently"
        transforms UNIX-style EOL into MSDOS-style EOL. This implies that
        the file lang-ucs2.in have been broken. This is a **binary** file that
        should not be modified. In this case unzip the sources again, this
        time using djtar.exe, in some temporary directory an replace the
        broken lang-ucs2.in with the new one.

3.6.:   To install the binaries, the info docs and the man pages run the
        following command from the top srcdir:
          make install

        This will install the products into your DJGPP installation tree given
        by the default prefix "/dev/env/DJDIR". If you prefer to install them
        into some other directory you will have to set prefix to the appropiate
        value.
        Example:
          make install prefix=z:/some/other/dir



        Send gperf specific bug reports to <bug-gnu-utils@gnu.org>
        and to <gperf-bugs@lists.sourceforge.net>.
        Send suggestions and bug reports concerning the DJGPP port to
        comp.os.msdos.djgpp or <djgpp@delorie.com>.

Enjoy.

          Guerrero, Juan Manuel <st001906@hrz1.hrz.tu-darmstadt.de>
