Document top_srcdir substitution.

diff --git a/autoconf.texi b/autoconf.texi
index 9f4474a0c8c2ccfa2bb10aba7df32b1e24ed20cb..f1509600038246e2112677f53865a9e0833f6929 100644 (file)
--- a/autoconf.texi
+++ b/autoconf.texi
@@ -585,7 +585,7 @@ this macro first if it hasn't been called already.  It macro calls
 @maindex PROG_INSTALL
 Set @code{make} variable @code{INSTALL} to @samp{install -c} if
 @code{install} is found and is compatible with the BSD and GNU versions.
-Otherwise, set @code{INSTALL} to @samp{@var{srcdir}/install.sh -c} if that
+Otherwise, set @code{INSTALL} to @samp{@@top_srcdir@@/install.sh -c} if that
 script exists, or to @samp{cp} as a last resort.  Screens out the
 false matches @file{/etc/install}, @file{/usr/sbin/install}, and other
 instances of @code{install} known not to work.  Also sets the variable
@@ -2469,6 +2469,11 @@ The directory that contains the source code for that @file{Makefile}.
 @xref{Installation Prefixes}, for an alternate way to set this variable.
 @end defvar
 
+@defvar top_srcdir
+The top-level source code directory for the package.  In the top-level
+directory, this is the same as @code{srcdir}.
+@end defvar
+
 @defvar DEFS
 @samp{-D} options to pass to the C compiler.  If @code{AC_CONFIG_HEADER}
 is called, @code{configure} replaces @samp{@@DEFS@@} with

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 9f4474a0c8c2ccfa2bb10aba7df32b1e24ed20cb..f1509600038246e2112677f53865a9e0833f6929 100644 (file)
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -585,7 +585,7 @@ this macro first if it hasn't been called already.  It macro calls
 @maindex PROG_INSTALL
 Set @code{make} variable @code{INSTALL} to @samp{install -c} if
 @code{install} is found and is compatible with the BSD and GNU versions.
-Otherwise, set @code{INSTALL} to @samp{@var{srcdir}/install.sh -c} if that
+Otherwise, set @code{INSTALL} to @samp{@@top_srcdir@@/install.sh -c} if that
 script exists, or to @samp{cp} as a last resort.  Screens out the
 false matches @file{/etc/install}, @file{/usr/sbin/install}, and other
 instances of @code{install} known not to work.  Also sets the variable
@@ -2469,6 +2469,11 @@ The directory that contains the source code for that @file{Makefile}.
 @xref{Installation Prefixes}, for an alternate way to set this variable.
 @end defvar
 
+@defvar top_srcdir
+The top-level source code directory for the package.  In the top-level
+directory, this is the same as @code{srcdir}.
+@end defvar
+
 @defvar DEFS
 @samp{-D} options to pass to the C compiler.  If @code{AC_CONFIG_HEADER}
 is called, @code{configure} replaces @samp{@@DEFS@@} with