DJGPP port of automake 1.7.3, release 1
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Introduction
------------

This is the Readme file for the DJGPP port of automake 1.7.3. Please
see the file 'NEWS' for a full list of user-visible changes
from the previous versions. Please see 'changelog.dos' for a list
of bugs fixed in each release of the port.

To use the automake program, you only need to download
the binary distribution, which includes documentation in info format.
You may also wish to download the documentation distribution, to get
the documentation in HTML, PostScript and DVI formats. If you wish
to examine or rebuild the automake sources, you need to download
the source distribution.

The automake port is available here:

Binaries:
http://www.simtel.net/gnudlpage.php?product=/gnu/djgpp/v2gnu/amak173b.zip&name=amak173b.zip

Documentation:
http://www.simtel.net/gnudlpage.php?product=/gnu/djgpp/v2gnu/amak173d.zip&name=amak173d.zip

Sources:
http://www.simtel.net/gnudlpage.php?product=/gnu/djgpp/v2gnu/amak173s.zip&name=amak173s.zip

Installing the Binary Distribution of automake
----------------------------------------------

Unzip the distribution preserving the directory structure (use -d
switch if you do that with PKUNZIP) from the top DJGPP installation
directory.

automake will not work, if the following packages have not been installed:

. DJGPP development environment;
. GNU bash;
. Perl 5.6.1 dated later than September 2001;
. GNU fileutils;
. GNU textutils.

You should probably also install:

. GNU findutils;
. GNU autoconf.

To set up and read the info documentation, you will need to install
GNU texinfo. To add automake to the info directory page, run:

    install-info --info-file=/dev/env/DJDIR/info/automake.info \
        --info-dir=/dev/env/DJDIR/info

(Type this as one line.) Then run 'info automake', to read
the automake manual.

Installing the Documentation Distribution of automake
-----------------------------------------------------

If you want the automake documentation in a format other than info format,
then you need the documentation distribution. This contains documentation
in texinfo source, HTML, DVI (TeX) and PostScript. This documentation
will be installed in gnudocs\automake.173.

Rebuilding automake using the Source Distribution
-------------------------------------------------

To build the DJGPP port of automake from sources, I used the following
packages:

. DJGPP development environment 2.03 (v2/djdev203.zip);
. GNU C compiler 3.2.1 (v2gnu/gcc321b.zip);
. GNU binutils 2.13 (v2gnu/bnu213b.zip);
. GNU make 3.79.2 alpha 1 (but try v2gnu/mak3791b.zip);
. GNU bash 2.04 (v2gnu/bsh204b.zip);
. GNU m4 1.4 (v2gnu/m4-14b.zip);
. GNU sed 3.02.80 (v2gnu/sed3028b.zip);
. GNU awk 3.0.3 (v2gnu/gwk303b.zip);
. GNU diffutils 2.8 (v2gnu/dif28b.zip);
. GNU fileutils 4.1 release 4 (v2gnu/fil41b.zip);
. GNU sh-utils 2.0.11 (v2gnu/shl2011b.zip);
. GNU textutils 2.0 (v2gnu/txt20b.zip);
. GNU grep 2.4 (v2gnu/grep24b.zip);
. GNU texinfo 4.2 (v2gnu/txi42b.zip);
. Perl 5.6.1 (v2gnu/perl561b.zip);
. GNU autoconf 2.57, release 2 (v2gnu/acnf257b.zip).

Firstly, change into the top-level directory of the automake sources
(i.e. gnu\automake.173) and configure the package:

    bash djgpp\djconfig.sh

If you want to install automake somewhere other than the DJGPP directory,
modify djgpp\djconfig.sh to use configure's '--prefix' option
(use 'bash configure --help' for more information).

Then build the package:

    make

If you are interested in the test suite, please see the section entitled
"Expected test suite results" below. You should probably run
the test suite, before installing.

Once automake is built and the tests have passed as expected, install
the package:

    make install

Known Issues
------------

- The DESTDIR support in Makefiles generated by automake will not work
  unless you configure with prefixes that do not contain drive letters.
  If you wish to use a prefix like, say, c:/somepath, use /dev/c/somepath
  instead. You may also need to regenerate Makefile.in files with this
  version of automake, before the DESTDIR support works.

Expected test suite results
---------------------------

Run the test suite like so:

    bash djgpp/runtests.sh

The test suite takes a long time to run. (On my Athlon 850MHz with 640MB
of memory it took around one and a half hours to two hours.)

This will produce two output files in the top-level directory:
tests.log and tests.summ. tests.log contains the verbose output
of all the tests. tests.summ contains a PASS/XPASS/FAIL/XFAIL/SKIP line
per test.

If you wish to run an individual test, e.g. pr300-prog, you can
do this like so, assuming you are running bash:

    cd tests
    FNCASE=y VERBOSE=x make TESTS=pr300-prog.test check

You will need FNCASE=y for some tests, because they depend on the case
of files, e.g.: README. You may also wish to run multiple tests
and log the results:

    FNCASE=y VERBOSE=x redir -eo \
        make TESTS='pr300-prog.test man2.test' check > some.log

(Type this as one line.)

Finally
-------

Please direct any further discussions about this port
to comp.os.msdos.djgpp newsgroup (or write to its e-mail gateway
djgpp@delorie.com). I try to read the DJGPP newsgroup on a regular basis,
but also please feel free to contact me by e-mail (address below).

Regards,

Richard Dawe <rich@phekda.freeserve.co.uk> 2003-02-20
