1 files changed, 57 insertions, 0 deletions
diff --git a/gdb/doc/gdb.install-m4 b/gdb/doc/gdb.install-m4
new file mode 100755
index 0000000..f3244d8
--- /dev/null
+++ b/gdb/doc/gdb.install-m4
@@ -0,0 +1,57 @@
+_dnl__								-*- Texinfo -*-
+_dnl__ Copyright (c) 1990 1991 Free Software Foundation, Inc.
+_dnl__ This file is part of the source for the GDB manual.
+_dnl__ $Id$
+@node Installing _GDBN__, Copying, Renamed Commands, Top
+@appendix Installing _GDBN__
+@cindex configuring _GDBN__
+@cindex installation
+
+The script @code{config.gdb} automates the process of preparing _GDBN__
+for installation; you can then use @code{make} to actually build it.
+The best way to build _GDBN__ is in a subdirectory that records the
+configuration options used; this gives you a clean way of building
+_GDBN__ binaries with several different configuration options.
+@code{config.gdb} doesn't depend on this---it's just a good habit.  For
+example, assuming the _GDBN__ source is in a directory called
+``@code{gdb-4.0}'': 
+
+@example
+cd gdb-4.0
+mkdir =sun3os4
+cd =sun3os4
+../config.gdb sun3os4
+make
+@end example
+
+@noindent
+will install _GDBN__ on a Sun 3 running SunOS 4.  
+
+@table @code
+@kindex config.gdb
+@item config.gdb @var{machine}
+@itemx config.gdb -srcdir=@var{dir} @var{machine}
+This is the most usual way of configuring _GDBN__; to debug programs running
+on the same machine as _GDBN__ itself.  If you wish to build the _GDBN__ binaries
+in a completely different directory from the sources, specify a path to
+the source directory using the @samp{-srcdir} option.
+
+@item config.gdb -host
+@cindex host environments
+Display a list of supported host environments for _GDBN__.
+
+@item config.gdb @var{host} @var{target}
+@itemx config.gdb -srcdir=@var{dir} @var{host} @var{target}
+@cindex cross-debugging
+_GDBN__ can also be used as a cross-debugger, running on a machine of one
+type while debugging a program running on a machine of another type.
+You configure it this way by specifying first the @var{host}, then the
+@var{target} environment on the @code{config.gdb} argument list; the
+@var{host} is where _GDBN__ runs, and the @var{target} is where your program
+runs. @xref{Remote}.  Again, you can use @samp{-srcdir} to specify a
+path to the _GDBN__ source.
+
+@item config.gdb -target
+@cindex target environments
+Display a list of supported target environments for _GDBN__.
+@end table