This is the mail archive of the
gdb-patches@sources.redhat.com
mailing list for the GDB project.
[patch/5.2] Update README
- From: Andrew Cagney <ac131313 at cygnus dot com>
- To: gdb-patches at sources dot redhat dot com
- Date: Thu, 25 Apr 2002 19:24:17 -0400
- Subject: [patch/5.2] Update README
FYI,
I've committed the attached. Trunk and 5.2 branch.
Andrew
2002-04-25 Andrew Cagney <ac131313@redhat.com>
* README: Update to GDB 5.2.
Index: README
===================================================================
RCS file: /cvs/src/src/gdb/README,v
retrieving revision 1.17.2.1
diff -u -r1.17.2.1 README
--- README 7 Apr 2002 18:59:14 -0000 1.17.2.1
+++ README 25 Apr 2002 23:21:24 -0000
@@ -1,12 +1,12 @@
- README for gdb-5.1.1 release
- Updated 23 January, 2002 by Andrew Cagney
+ README for gdb-5.2 release
+ Updated 17 April, 2002 by Andrew Cagney
This is GDB, the GNU source-level debugger.
A summary of new features is in the file `gdb/NEWS'.
-The GDB home page at http://www.gnu.org/software/gdb/ for up to date
-release information, mailing list links and archives, etc.
+Check the GDB home page at http://www.gnu.org/software/gdb/ for up to
+date release information, mailing list links and archives, etc.
The file `gdb/PROBLEMS' contains information on problems identified
late in the release cycle. GDB's bug tracking data base at
@@ -20,7 +20,7 @@
In this release, the GDB debugger sources, the generic GNU include
files, the BFD ("binary file description") library, the readline
library, and other libraries all have directories of their own
-underneath the gdb-5.1.1 directory. The idea is that a variety of GNU
+underneath the gdb-5.2 directory. The idea is that a variety of GNU
tools can share a common copy of these things. Be aware of variation
over time--for example don't try to build gdb with a copy of bfd from
a release other than the gdb release (such as a binutils release),
@@ -29,8 +29,8 @@
directory tree and automatically build all the pieces in the right
order.
- When you unpack the gdb-5.1.1.tar.gz file, you'll find a directory
-called `gdb-5.1.1', which contains:
+ When you unpack the gdb-5.2.tar.gz file, you'll find a directory
+called `gdb-5.2', which contains:
COPYING config.sub intl missing opcodes
COPYING.LIB configure libiberty mkinstalldirs readline
@@ -44,7 +44,7 @@
You can build GDB right in the source directory:
- cd gdb-5.1.1
+ cd gdb-5.2
./configure
make
cp gdb/gdb /usr/local/bin/gdb (or wherever you want)
@@ -58,12 +58,12 @@
mkdir build
cd build
- <full path to your sources>/gdb-5.1.1/configure
+ <full path to your sources>/gdb-5.2/configure
make
cp gdb/gdb /usr/local/bin/gdb (or wherever you want)
(Building GDB with DJGPP tools for MS-DOS/MS-Windows is slightly
-different; see the file gdb-5.1.1/gdb/config/djgpp/README for details.)
+different; see the file gdb-5.2/gdb/config/djgpp/README for details.)
This will configure and build all the libraries as well as GDB. If
`configure' can't determine your system type, specify one as its
@@ -94,7 +94,7 @@
GDB includes an already formatted copy of the on-line Info version
of this manual in the `gdb/doc' subdirectory. The main Info file is
-`gdb-5.1.1/gdb/doc/gdb.info', and it refers to subordinate files
+`gdb-5.2/gdb/doc/gdb.info', and it refers to subordinate files
matching `gdb.info*' in the same directory. If necessary, you can
print out these files, or read them with any editor; but they are
easier to read using the `info' subsystem in GNU Emacs or the
@@ -106,7 +106,7 @@
`makeinfo'.
If you have `makeinfo' installed, and are in the top level GDB
-source directory (`gdb-5.1.1', in the case of version 5.1.1), you can make
+source directory (`gdb-5.2', in the case of version 5.2), you can make
the Info file by typing:
cd gdb/doc
@@ -115,7 +115,7 @@
If you want to typeset and print copies of this manual, you need
TeX, a program to print its DVI output files, and `texinfo.tex', the
Texinfo definitions file. This file is included in the GDB
-distribution, in the directory `gdb-5.1.1/texinfo'.
+distribution, in the directory `gdb-5.2/texinfo'.
TeX is a typesetting program; it does not print files directly, but
produces output files called DVI files. To print a typeset document,
@@ -129,11 +129,11 @@
This file tells TeX how to typeset a document written in Texinfo
format. On its own, TeX cannot read, much less typeset a Texinfo file.
`texinfo.tex' is distributed with GDB and is located in the
-`gdb-5.1.1/texinfo' directory.
+`gdb-5.2/texinfo' directory.
If you have TeX and a DVI printer program installed, you can typeset
and print this manual. First switch to the the `gdb' subdirectory of
-the main source directory (for example, to `gdb-5.1.1/gdb') and then type:
+the main source directory (for example, to `gdb-5.2/gdb') and then type:
make doc/gdb.dvi
@@ -156,55 +156,55 @@
a single directory, whose name is usually composed by appending the
version number to `gdb'.
- For example, the GDB version 5.1.1 distribution is in the `gdb-5.1.1'
+ For example, the GDB version 5.2 distribution is in the `gdb-5.2'
directory. That directory contains:
-`gdb-5.1.1/{COPYING,COPYING.LIB}'
+`gdb-5.2/{COPYING,COPYING.LIB}'
Standard GNU license files. Please read them.
-`gdb-5.1.1/bfd'
+`gdb-5.2/bfd'
source for the Binary File Descriptor library
-`gdb-5.1.1/config*'
+`gdb-5.2/config*'
script for configuring GDB, along with other support files
-`gdb-5.1.1/gdb'
+`gdb-5.2/gdb'
the source specific to GDB itself
-`gdb-5.1.1/include'
+`gdb-5.2/include'
GNU include files
-`gdb-5.1.1/libiberty'
+`gdb-5.2/libiberty'
source for the `-liberty' free software library
-`gdb-5.1.1/mmalloc'
+`gdb-5.2/mmalloc'
source for the GNU memory-mapped malloc package
-`gdb-5.1.1/opcodes'
+`gdb-5.2/opcodes'
source for the library of opcode tables and disassemblers
-`gdb-5.1.1/readline'
+`gdb-5.2/readline'
source for the GNU command-line interface
NOTE: The readline library is compiled for use by GDB, but will
not be installed on your system when "make install" is issued.
-`gdb-5.1.1/sim'
+`gdb-5.2/sim'
source for some simulators (ARM, D10V, SPARC, M32R, MIPS, PPC, V850, etc)
-`gdb-5.1.1/intl'
+`gdb-5.2/intl'
source for the GNU gettext library, for internationalization.
This is slightly modified from the standalone gettext
distribution you can get from GNU.
-`gdb-5.1.1/texinfo'
+`gdb-5.2/texinfo'
The `texinfo.tex' file, which you need in order to make a printed
manual using TeX.
-`gdb-5.1.1/etc'
+`gdb-5.2/etc'
Coding standards, useful files for editing GDB, and other
miscellanea.
-`gdb-5.1.1/utils'
+`gdb-5.2/utils'
A grab bag of random utilities.
Note: the following instructions are for building GDB on Unix or
@@ -213,14 +213,14 @@
The simplest way to configure and build GDB is to run `configure'
from the `gdb-VERSION-NUMBER' source directory, which in this example
-is the `gdb-5.1.1' directory.
+is the `gdb-5.2' directory.
First switch to the `gdb-VERSION-NUMBER' source directory if you are
not already in it; then run `configure'.
For example:
- cd gdb-5.1.1
+ cd gdb-5.2
./configure
make
@@ -236,8 +236,8 @@
sh configure
If you run `configure' from a directory that contains source
-directories for multiple libraries or programs, such as the `gdb-5.1.1'
-source directory for version 5.1.1, `configure' creates configuration
+directories for multiple libraries or programs, such as the `gdb-5.2'
+source directory for version 5.2, `configure' creates configuration
files for every directory level underneath (unless you tell it not to,
with the `--norecursion' option).
@@ -245,10 +245,10 @@
directories in the GDB distribution, if you only want to configure that
subdirectory; but be sure to specify a path to it.
- For example, with version 5.1.1, type the following to configure only
+ For example, with version 5.2, type the following to configure only
the `bfd' subdirectory:
- cd gdb-5.1.1/bfd
+ cd gdb-5.2/bfd
../configure
You can install `gdb' anywhere; it has no hardwired paths. However,
@@ -277,13 +277,13 @@
argument to `--srcdir', you can leave out the `--srcdir' option; it
will be assumed.)
- For example, with version 5.1.1, you can build GDB in a separate
+ For example, with version 5.2, you can build GDB in a separate
directory for a Sun 4 like this:
- cd gdb-5.1.1
+ cd gdb-5.2
mkdir ../gdb-sun4
cd ../gdb-sun4
- ../gdb-5.1.1/configure
+ ../gdb-5.2/configure
make
When `configure' builds a configuration using a remote source
@@ -304,8 +304,8 @@
The `Makefile' that `configure' generates in each source directory
also runs recursively. If you type `make' in a source directory such
-as `gdb-5.1.1' (or in a separate configured directory configured with
-`--srcdir=PATH/gdb-5.1.1'), you will build all the required libraries,
+as `gdb-5.2' (or in a separate configured directory configured with
+`--srcdir=PATH/gdb-5.2'), you will build all the required libraries,
and then build GDB.
When you have multiple hosts or targets configured in separate
@@ -348,7 +348,7 @@
Invalid configuration `i786v': machine `i786v' not recognized
`config.sub' is also distributed in the GDB source directory
-(`gdb-5.1.1', for version 5.1.1).
+(`gdb-5.2', for version 5.2).
`configure' options
@@ -496,7 +496,7 @@
address "bug-gdb@gnu.org".
When submitting a bug, please include the GDB version number (e.g.,
-gdb-5.1.1), and how you configured it (e.g., "sun4" or "mach386 host,
+gdb-5.2), and how you configured it (e.g., "sun4" or "mach386 host,
i586-intel-synopsys target"). Since GDB now supports so many
different configurations, it is important that you be precise about
this. If at all possible, you should include the actual banner that
@@ -551,17 +551,17 @@
Once DejaGNU is installed, you can run the tests in one of the
following ways:
- (1) cd gdb-5.1.1
+ (1) cd gdb-5.2
make check-gdb
or
- (2) cd gdb-5.1.1/gdb
+ (2) cd gdb-5.2/gdb
make check
or
- (3) cd gdb-5.1.1/gdb/testsuite
+ (3) cd gdb-5.2/gdb/testsuite
make site.exp (builds the site specific file)
runtest -tool gdb GDB=../gdb (or GDB=<somepath> as appropriate)