This is the port of GNU gdb 4.18 to DJGPP

Installing the binaries
=======================

Copy the archive gdb418b.zip to any location you want, let's
say to c:/tmp

NOTE: I use here only unix like forward slashes where they
are allowed. If I use here DOS-like backslashes, then they
must be used there.

Now change to your DJGPP root directory, let's say c:/djgpp.
Now you have to unzip the archive preserving the directory
structure. If you use PKUNZIP, then you have to specify the
-d switch.

Documentation
=============

Documentation about gdb and other related topics in this archive
is in INFO format and will be installed in the usual info directory.
If you have already installed DJGPP, then the top dir node
has already the entry for gdb. To add the info files to your INFO
directory (and also the gdb.inf file) go to your info/ directory in
the DJGPP tree and execute there the following commands (or paste them
from here to a batch file and execute it then):

install-info --section="The GNU debugger and related information" gdb.inf dir
install-info --section="The GNU debugger and related information" gdbint.inf dir
install-info --section="The GNU debugger and related information" bfd.inf dir
install-info --section="The GNU debugger and related information" stabs.inf dir
install-info --section="The GNU debugger and related information" standard.inf dir

or as an alternative edit the file dir.txi in the info/ directory of your
DJGPP tree by adding the following lines

The GNU debugger and related information
* Bfd: (bfd).                   The Binary File Descriptor library.
* Gdb: (gdb).                     The GNU debugger.
* Gdb-Internals: (gdbint).	The GNU debugger's internals.
* Stabs: (stabs).                 The "stabs" debugging information format.
* Standards: (standards).        GNU coding standards.


and the execute the command

makeinfo dir.txi

to rebuild the dir file from the dir.txi file.

New features
============

Read the NEWS files in gnu/gdb-4.18/... for any new features, which
are general for these programs.

DJGPP related new features are mostly now by supporting a new native
system in the gdb sources. Especially the floating registers are supported
now. This is mostly a new feature in the debugging routines of DJGPP 2.03
which is still in development.

The binaries in gdb41b.zip are built with the latest DJGPP 2.03 sources
gotten from the DJGPP cvs repository on DJ's site. I did this, because there
are many debugging related changes especially in libdbg.a which are improving
gdb a lot. But gdb can be build also from the original DJGPP 2.02 distribution
but then it will lose some functionallity.

DJGPP specific changes
======================

I have made many DJGPP specific changes, which were sent already to
the gdb-mainatiners and which are already applied in the CVS repository
there, but not yet in the finally gdb 4.18. I applied them here again together
with some small other changes. You can find the complete patches against the
original gdb 4.18 sources in the file patches.418.

Eli Zaretskii has mad also patches which were sent to the gdb-paches list.
Even when not all of them already applied in the gdb cvs repository, I applied
them to the DJGPP source archive so you will benefit of them. They are also
in the patches.418 file.


Installing the sources for gdb 4.18
===================================

The sources are already configured, so you will need only
to run

make

in the root source directory to build gdb.

To build gdb from the sources, you will need additionally
some other packages (the binaries) installed which are all
available for DJGPP in the v2gnu/ directory on simtelnet
or it`s mirrors.

  - GNU make
  - GNU fileutils
  - GNU find
  - GNU shellutils
  - GNU bash
  - GNU textutils
  - GNU awk
  - GNU sed

  - If you change the *.y files you will need also GNU bison

I have used all the newest versions, which were available when
I made the port. I don't know if other version will work.
And of course you need all the standard stuff installed to
be able to compile and link C programs.

Possible problems when compiling the sources
============================================

Since the makefiles and/or the configure scripts use sometimes ln -s
to make a symbolic link from one file to an other and the ln.exe for
DJGPP from the GNU fileutils does not ever the same like on unix, you
might try to make the same hack I did for the configure script. Copy
the program cp.exe to you current directory as ln.exe and add the current
directoy as your FIRST directory in the PATH variable as ABSOLUTE path and
then rerun the make command.

Installing the newly built gdb
==============================

'make install' will not do what you expect at least not on plain
DOS where no long filenames are available. Either install the
binaries/docs manually or look in the archive gdb418b.zip what
should be where installed.


If you have questions about the DJGPP related things of the binutils,
post your questions in comp.os.msdos.djgpp (or in last resort mail
me directly).

If you think you have found a general bug, please submit it to the
related GNU news group.

Happy debugging,

  Robert Hoehne <robert.hoehne@gmx.net>

