File modified from DJGPP port of GNU ed 0.2.

Please note that you will need LFN support to run the test suite.


This file explains how to build GNU Ed with DJGPP for MS-DOS/MS-Windows.


I.  Installing a binary release
    ---------------------------

    1. Unpack the binary distribution preserving directory structure
       (with PKUNZIP, use the -d switch).  On Windows 9x, use an unzip
       program which supports long file names.

    2. If you are unfamiliar with `ed', read the docs ("info ed").

    3. Read the "Known Bugs" section below.

    4. A restricted version of `ed' called `red' is also supplied
       (it's just a shell script that calls `ed', but some commands
       are disabled there; see the docs).


II. Building `ed' from sources
    --------------------------

    1. To rebuild `ed' without reconfiguring, you will only need the
       basic DJGPP development environment (djdev, gcc and Binutils)
       and a port of GNU Make 3.75 or later.  The sources are already
       configured for DJGPP, so all you need to do is unzip the
       distribution (see section I.1 above) and say "make".

    2. If you need to reconfigure `ed' (e.g., for another version of
       DJGPP), you will need the following additional tools:

         - Bash
	 - Sed
	 - Fileutils
	 - Textutils
	 - Sh-utils
	 - Grep

    3. To configure `ed', type this from the DOS prompt:

		    djgpp\config

       This runs the `configure' script after setting several
       environment variables and updating the script to run correctly
       on MS-DOS.  After that, say "make" to build the program.

       The configuration batch file supports building `ed' from a
       directory other than where the sources reside.  In that case,
       you need to specify the source directory path name as an
       argument to the batch file:

		     djgpp\config d:/src/gnu/ed-1.10

    4. To install the program say "make install".  For this to work,
       you will need the Bash port and `rm', `ln' and `install' from
       Fileutils.  If you don't have these, just copy the programs to
       the appropriate directory on your PATH.

    5. If you need to run the test suite say "make check".  You will
       need the port of Bash and other utilities listed above, plus
       `cmp' from Diffutils.  Note that all the pipe tests and the
       ASCII test will fail on MS-DOS; see "Known Bugs" below.


III. Known Bugs
     ----------

    1. Editing binary files is not supported.  This is why the ascii.d
       test fails on MS-DOS.

    2. When the input is from a pipe, `ed' will exit at the first
       error.  The original code only does that when the input is a
       regular file; otherwise, it returns to command mode and waits
       for more input.  However, since on MS-DOS pipes are simulated
       with temporary files, there is no way for `ed' to tell whether
       the input is redirected from a file or comes from a pipe.

       For this reason, all the pipe tests run by the test suite fail
       on MS-DOS: they include some erroneous command (on purpose),
       but rely on `ed' to save the file after that; however, `ed'
       bails out when the error happens and doesn't produce any
       output.

    3. Path names with backslashes are not supported, since `ed' uses a
       backslash as an escape character in file names.




       Send ed specific bug reports to <bug-ed@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>
