aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJohn Gilmore <gnu@cygnus>1992-02-19 23:42:09 +0000
committerJohn Gilmore <gnu@cygnus>1992-02-19 23:42:09 +0000
commit442b8598adda68fd2debf06674e4d165cbf51c4b (patch)
tree934256bf71c6c1777773dcd58092a555f236c6fb
parent90d85bc42b2c6a71cb0b9da4db9c92648b965314 (diff)
downloadgdb-442b8598adda68fd2debf06674e4d165cbf51c4b.zip
gdb-442b8598adda68fd2debf06674e4d165cbf51c4b.tar.gz
gdb-442b8598adda68fd2debf06674e4d165cbf51c4b.tar.bz2
* configure.texi: Explain better about .gdbinit and about
the environment that configure.in sections run in.
-rw-r--r--configure.texi22
1 files changed, 13 insertions, 9 deletions
diff --git a/configure.texi b/configure.texi
index 2b524fa..e2cd436 100644
--- a/configure.texi
+++ b/configure.texi
@@ -145,11 +145,10 @@ output file. (See @ref{Makefiles, , , make, Makefiles}.)
@item Generate @file{.gdbinit}
If the source directory contains a @file{.gdbinit} file and the build
directory is not the same as the source directory, a @file{.gdbinit}
-file is created in the build directory. (see @ref{Command Files, , ,
-gdb, Command Files}.)
-@c There doesn't seem to be anything else about this. Is the build-dir
-@c .gdbinit identical with the source-dir one? If so should say "copy"
-@c rather than "create" to make it clear.
+file is created in the build directory. This @file{.gdbinit} file
+contains just a @code{source} command, which will cause the @file{.gdbinit}
+file from the source directory to be read by GDB. (see
+@ref{Command Files, , , gdb, Command Files}.)
@item Make symbolic links
Most directories have some symbolic links with generic names built
@@ -1006,10 +1005,15 @@ fragment.
A @file{configure.in} file for Cygnus configure consists of a
@dfn{per-invocation} section, followed by a @dfn{per-host} section,
followed by a @dfn{per-target} section, optionally followed by a
-@dfn{post-target} section. Each section is a shell script fragment sourced by
-configure at the appropriate time. The interface between configure and
-the shell fragments is through a set of shell variables. All sections
-are sourced in the build directory.
+@dfn{post-target} section. Each section is a shell script fragment,
+which is sourced by the configure shell script at an appropriate time.
+Values are passed among configure and the shell fragments through a
+set of shell variables. When each section is being interpreted
+(sourced) by the shell, the shell's current directory is the build
+directory, and any files created by the section (or referred to by the
+section) will be relative to the build directory. To reference files
+in other places (such as the source directory), prepend a shell
+variable such as @code{srcdir} to the desired file name.
@cindex Per-invocation section
The beginning of the @file{configure.in} file begins the per-invocation