Simplify the handling of `acconfig.h'.

* autoheader.sh: No longer try to select the needed paragraphs of
`acconfig.h', just dump everything into `config.h.in'.
Implement support for `--warnings'.
Warn the users that these auxiliary files are obsolete when `-W
obsolete'.
* doc/autoconf.texi (Invoking autoheader): Adjust.
This commit is contained in:
Akim Demaille 2000-05-03 11:22:50 +00:00
parent cc07253b22
commit 49ec438253
10 changed files with 258 additions and 190 deletions

View File

@ -1,3 +1,14 @@
2000-05-03 Akim Demaille <akim@epita.fr>
Simplify the handling of `acconfig.h'.
* autoheader.sh: No longer try to select the needed paragraphs of
`acconfig.h', just dump everything into `config.h.in'.
Implement support for `--warnings'.
Warn the users that these auxiliary files are obsolete when `-W
obsolete'.
* doc/autoconf.texi (Invoking autoheader): Adjust.
2000-05-03 Akim Demaille <akim@epita.fr>
Support of acconfig.h was broken. Fix and test.

View File

@ -42,7 +42,7 @@ Operation modes:
Warning categories include:
\`cross' cross compilation issues
\`obsolete' use of obsolete macros
\`obsolete' obsolete constructs
\`syntax' dubious syntactic constructs
\`all' all the warnings
\`error' warnings are error

View File

@ -42,7 +42,7 @@ Operation modes:
Warning categories include:
\`cross' cross compilation issues
\`obsolete' use of obsolete macros
\`obsolete' obsolete constructs
\`syntax' dubious syntactic constructs
\`all' all the warnings
\`error' warnings are error

View File

@ -32,13 +32,18 @@ Create a template file of C \`#define' statements for \`configure' to
use. To this end, scan TEMPLATE-FILE, or \`configure.in' if none
given.
-h, --help print this help, then exit
-V, --version print version number, then exit
-v, --verbose verbosely report processing
-d, --debug don't remove temporary files
-m, --macrodir=DIR directory storing Autoconf's macro files
-l, --localdir=DIR directory storing \`aclocal.m4' and \`acconfig.h'
-h, --help print this help, then exit
-V, --version print version number, then exit
-v, --verbose verbosely report processing
-d, --debug don't remove temporary files
-m, --macrodir=DIR directory storing Autoconf's macro files
-l, --localdir=DIR directory storing \`aclocal.m4' and \`acconfig.h'
-W, --warnings=CATEGORY report the warnings falling in CATEGORY
Warning categories include:
\`obsolete' obsolete constructs
\`all' all the warnings
\`error' warnings are error
Report bugs to <bug-autoconf@gnu.org>."
version="\
@ -62,21 +67,15 @@ if test "${LC_ALL+set}" = set; then LC_ALL=C; export LC_ALL; fi
if test "${LC_MESSAGES+set}" = set; then LC_MESSAGES=C; export LC_MESSAGES; fi
if test "${LC_CTYPE+set}" = set; then LC_CTYPE=C; export LC_CTYPE; fi
# ac_LF_and_DOT
# We use echo to avoid assuming a particular line-breaking character.
# The extra dot is to prevent the shell from consuming trailing
# line-breaks from the sub-command output. A line-break within
# single-quotes doesn't work because, if this script is created in a
# platform that uses two characters for line-breaks (e.g., DOS), tr
# would break.
ac_LF_and_DOT=`echo; echo .`
# Variables.
: ${AC_MACRODIR=@datadir@}
debug=false
localdir=.
tmp=
verbose=:
warning_all=false
warning_error=false
warning_obsolete=false
while test $# -gt 0 ; do
case "$1" in
@ -109,6 +108,18 @@ while test $# -gt 0 ; do
AC_MACRODIR=$1
shift ;;
--warnings | -W )
shift
test $# = 0 && { echo "$help" >&2; exit 1; }
warnings="$warnings "`echo $1 | sed -e 's/,/ /g'`
shift ;;
--warnings=* )
warnings="$warnings "`echo "$1" | sed -e 's/^[^=]*=//;s/,/ /g'`
shift ;;
-W* ) # People are used to -Wall, -Werror etc.
warnings="$warnings "`echo "$1" | sed -e 's/^-W//;s/,/ /g'`
shift ;;
-- ) # Stop option processing
shift; break ;;
- ) # Use stdin as input.
@ -123,6 +134,13 @@ while test $# -gt 0 ; do
esac
done
# Decode `$warnings'.
for i in :$warnings
do
test "$i" = : && continue
eval "warning_$i=:"
done
# Trap on 0 to stop playing with `rm'.
$debug ||
{
@ -144,6 +162,29 @@ $debug ||
exit 1;
}
# Preach.
if ($warning_all || $warning_obsolete) &&
(test -f $config_h.top ||
test -f $config_h.bot ||
test -f $localdir/acconfig.h); then
sed -e "s/^ //;s/^/$me: warning: /" >&2 <<\EOF
Using auxiliary files such as `acconfig.h', `config.h.bot'
and `config.h.top', to define templates for `config.h.in'
is deprecated and discouraged.
Using the third argument of `AC_DEFINE' and
`AC_DEFINE_UNQUOTED' allows to define a template without
`acconfig.h':
AC_DEFINE([NEED_MAIN], 1,
[Define if a function `main' is needed.])
More sophisticated templates can also be produced, see the
documentation.
EOF
$warning_error && exit 1
fi
acconfigs=
test -r $localdir/acconfig.h && acconfigs="$acconfigs $localdir/acconfig.h"
@ -197,55 +238,20 @@ case "$config_h" in
*) config_h_in="$config_h.in" ;;
esac
# Don't write "do not edit" -- it will get copied into the
# config.h, which it's ok to edit.
cat <<EOF >$tmp/config.hin
/* $config_h_in. Generated automatically from $infile by autoheader. */
EOF
test -r ${config_h}.top && cat ${config_h}.top >>$tmp/config.hin
# Dump the top.
test -r $config_h.top && cat $config_h.top >>$tmp/config.hin
# Dump `acconfig.h' but its bottom.
test -r $localdir/acconfig.h &&
grep @TOP@ $localdir/acconfig.h >/dev/null &&
sed '/@TOP@/,$d' $localdir/acconfig.h >>$tmp/config.hin
# This puts each template paragraph on its own line, separated by @s.
if test -n "$syms"; then
# Make sure the boundary of template files is also the boundary
# of the paragraph. Extra newlines don't hurt since they will
# be removed.
# Stuff outside of @TOP@ and @BOTTOM@ is ignored in all the acconfig.hs.
for t in $acconfigs; do
sedscript=""
grep @TOP@ $t >/dev/null && sedscript="1,/@TOP@/d;"
grep @BOTTOM@ $t >/dev/null && sedscript="$sedscript /@BOTTOM@/,\$d;"
# This substitution makes "#undef<TAB>FOO" in acconfig.h work.
sed -n -e "$sedscript s/ / /g; p" $t
echo; echo
done |
# The sed script is suboptimal because it has to take care of
# some broken seds (e.g. AIX) that remove '\n' from the
# pattern/hold space if the line is empty. (junio@twinsun.com).
sed -n -e '
/^[ ]*$/{
x
s/\n/@/g
p
s/.*/@/
x
}
H' | sed -e 's/@@*/@/g' |
# Select each paragraph that refers to a symbol we picked out above.
# Some fgrep's have limits on the number of lines that can be in the
# pattern on the command line, so use a temporary file containing the
# pattern.
(cat > $tmp/syms.fgrep <<EOF
$syms
EOF
fgrep -f $tmp/syms.fgrep) |
tr @. "$ac_LF_and_DOT" >>$tmp/config.hin
fi
sed -e '/@BOTTOM@/,$d' -e 's/@TOP@//' $localdir/acconfig.h >>$tmp/config.hin
# Dump the templates from `configure.in'.
for verb in `(set) 2>&1 | sed -n -e '/^ac_verbatim/s/^\([^=]*\)=.*$/\1/p'`; do
echo >>$tmp/config.hin
eval echo '"${'$verb'}"' >>$tmp/config.hin
@ -255,7 +261,7 @@ done
test -r $localdir/acconfig.h &&
grep @BOTTOM@ $localdir/acconfig.h >/dev/null &&
sed -n '/@BOTTOM@/,${/@BOTTOM@/!p;}' $localdir/acconfig.h >>$tmp/config.hin
test -f ${config_h}.bot && cat ${config_h}.bot >>$tmp/config.hin
test -f $config_h.bot && cat $config_h.bot >>$tmp/config.hin
# Check that all the symbols have a template.
@ -267,7 +273,7 @@ if test -n "$syms"; then
if egrep "^#$w*[a-z]*$w$w*$sym($w*|$w.*)$" $tmp/config.hin >/dev/null; then
: # All is well.
else
echo "$0: No template for symbol \`$sym'" >&2
echo "$me: No template for symbol \`$sym'" >&2
status=1
fi
done
@ -280,7 +286,7 @@ if test $status = 0; then
# Output is a file
if test -f $config_h_in && cmp -s $tmp/config.hin $config_h_in; then
# File didn't change, so don't update its mod time.
echo "$0: $config_h_in is unchanged" >&2
echo "$me: $config_h_in is unchanged" >&2
else
mv -f $tmp/config.hin $config_h_in
fi

