From 774e64915e730792ed52e57eadb8fb4a8f2cb8ab Mon Sep 17 00:00:00 2001
From: Akim Demaille <akim@epita.fr>
Date: Tue, 14 Nov 2000 10:00:25 +0000
Subject: [PATCH] * doc/autoconf.texi (autoconf Invocation): Explain `-W error'
 gives back traces.

---
 ChangeLog         |  5 +++++
 doc/autoconf.texi | 35 ++++++++++++++++++++++++++++++++++-
 man/autoscan.1    |  4 ++--
 tests/Makefile.in |  3 ++-
 4 files changed, 43 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 1b72fccb..925d89f6 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2000-11-14  Akim Demaille  <akim@epita.fr>
+
+	* doc/autoconf.texi (autoconf Invocation): Explain `-W error'
+	gives back traces.
+
 2000-11-11  Pavel Roskin  <proski@gnu.org>
 
 	* acfunctions.m4 (AC_CHECK_FUNCS): Add missing m4 quotes.
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 46520ecd..55145be4 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -1012,9 +1012,42 @@ autoconf --warnings=syntax,$WARNINGS,@var{categories}
 
 @noindent
 If you want to disable @command{autoconf}'s defaults and @code{WARNING}
-but enable the warnings about obsolete constructs, use @samp{-W
+but enable the warnings about obsolete constructs, use @option{-W
 none,obsolete}.
 
+@cindex Back trace
+@cindex Macro invocation stack
+@command{autoconf} displays a back trace for errors, but not for
+warnings; if you want them, just pass @option{-W error}.  For instance
+on this @file{configure.in}:
+
+@example
+AC_DEFUN([INNER],
+[AC_TRY_RUN([true])])
+
+AC_DEFUN([OUTTER],
+[INNER])
+
+AC_INIT
+OUTTER
+@end example
+
+@noindent
+you get:
+
+@example
+/tmp % ace -Wcross
+configure.in:8: warning: AC_TRY_RUN called without default to allow \
+cross compiling
+/tmp % ace -Wcross,error
+configure.in:8: error: AC_TRY_RUN called without default to allow \
+cross compiling
+acgeneral.m4:3044: AC_TRY_RUN is expanded from...
+configure.in:2: INNER is expanded from...
+configure.in:5: OUTTER is expanded from...
+configure.in:8: the top level
+@end example
+
 @item --trace=@var{macro}[:@var{format}]
 @itemx -t @var{macro}[:@var{format}]
 Do not create the @code{configure} script, but list the calls to
diff --git a/man/autoscan.1 b/man/autoscan.1
index 891c77fc..1787edbc 100644
--- a/man/autoscan.1
+++ b/man/autoscan.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.022.
-.TH AUTOSCAN "1" "October 2000" "GNU autoconf 2.49b" FSF
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.23.
+.TH AUTOSCAN "1" "November 2000" "GNU autoconf 2.49b" FSF
 .SH NAME
 autoscan \- Generate a preliminary configure.in
 .SH SYNOPSIS
diff --git a/tests/Makefile.in b/tests/Makefile.in
index 4a35440f..1607ac4e 100644
--- a/tests/Makefile.in
+++ b/tests/Makefile.in
@@ -83,7 +83,8 @@ CLEANFILES = debug-*.sh macro configure configure.in config.status
 DISTCLEANFILES = atconfig testsuite
 mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
 CONFIG_CLEAN_FILES =  atconfig
-DIST_COMMON =  README Makefile.am Makefile.in atconfig.in
+DIST_COMMON =  README Makefile.am Makefile.in atconfig.in configure \
+configure.in
 
 
 PACKAGE = @PACKAGE@