This is a port of GNU Shelltool 2.0.8 to MSDOS/DJGPP.

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

        This port is partially based on previous port produced by Richard Dawe.
        The most important DJGPP specific changes are:
        - check for TEMP and TMP also, instead of checking only for TMPDIR and
          TEMPDIR.
        - if no one of them are set, default to the current working directory
          instead of defaulting to "/tmp".
        - do not use the string "shtool.tmp" as template for $tmpfile, use
          "shtl_tmp" instead.  This avoid illicit file names with multiple dots.
        - do not use the string ".shtool.$$" as template for $tmpdir, use "st$$"
          instead.  This avoid illicit file names with multiple dots.
        - use $pathsep instead of hard coded colon as path separator.
          If some path string or $PATH is passed as argument then it will be
          used to determinate the right path separator.  If neither of both is
          passed then $PATH_SEPARATOR will be checked and if defined it will be
          used to define the path separator, else it will default to ";".

        As usual, all the djgpp specific files (config.bat, diffs, readme files,
        etc.) are stored in the /djgpp subdir.

        To run the scripts you will need to install at least the following packages:
        textutils, fileutils, shellutils, grep, sed gawk, find, bzip2, gzip, perl
        and tar.


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

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

        For futher information about GNU Shelltool please read the man pages
        and the NEWS file.



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

3.1.:   To build the binaries you will need the following binary packages:
          djdev203.zip (patch level 2, see the djdev203.dsm)
          bsh204b.zip, gccNNNb.zip, bnuNNNb.zip, makNNNb.zip, filNNNb.zip,
          shlNNNb.zip, txtNNNb.zip, txiNNNb.zip, grepNNNb.zip, sedNNNb.zip
          and perlNNNb.zip.
        where NNN stands for the latest version of the packages.  All this
        packages can be found in the v2gnu directory of ftp.delorie.com and
        any mirror.

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

3.3.:   To build the scripts cd into the top srcdir (shtool-2.0-8) and run the
        following commands:
          make

        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\shtool-2.0-8\djgpp\config x:/src/gnu/shtool-2.0-8

        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\shtool-2.0-8\djgpp\config x:/src/gnu/shtool-2.0-8

        The order of the options and the srcdir option does not matter. You
        *MUST* use forward slashes to specify the source directory.

        The 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.:   The run the testsuite run the following command:
          make check
        All 19 tests must pass if you use DJGPP 2.04.  If you run DJGPP 2.03,
        test cases mkln and mkshadow will fail because symlinks are not supported.

3.6.:   To install the binary, info docs and 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 shell tool specific bug reports to <bug-shtool@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>