View File

@ -32,13 +32,18 @@ Create a template file of C \`#define' statements for \`configure' to
use. To this end, scan TEMPLATE-FILE, or \`configure.in' if none
given.
-h, --help print this help, then exit
-V, --version print version number, then exit
-v, --verbose verbosely report processing
-d, --debug don't remove temporary files
-m, --macrodir=DIR directory storing Autoconf's macro files
-l, --localdir=DIR directory storing \`aclocal.m4' and \`acconfig.h'
-h, --help print this help, then exit
-V, --version print version number, then exit
-v, --verbose verbosely report processing
-d, --debug don't remove temporary files
-m, --macrodir=DIR directory storing Autoconf's macro files
-l, --localdir=DIR directory storing \`aclocal.m4' and \`acconfig.h'
-W, --warnings=CATEGORY report the warnings falling in CATEGORY
Warning categories include:
\`obsolete' obsolete constructs
\`all' all the warnings
\`error' warnings are error
Report bugs to <bug-autoconf@gnu.org>."
version="\
@ -62,21 +67,15 @@ if test "${LC_ALL+set}" = set; then LC_ALL=C; export LC_ALL; fi
if test "${LC_MESSAGES+set}" = set; then LC_MESSAGES=C; export LC_MESSAGES; fi
if test "${LC_CTYPE+set}" = set; then LC_CTYPE=C; export LC_CTYPE; fi
# ac_LF_and_DOT
# We use echo to avoid assuming a particular line-breaking character.
# The extra dot is to prevent the shell from consuming trailing
# line-breaks from the sub-command output. A line-break within
# single-quotes doesn't work because, if this script is created in a
# platform that uses two characters for line-breaks (e.g., DOS), tr
# would break.
ac_LF_and_DOT=`echo; echo .`
# Variables.
: ${AC_MACRODIR=@datadir@}
debug=false
localdir=.
tmp=
verbose=:
warning_all=false
warning_error=false
warning_obsolete=false
while test $# -gt 0 ; do
case "$1" in
@ -109,6 +108,18 @@ while test $# -gt 0 ; do
AC_MACRODIR=$1
shift ;;
--warnings | -W )
shift
test $# = 0 && { echo "$help" >&2; exit 1; }
warnings="$warnings "`echo $1 | sed -e 's/,/ /g'`
shift ;;
--warnings=* )
warnings="$warnings "`echo "$1" | sed -e 's/^[^=]*=//;s/,/ /g'`
shift ;;
-W* ) # People are used to -Wall, -Werror etc.
warnings="$warnings "`echo "$1" | sed -e 's/^-W//;s/,/ /g'`
shift ;;
-- ) # Stop option processing
shift; break ;;
- ) # Use stdin as input.
@ -123,6 +134,13 @@ while test $# -gt 0 ; do
esac
done
# Decode `$warnings'.
for i in :$warnings
do
test "$i" = : && continue
eval "warning_$i=:"
done
# Trap on 0 to stop playing with `rm'.
$debug ||
{
@ -144,6 +162,29 @@ $debug ||
exit 1;
}
# Preach.
if ($warning_all || $warning_obsolete) &&
(test -f $config_h.top ||
test -f $config_h.bot ||
test -f $localdir/acconfig.h); then
sed -e "s/^ //;s/^/$me: warning: /" >&2 <<\EOF
Using auxiliary files such as `acconfig.h', `config.h.bot'
and `config.h.top', to define templates for `config.h.in'
is deprecated and discouraged.
Using the third argument of `AC_DEFINE' and
`AC_DEFINE_UNQUOTED' allows to define a template without
`acconfig.h':
AC_DEFINE([NEED_MAIN], 1,
[Define if a function `main' is needed.])
More sophisticated templates can also be produced, see the
documentation.
EOF
$warning_error && exit 1
fi
acconfigs=
test -r $localdir/acconfig.h && acconfigs="$acconfigs $localdir/acconfig.h"
@ -197,55 +238,20 @@ case "$config_h" in
*) config_h_in="$config_h.in" ;;
esac
# Don't write "do not edit" -- it will get copied into the
# config.h, which it's ok to edit.
cat <<EOF >$tmp/config.hin
/* $config_h_in. Generated automatically from $infile by autoheader. */
EOF
test -r ${config_h}.top && cat ${config_h}.top >>$tmp/config.hin
# Dump the top.
test -r $config_h.top && cat $config_h.top >>$tmp/config.hin
# Dump `acconfig.h' but its bottom.
test -r $localdir/acconfig.h &&
grep @TOP@ $localdir/acconfig.h >/dev/null &&
sed '/@TOP@/,$d' $localdir/acconfig.h >>$tmp/config.hin
# This puts each template paragraph on its own line, separated by @s.
if test -n "$syms"; then
# Make sure the boundary of template files is also the boundary
# of the paragraph. Extra newlines don't hurt since they will
# be removed.
# Stuff outside of @TOP@ and @BOTTOM@ is ignored in all the acconfig.hs.
for t in $acconfigs; do
sedscript=""
grep @TOP@ $t >/dev/null && sedscript="1,/@TOP@/d;"
grep @BOTTOM@ $t >/dev/null && sedscript="$sedscript /@BOTTOM@/,\$d;"
# This substitution makes "#undef<TAB>FOO" in acconfig.h work.
sed -n -e "$sedscript s/ / /g; p" $t
echo; echo
done |
# The sed script is suboptimal because it has to take care of
# some broken seds (e.g. AIX) that remove '\n' from the
# pattern/hold space if the line is empty. (junio@twinsun.com).
sed -n -e '
/^[ ]*$/{
x
s/\n/@/g
p
s/.*/@/
x
}
H' | sed -e 's/@@*/@/g' |
# Select each paragraph that refers to a symbol we picked out above.
# Some fgrep's have limits on the number of lines that can be in the
# pattern on the command line, so use a temporary file containing the
# pattern.
(cat > $tmp/syms.fgrep <<EOF
$syms
EOF
fgrep -f $tmp/syms.fgrep) |
tr @. "$ac_LF_and_DOT" >>$tmp/config.hin
fi
sed -e '/@BOTTOM@/,$d' -e 's/@TOP@//' $localdir/acconfig.h >>$tmp/config.hin
# Dump the templates from `configure.in'.
for verb in `(set) 2>&1 | sed -n -e '/^ac_verbatim/s/^\([^=]*\)=.*$/\1/p'`; do
echo >>$tmp/config.hin
eval echo '"${'$verb'}"' >>$tmp/config.hin
@ -255,7 +261,7 @@ done
test -r $localdir/acconfig.h &&
grep @BOTTOM@ $localdir/acconfig.h >/dev/null &&
sed -n '/@BOTTOM@/,${/@BOTTOM@/!p;}' $localdir/acconfig.h >>$tmp/config.hin
test -f ${config_h}.bot && cat ${config_h}.bot >>$tmp/config.hin
test -f $config_h.bot && cat $config_h.bot >>$tmp/config.hin
# Check that all the symbols have a template.
@ -267,7 +273,7 @@ if test -n "$syms"; then
if egrep "^#$w*[a-z]*$w$w*$sym($w*|$w.*)$" $tmp/config.hin >/dev/null; then
: # All is well.
else
echo "$0: No template for symbol \`$sym'" >&2
echo "$me: No template for symbol \`$sym'" >&2
status=1
fi
done
@ -280,7 +286,7 @@ if test $status = 0; then
# Output is a file
if test -f $config_h_in && cmp -s $tmp/config.hin $config_h_in; then
# File didn't change, so don't update its mod time.
echo "$0: $config_h_in is unchanged" >&2
echo "$me: $config_h_in is unchanged" >&2
else
mv -f $tmp/config.hin $config_h_in
fi

