This is a DOS/DJGPP port of GNU Binutils 2.11.

Contents
========

* Installing the binary
* DJGPP port news
* Building from sources
* The BFD library
* Bug reports & Known problems

Installing the binary
=====================

Unzip the binary package with the option to preserve directories 
(the -d option in PKUNZIP, the -directories option in PKZIP 2.5 and above)
from the top of your DJGPP directory tree.

DJGPP port news
===============

Notable changes in the 2.11.2:

* Fixed a case where symbols with the same name were wrongly merged.
* Section symbols from discarded sections are also discarded.
* Linker script update for building libstdc++ v3.
* Linker script update for aligning DWARF2 sections.

Notable changes in 2.11:

* SSE2 instructions supported.
* DWARF2 debugging supported.
* Linker script update for libstdc++ v3.

Building from sources
=====================

You will need:

* bnu211s.zip
* Bash 2.03 or later.
* GCC compiler and existing Binutils.
* Make 3.78.1 or later.
* Sed 3.02 or later.
* Fileutils 3.16 or later.
* DJGPP v2.03 or later
* and possibly more packages
* bnu211t.zip is optional. It contains the testsuite which can't be
  run under DJGPP but can be in a cross environment.

1. Unzip the source archive with the option to preserve directories
(the -d option in the old PKUNZIP, the -directories option in newer
versions of PKZIP) from the top of your DJGPP directory tree. Install
the Bash binary and required utilities if you haven't already done so.

2. Run configure. Change to the directory 'gnu/binutils-2.10/djbuild' and
   run 'sh djconfig.sh [any additional parameters]'.

3. Run make. Then either 'make info' or 'make doc' depending on what types
   of documentation you want.

4. If the generated executables are built for DJGPP (the default when
   using DJGPP's tools, unless you used the '--target' option with
   configure), install the binaries and documentation by running
   'sh djinstall.sh'.

The DJGPP version of the Binutils 2.11 sources use the Automake CVS version
of 'ylwrap'. An updated version of the linker script from Binutils CVS is
used. bfd.dif contains a small patch used to zero the space between the
end of the section headers and the start of the .text section.

The BFD Library
===============

The BFD library -- along its associated libraries and header files --
provides a way for programs to manipulate object files using its API.
The BFD documentation and the binutils subdirectory in bnu211s.zip are your
best tools for learning how to use BFD.

Bug reports & Known Problems
============================

Please send DJGPP-specific bug reports to the newsgroup comp.os.msdos.djgpp
or to the e-mail gateway djgpp@delorie.com. All other bug reports should be
sent to binutils@sources.redhat.com . There are no known problems at
this time. If any are discovered, bnu211.README will be created to
document them.

The porter for this release is Mark E. <snowball3@bigfoot.com>.
