This is a port of GNU Gperf 3.0.3 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 mostly 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 gprf303b.zip      or
          djtarx gprf303b.zip       or
          pkunzip -d gprf303b.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)
          bsh204b.zip  (NOT a prior version)
          gcc412b.zip, gpp412b.zip bnu217b.zip, mak3791b.zip,
          fil41b.zip, shl2011b.zip, txt20b.zip, txi48b.zip,
          grep24b.zip, sed415b.zip and diff287b.zip

        All this packages can be found in the v2gnu directory at ftp.delorie.com.
        Those packages are the ones I have used to build the binaries from this
        sources. Previuos versions of those packages (except for bash and djdev) may
        or may not do the job as well but I have not tested this. Later versions of
        all these packages will do the job as well.
        Please not that source code is almost completely written in C++,
        so you will need have installed the C++ compiler (gpp412b.zip).

3.2.:   Create a temporary directory. Copy the source package: gprf303s.zip
        into the directory and unzip it runnig ONE of the following commands:
          unzip32 gprf303s.zip      or
          djtarx gprf303s.zip       or
          pkunzip -d gprf303s.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.

3.4.:   If for some reason you want to reconfigure the package, change into the
        top srcdir (gperf-3.0-3), delete the config.cache file located in the
        djgpp subdir and run the following commands:
          make distclean
          djgpp\config

        Please note that you MUST delete the config.cache file or you will not
        be reconfiguring your package because the configuration informations
        will be 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-3.0-3\djgpp\config x:/src/gnu/gperf-3.0-3

        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-3.0-3\djgpp\config x:/src/gnu/gperf-3.0-3

        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-gperf@gnu.org>.
        Send suggestions and bug reports concerning the DJGPP port to
        comp.os.msdos.djgpp or <djgpp@delorie.com>.

Enjoy.

          Guerrero, Juan Manuel <juan.guerrero@gmx.de>