View File

@ -42,7 +42,7 @@ Operation modes:
Warning categories include:
\`cross' cross compilation issues
\`obsolete' use of obsolete macros
\`obsolete' obsolete constructs
\`syntax' dubious syntactic constructs
\`all' all the warnings
\`error' warnings are error

View File

@ -32,13 +32,18 @@ Create a template file of C \`#define' statements for \`configure' to
use. To this end, scan TEMPLATE-FILE, or \`configure.in' if none
given.
-h, --help print this help, then exit
-V, --version print version number, then exit
-v, --verbose verbosely report processing
-d, --debug don't remove temporary files
-m, --macrodir=DIR directory storing Autoconf's macro files
-l, --localdir=DIR directory storing \`aclocal.m4' and \`acconfig.h'
-h, --help print this help, then exit
-V, --version print version number, then exit
-v, --verbose verbosely report processing
-d, --debug don't remove temporary files
-m, --macrodir=DIR directory storing Autoconf's macro files
-l, --localdir=DIR directory storing \`aclocal.m4' and \`acconfig.h'
-W, --warnings=CATEGORY report the warnings falling in CATEGORY
Warning categories include:
\`obsolete' obsolete constructs
\`all' all the warnings
\`error' warnings are error
Report bugs to <bug-autoconf@gnu.org>."
version="\
@ -62,21 +67,15 @@ if test "${LC_ALL+set}" = set; then LC_ALL=C; export LC_ALL; fi
if test "${LC_MESSAGES+set}" = set; then LC_MESSAGES=C; export LC_MESSAGES; fi
if test "${LC_CTYPE+set}" = set; then LC_CTYPE=C; export LC_CTYPE; fi
# ac_LF_and_DOT
# We use echo to avoid assuming a particular line-breaking character.
# The extra dot is to prevent the shell from consuming trailing
# line-breaks from the sub-command output. A line-break within
# single-quotes doesn't work because, if this script is created in a
# platform that uses two characters for line-breaks (e.g., DOS), tr
# would break.
ac_LF_and_DOT=`echo; echo .`
# Variables.
: ${AC_MACRODIR=@datadir@}
debug=false
localdir=.
tmp=
verbose=:
warning_all=false
warning_error=false
warning_obsolete=false
while test $# -gt 0 ; do
case "$1" in
@ -109,6 +108,18 @@ while test $# -gt 0 ; do
AC_MACRODIR=$1
shift ;;
--warnings | -W )
shift
test $# = 0 && { echo "$help" >&2; exit 1; }
warnings="$warnings "`echo $1 | sed -e 's/,/ /g'`
shift ;;
--warnings=* )
warnings="$warnings "`echo "$1" | sed -e 's/^[^=]*=//;s/,/ /g'`
shift ;;
-W* ) # People are used to -Wall, -Werror etc.
warnings="$warnings "`echo "$1" | sed -e 's/^-W//;s/,/ /g'`
shift ;;
-- ) # Stop option processing
shift; break ;;
- ) # Use stdin as input.
@ -123,6 +134,13 @@ while test $# -gt 0 ; do
esac
done
# Decode `$warnings'.
for i in :$warnings
do
test "$i" = : && continue
eval "warning_$i=:"
done
# Trap on 0 to stop playing with `rm'.
$debug ||
{
@ -144,6 +162,29 @@ $debug ||
exit 1;
}
# Preach.
if ($warning_all || $warning_obsolete) &&
(test -f $config_h.top ||
test -f $config_h.bot ||
test -f $localdir/acconfig.h); then
sed -e "s/^ //;s/^/$me: warning: /" >&2 <<\EOF
Using auxiliary files such as `acconfig.h', `config.h.bot'
and `config.h.top', to define templates for `config.h.in'
is deprecated and discouraged.
Using the third argument of `AC_DEFINE' and
`AC_DEFINE_UNQUOTED' allows to define a template without
`acconfig.h':
AC_DEFINE([NEED_MAIN], 1,
[Define if a function `main' is needed.])
More sophisticated templates can also be produced, see the
documentation.
EOF
$warning_error && exit 1
fi
acconfigs=
test -r $localdir/acconfig.h && acconfigs="$acconfigs $localdir/acconfig.h"
@ -197,55 +238,20 @@ case "$config_h" in
*) config_h_in="$config_h.in" ;;
esac
# Don't write "do not edit" -- it will get copied into the
# config.h, which it's ok to edit.
cat <<EOF >$tmp/config.hin
/* $config_h_in. Generated automatically from $infile by autoheader. */
EOF
test -r ${config_h}.top && cat ${config_h}.top >>$tmp/config.hin
# Dump the top.
test -r $config_h.top && cat $config_h.top >>$tmp/config.hin
# Dump `acconfig.h' but its bottom.
test -r $localdir/acconfig.h &&
grep @TOP@ $localdir/acconfig.h >/dev/null &&
sed '/@TOP@/,$d' $localdir/acconfig.h >>$tmp/config.hin
# This puts each template paragraph on its own line, separated by @s.
if test -n "$syms"; then
# Make sure the boundary of template files is also the boundary
# of the paragraph. Extra newlines don't hurt since they will
# be removed.
# Stuff outside of @TOP@ and @BOTTOM@ is ignored in all the acconfig.hs.
for t in $acconfigs; do
sedscript=""
grep @TOP@ $t >/dev/null && sedscript="1,/@TOP@/d;"
grep @BOTTOM@ $t >/dev/null && sedscript="$sedscript /@BOTTOM@/,\$d;"
# This substitution makes "#undef<TAB>FOO" in acconfig.h work.
sed -n -e "$sedscript s/ / /g; p" $t
echo; echo
done |
# The sed script is suboptimal because it has to take care of
# some broken seds (e.g. AIX) that remove '\n' from the
# pattern/hold space if the line is empty. (junio@twinsun.com).
sed -n -e '
/^[ ]*$/{
x
s/\n/@/g
p
s/.*/@/
x
}
H' | sed -e 's/@@*/@/g' |
# Select each paragraph that refers to a symbol we picked out above.
# Some fgrep's have limits on the number of lines that can be in the
# pattern on the command line, so use a temporary file containing the
# pattern.
(cat > $tmp/syms.fgrep <<EOF
$syms
EOF
fgrep -f $tmp/syms.fgrep) |
tr @. "$ac_LF_and_DOT" >>$tmp/config.hin
fi
sed -e '/@BOTTOM@/,$d' -e 's/@TOP@//' $localdir/acconfig.h >>$tmp/config.hin
# Dump the templates from `configure.in'.
for verb in `(set) 2>&1 | sed -n -e '/^ac_verbatim/s/^\([^=]*\)=.*$/\1/p'`; do
echo >>$tmp/config.hin
eval echo '"${'$verb'}"' >>$tmp/config.hin
@ -255,7 +261,7 @@ done
test -r $localdir/acconfig.h &&
grep @BOTTOM@ $localdir/acconfig.h >/dev/null &&
sed -n '/@BOTTOM@/,${/@BOTTOM@/!p;}' $localdir/acconfig.h >>$tmp/config.hin
test -f ${config_h}.bot && cat ${config_h}.bot >>$tmp/config.hin
test -f $config_h.bot && cat $config_h.bot >>$tmp/config.hin
# Check that all the symbols have a template.
@ -267,7 +273,7 @@ if test -n "$syms"; then
if egrep "^#$w*[a-z]*$w$w*$sym($w*|$w.*)$" $tmp/config.hin >/dev/null; then
: # All is well.
else
echo "$0: No template for symbol \`$sym'" >&2
echo "$me: No template for symbol \`$sym'" >&2
status=1
fi
done
@ -280,7 +286,7 @@ if test $status = 0; then
# Output is a file
if test -f $config_h_in && cmp -s $tmp/config.hin $config_h_in; then
# File didn't change, so don't update its mod time.
echo "$0: $config_h_in is unchanged" >&2
echo "$me: $config_h_in is unchanged" >&2
else
mv -f $tmp/config.hin $config_h_in
fi

