This is a port of GNU Textutils 1.22 to MSDOS/DJGPP.

Installation
============

Just unzip the binary distribution from the top DJGPP installation
directory, preserving the directory structure (use -d switch if you do
this with PKUNZIP).  If you aren't familiar with the package, read the
info docs.  If you run the programs from plain DOS (no Windows), you
will need to install a DPMI host.  A free DPMI host is available as
csdpmi3b.zip from the peer directory ../v2misc at the same place you
got Textutils.  Note that the man pages are not included in the binary
distribution, since they are no longer maintained by the GNU project;
use the Info documentation instead.  (If you need the man pages, they
are available in the man subdirectory of the source distribution.)


Features
========

The absolute majority of the DOS-specific changes for this package
take care of the text/binary file I/O issue.  Most (but not all) of
the ported programs do their I/O in binary mode, unless the input or
output is connected to the terminal device.  This ensures that
Unix-style text files (which don't have a CR character at the end of
each line) don't change while being processed by the utilities of this
package.  The only programs that do all I/O in text mode are those
which don't make sense in conjunction with binary files, like `sort'
and `pr'.  Some programs need to change their I/O mode when certain
options are given on the command line; for details, see the Info docs
of `cat' and `md5sum'.

The file DIFFS in the source distribution describes the changes
against the original package.

The GNU Gettext package is not supported yet in the ported version, so
don't expect the programs to talk to you in any language but English.


Required tools
==============

If you want to recompile the package, you will need the DJGPP
development environment (GCC, header files and the libraries) and
DJGPP ports of the following tools:

	- GNU Make 3.75 or later
	- Bash (or some other Unix-like shell)
	- GNU Sed
	- GNU Fileutils
	- GNU Textutils
	- GNU Sh-utils
	- GNU Grep (only if you need to run DJGPP\CONFIG.BAT)
	- GNU Diffutils (only if you run the test suite)
	- Perl (only if you need to change the test scripts)

These should be available from the DJGPP sites.  There are a few more
programs (such as `utod') invoked during the build process, but they
are all part of a standard DJGPP installation and should be already
installed on your system.

The package should be built with the latest port of Make 3.75.
Previous versions of Make ported to DJGPP didn't support Unix shells,
and the Makefiles for this package won't work without a Unix shell.

If you want to generate the formatted man pages, you will have to
invoke `cawf' or any other formatter to format them; `cawf' can be
found on SimTel mirrors (see the DJGPP FAQ list for the exact URL).


How to build
============

Unzip the distribution preserving the directory structure (use -d
switch if you do that with PKUNZIP).  The package is already
configured for DJGPP v2.01, so if you only want to compile it, just
call BUILD.BAT from the DJGPP subdirectory:

		djgpp\build

This edits a few files, then invokes Make.  When Make finishes, you
can install the package:

		make install

If you make a change in some of the programs, it is a good idea to run
the test suite, so you know you didn't break anything:

		make check

This will run for a while and should print PASSED for every program it
tests.  Note that the test suite needs 7 recursive invocations of
DJGPP programs at some points (5 recursive Make's and Bash + the
tested program on top of that), so some DPMI hosts, notably QDPMI,
might run out of free conventional memory.  CWSDPMI and Windows are
two DPMI hosts that should have no problems with running "make check".

If you build Textutils with DJGPP release other than 2.01, or if you
want to change the configuration options (e.g., use Rx instead of
Regex, or add the National Language Support), you will have to
reconfigure the package.  The CONFIG.BAT batch file in the DJGPP
subdirectory sets a few environment variables, then calls BASH to
run the configure script, so you should run CONFIG.BAT, then Make:

		djgpp\config
		make

The configure script run by CONFIG.BAT supports a few options (e.g.,
you could build the package with the GNU Rx library instead of the
default Regex).  Run "sh ./configure --help" to see all the options
recognized by the script.

		Enjoy,
				Eli Zaretskii <eliz@is.elta.co.il>
