91 lines
3.9 KiB
Groff
91 lines
3.9 KiB
Groff
.TH GDB 1 "13 April 1987"
|
|
.UC 4
|
|
.SH NAME
|
|
gdb \- Project GNU's DeBugger
|
|
.SH SYNOPSIS
|
|
\fBgdb\fP [ \fBoptions\fP ] See documentation mentioned below.
|
|
.SH DESCRIPTION
|
|
\fIgdb\fP is a source level symbolic debugger for C programs, created by
|
|
Richard M. Stallman (rms) for the GNU Project, and distributed by the
|
|
Free Software Foundation. Eventually GNU (Gnu's Not Unix) will be a
|
|
complete replacement for Berkeley Unix, all of which everyone will be
|
|
able to use freely. See the \fIGNU Emacs\fP man page for pointers to more
|
|
information.
|
|
.PP
|
|
\fIgdb\fP has something of the flavor of \fIdbx\fP,
|
|
but has more features and power. It can also be used to debug o/s
|
|
kernels, but needs to be configured differently for that task.
|
|
.PP
|
|
Project GNU isn't using Unix man pages. Its style of complete
|
|
documentation can be found by:
|
|
.PP
|
|
The help and info commands inside \fIgdb\fP.
|
|
.PP
|
|
In the Info system in \fIGNU Emacs\fP. Type C-h i, and follow the
|
|
directions. This is equivalent to the reference manual for
|
|
\fIgdb\fP, and has about 55 pages of text.
|
|
.PP
|
|
\fIgdb\fP could be extended to work with other languages (e.g. Pascal) and
|
|
machines (e.g. encores). If you like, copy the sources and give it a
|
|
try. When you have it working send \fIdiff -c\fP's of the changed files to
|
|
bug-gdb@prep.ai.mit.edu (fuller details below), so they can benefit everyone.
|
|
.SH DISTRIBUTION
|
|
\fIgdb\fP is free; anyone may redistribute copies of
|
|
\fIgdb\fP to anyone under the terms stated in the
|
|
\fIgdb\fP General Public License, a copy of which accompanies each copy of
|
|
\fIgdb\fP, is readable with the info command inside \fIgdb\fP,
|
|
and which also appears in the \fIgdb\fP reference manual.
|
|
.PP
|
|
Copies of \fIgdb\fP may sometimes be received packaged with
|
|
distributions of Unix systems, but it is never included in the scope
|
|
of any license covering those systems. Such inclusion would violate
|
|
the terms on which distribution is permitted. In fact, the primary
|
|
purpose of the General Public License is to prohibit anyone from
|
|
attaching any other restrictions to redistribution of \fIgdb\fP.
|
|
.PP
|
|
You can order printed copies of the \fIgdb\fP reference manual for $10.00/copy
|
|
postpaid from the Free Software Foundation, which develops GNU software
|
|
(contact them for quantity prices on the manual). Their address is:
|
|
.nf
|
|
Free Software Foundation
|
|
1000 Mass Ave.
|
|
Cambridge, MA 02138
|
|
.fi
|
|
As with all software and publications from FSF, everyone is permitted to
|
|
make and distribute copies of the \fIgdb\fP reference manual.
|
|
The TeX source to the \fIgdb\fP reference
|
|
manual is also included in the \fIGNU Emacs\fP source distribution.
|
|
.PP
|
|
.SH OPTIONS
|
|
See documentation.
|
|
.SH EXAMPLES
|
|
See documentation.
|
|
.SH "SEE ALSO"
|
|
adb(1), sdb(1), dbx(1)
|
|
.SH BUGS
|
|
There is a mailing list, bug-gdb@prep.ai.mit.edu on the internet
|
|
(ucbvax!prep.ai.mit.edu!bug-gdb on UUCPnet), for reporting \fIgdb\fP
|
|
bugs and fixes. But before reporting something as a bug, please try
|
|
to be sure that it really is a bug, not a misunderstanding or a
|
|
deliberate feature. We ask you to read the section ``Reporting Emacs
|
|
Bugs'' near the end of the \fIGNU Emacs\fP reference manual
|
|
(or Info system) for hints
|
|
on how and when to report bugs. Also, include the version number of
|
|
the \fIgdb\fP you are running in \fIevery\fR bug report that you send in.
|
|
.PP
|
|
Do not expect a personal answer to a bug report. The purpose of reporting
|
|
bugs is to get them fixed for everyone in the next release, if possible.
|
|
For personal assistance, look in the SERVICE file
|
|
(see the \fIGNU Emacs\fP man page) for
|
|
a list of people who offer it.
|
|
.PP
|
|
Please do not send anything but bug reports to this mailing list.
|
|
Send other stuff to gnu@prep.ai.mit.edu (or the
|
|
corresponding UUCP address). For more information about GNU mailing
|
|
lists, see the file MAILINGLISTS (see the \fIGNU Emacs\fP man page). Bugs tend
|
|
actually to be fixed if they can be isolated, so it is in your
|
|
interest to report them in such a way that they can be easily
|
|
reproduced.
|
|
.PP
|
|
No bugs are known at this time.
|
|
|