View File

@ -1891,11 +1891,13 @@ individual @file{config.h.in}.
@itemx -h
Print a summary of the command line options and exit.
@item --localdir=@var{dir}
@itemx -l @var{dir}
Look for the package files @file{aclocal.m4} and @file{acconfig.h} (but
not @file{@var{file}.top} and @file{@var{file}.bot}) in directory
@var{dir} instead of in the current directory.
@item --version
@itemx -V
Print the version number of Autoconf and exit.
@item --debug
@itemx -d
Don't remove the temporary files.
@item --macrodir=@var{dir}
@itemx -m @var{dir}
@ -1904,9 +1906,33 @@ Look for the installed macro files and @file{acconfig.h} in directory
@var{dir}. You can also set the @code{AC_MACRODIR} environment variable
to a directory; this option overrides the environment variable.
@item --version
@itemx -V
Print the version number of Autoconf and exit.
@item --localdir=@var{dir}
@itemx -l @var{dir}
Look for the package files @file{aclocal.m4} and @file{acconfig.h} (but
not @file{@var{file}.top} and @file{@var{file}.bot}) in directory
@var{dir} instead of in the current directory.
@item --warnings=@var{category}
@itemx -W @var{category}
@evindex WARNINGS
Report the warnings related to @var{category} (which can actually be a
comma separated list). Current categories include:
@table @samp
@item @samp{obsolete}
report the uses of obsolete constructs
@item @samp{all}
report all the warnings
@item @samp{error}
treats warnings as errors
@end table
The soon-do-be-standard environment variable @code{WARNINGS} is
supported: it consists in a comma separated list of categories. It is
honored iff @samp{--warnings} was not used.
@end table
@node Configuration Commands, Configuration Links, Configuration Headers, Setup

View File

@ -1,5 +1,5 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.020.
.TH AUTOCONF "1" "April 2000" "GNU autoconf 2.14a" FSF
.TH AUTOCONF "1" "May 2000" "GNU autoconf 2.14a" FSF
.SH NAME
autoconf \- Generate configuration scripts
.SH SYNOPSIS
@ -40,7 +40,7 @@ report the warnings falling in CATEGORY
cross compilation issues
.TP
`obsolete'
use of obsolete macros
obsolete constructs
.TP
`syntax'
dubious syntactic constructs

View File

@ -27,6 +27,19 @@ directory storing Autoconf's macro files
.TP
\fB\-l\fR, \fB\-\-localdir\fR=\fIDIR\fR
directory storing `aclocal.m4' and `acconfig.h'
.TP
\fB\-W\fR, \fB\-\-warnings\fR=\fICATEGORY\fR
report the warnings falling in CATEGORY
.SS "Warning categories include:"
.TP
`obsolete'
obsolete constructs
.TP
`all'
all the warnings
.TP
`error'
warnings are error
.SH AUTHOR
Written by Roland McGrath.
.SH "REPORTING BUGS"