                    ________________________________________
                  _/_                                      _\_
               __/__/  TDM-GCC Compiler Suite for Windows  \__\__
              | Ğ Ğ |            GDB 7.9 Series            | ğ ğ |
               ŻŻ\ŻŻ\         MinGW 32-bit Edition         /ŻŻ/ŻŻ
                  Ż\Ż                                      Ż/Ż
                    ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ

[[[ THIS IS THE README FOR THE 32-BIT GDB (DEBUGGER) DISTRIBUTION PROVIDED BY
[[[ TDM-GCC. PLEASE SEE THE FILE "README-GCC-TDM.TXT" FROM THE TDM32 CORE
[[[ PACKAGE FOR GENERAL NOTES ABOUT 32-BIT TDM-GCC.


This edition of GDB is a 32-bit native build for Windows hosts. It is designed
to debug 32-bit Windows (PE) binaries generated by GCC. It is tested with
TDM-GCC, but should also be able to debug binaries from other GCC toolchains
that target 32-bit Windows, without any issues.


REPORTING BUGS:
TDM-GCC's GDB packages incorporate wrapper executables and auto-executing
Python code to load libstdc++ pretty printers. If you encounter a bug relating
to one of these, please file a report according to the directions at:
    http://tdm-gcc.tdragon.net/bugs
Otherwise, bug reports should be directed to Sourceware:
    http://www.gnu.org/software/gdb/bugs/


/=-=- ------------ -=-=\
|=|   INSTALLATION   |=|
\=-=- ------------ -=-=/

-=- TDM/MINGW INSTALLER -=-

Using the TDM/MinGW installer is highly recommended; it can automatically
install TDM-GCC (or the official MinGW GCC) as well as all supplementary base
system packages. The installer uses a standard wizard interface with reasonable
defaults.

-=- MANUAL INSTALLATION -=-

Download the GDB archive (provided in .zip or .tar.lzma format) and unpack it to
the location of your choosing. It's recommended that you choose a path with no
spaces in the folder names. This GDB edition is designed to cooperate with
other executables in a standard GCC-on-Windows installation tree if desired.


/=-=- ------- -=-=\
|=|   SUPPORT   |=|
\=-=- ------- -=-=/

Support for GDB is primarily provided by the official GDB project:
    http://www.gnu.org/software/gdb/
However, for GDB on 64-bit Windows the MinGW-w64 project often has the direct,
specific knowledge needed to solve problems (particularly, the mailing list):
    http://mingw-w64.sourceforge.net/


/=-=- ----------- -=-=\
|=|   USAGE NOTES   |=|
\=-=- ----------- -=-=/

-=- WRAPPER EXECUTABLES -=-

Because a 64-bit GDB can't locally debug a 32-bit target program, and a
32-bit GDB can't locally debug a 64-bit target program, TDM now provides both a
32-bit and a 64-bit edition of GDB. Each edition comes with one or more wrapper
executables. This allows the differently-named wrappers to coexist in the
toolchain's normal "bin" directory, while keeping the actual GDB executables in
separate subdirectories.

* The 32-bit GDB wrapper is "bin/gdb32.exe", and the actual executable it wraps
  is "gdb32/bin/gdb32.exe".
* The 32-bit GDBSERVER wrapper is "bin/gdbserver32.exe", and the actual
  executable it wraps is "gdb32/bin/gdbserver32.exe".

* The 64-bit GDB wrappers are "bin/gdb.exe" and "bin/gdb64.exe", and the actual
  executable they wrap is "gdb64/bin/gdb.exe".
* The 64-bit GDBSERVER wrappers are "bin/gdbserver.exe" and
  "bin/gdbserver64.exe", and the actual executable they wrap is
  "gdb64/bin/gdbserver.exe".

Thus, the "default" GDB you get from running the toolchain bin directory's
gdb.exe is the 64-bit GDB. However, feel free to delete it and copy gdb32.exe as
gdb.exe instead, if you prefer 32-bit to be your default.

-=- BUNDLED PYTHON DISTRIBUTION -=-

In order to provide a python-enabled GDB (for the many integrations it offers
with integrated development environments), but alleviate the burden of forcing
every user to install Python on their own, the TDM GDB packages include a
Python installation. By default GDB will load with and use this bundled Python.

If you have a different Python installation that you would prefer TDM GDB to
use, you need to:
1) Set the %PYTHONHOME% environment variable to point to that installation,
2) Make sure the %PATH% environment variable includes that installation's Python
   DLL (often the DLL is installed to C:\Windows\System32, already in %PATH%),
   and
3) Rename or delete "python27.dll" from the gdb*/bin directory.

-=- PYTHON PRETTY-PRINTER AUTO-LOADING -=-

GCC provides a set of Python "pretty printers" for libstdc++ objects in GDB. TDM
GDB includes a Python script called "gdbinit" that automatically runs whenever
GDB starts -- this script searches for the most recent version of the libstdc++
pretty printers in the toolchain "share/gcc-*/python/libstdcxx/v6" path and, if
found, loads them for you.

If you would prefer not to auto-load the libstdc++ pretty printers, you can
rename or delete the gdbinit script file.


/=-=- ------------------ -=-=\
|=|   COMPONENT LICENSES   |=|
\=-=- ------------------ -=-=/

The GDB package is a binary distribution licensed under the GPLv3; see
"COPYING3-gdb-tdm.txt". It is additionally based on the Expat XML Parser, whose
license is available in "COPYING-expat.txt"; on the "winpthreads" compatibility
library, whose license is available in "COPYING.winpthreads.txt"; and finally it
includes a copy of the Python DLL and base libraries, licensed under the terms
in LICENSE-python.txt.
