From 442b8598adda68fd2debf06674e4d165cbf51c4b Mon Sep 17 00:00:00 2001 From: John Gilmore Date: Wed, 19 Feb 1992 23:42:09 +0000 Subject: [PATCH] * configure.texi: Explain better about .gdbinit and about the environment that configure.in sections run in. --- configure.texi | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/configure.texi b/configure.texi index 2b524fa8d38..e2cd436744c 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 -- 2.30.2