[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo cleanups
|
From: |
Eric Blake |
|
Subject: |
texinfo cleanups |
|
Date: |
Thu, 6 Sep 2007 15:43:03 +0000 (UTC) |
|
User-agent: |
Loom/3.14 (http://gmane.org/) |
I'm committing the following, which reduces the number of >80-column lines, and
avoids all warnings on overfull/underfull hbox (via paragraph rewording) and
overfull vbox (via adding index entries, so that indices no longer end too
close to a page boundary). Checked via both 'make info' and 'make pdf'.
2007-09-06 Eric Blake <address@hidden>
Texinfo cleanup.
* doc/autoconf.texi: Avoid lines > 80 columns when possible.
Reword some paragraphs to avoid overfull, underfull hbox
warnings. Add index entries to avoid overfull vbox warnings.
Index: doc/autoconf.texi
===================================================================
RCS file: /sources/autoconf/autoconf/doc/autoconf.texi,v
retrieving revision 1.1166
diff -u -p -r1.1166 autoconf.texi
--- doc/autoconf.texi 22 Aug 2007 05:00:47 -0000 1.1166
+++ doc/autoconf.texi 6 Sep 2007 15:37:44 -0000
@@ -1427,7 +1427,7 @@ disable warnings falling into @var{categ
Warnings about @samp{syntax} are enabled by default, and the environment
variable @env{WARNINGS}, a comma separated list of categories, is
honored as well. Passing @option{-W @var{category}} actually behaves as if
-you had passed @option{--warnings=syntax,$WARNINGS,@var{category}}. If
+you had passed @option{--warnings syntax,$WARNINGS,@var{category}}. If
you want to disable the defaults and @env{WARNINGS}, but (for example)
enable the warnings about obsolete constructs, you would use @option{-W
none,obsolete}.
@@ -1657,7 +1657,7 @@ disable warnings falling into @var{categ
Warnings about @samp{syntax} are enabled by default, and the environment
variable @env{WARNINGS}, a comma separated list of categories, is
honored as well. Passing @option{-W @var{category}} actually behaves as if
-you had passed @option{--warnings=syntax,$WARNINGS,@var{category}}. If
+you had passed @option{--warnings syntax,$WARNINGS,@var{category}}. If
you want to disable the defaults and @env{WARNINGS}, but (for example)
enable the warnings about obsolete constructs, you would use @option{-W
none,obsolete}.
@@ -1701,7 +1701,8 @@ Every @command{configure} script must ca
anything else. The only other required macro is @code{AC_OUTPUT}
(@pxref{Output}).
address@hidden AC_INIT (@var{package}, @var{version}, @ovar{bug-report}, @ovar
{tarname})
address@hidden AC_INIT (@var{package}, @var{version}, @ovar{bug-report}, @
+ @ovar{tarname})
@acindex{INIT}
Process any command-line arguments and perform various initializations
and verifications.
@@ -3285,7 +3286,8 @@ results of tests. One can use @code{AC_
creation of relative symbolic links can be delicate when the package is
built in a directory different from the source directory.
address@hidden AC_CONFIG_LINKS (@var{dest}:@address@hidden, @ovar{cmds}, @ovar
{init-cmds})
address@hidden AC_CONFIG_LINKS (@var{dest}:@address@hidden, @ovar{cmds}, @
+ @ovar{init-cmds})
@acindex{CONFIG_LINKS}
@cindex Links
Make @code{AC_OUTPUT} link each of the existing files @var{source} to
@@ -3844,7 +3846,8 @@ You are strongly encouraged to declare t
@code{AC_CHECK_PROG} etc.@: as precious, @xref{Setting Output Variables},
@code{AC_ARG_VAR}, for more details.
address@hidden AC_CHECK_PROG (@var{variable}, @var{prog-to-check-for},
@var{value-if-
found}, @ovar{value-if-not-found}, @ovar{path}, @ovar{reject})
address@hidden AC_CHECK_PROG (@var{variable}, @var{prog-to-check-for}, @
+ @var{value-if-found}, @ovar{value-if-not-found}, @ovar{path}, @ovar{reject})
@acindex{CHECK_PROG}
Check whether program @var{prog-to-check-for} exists in @env{PATH}. If
it is found, set @var{variable} to @var{value-if-found}, otherwise to
@@ -3856,7 +3859,8 @@ that case, set @var{variable} using the
@var{variable}.
@end defmac
address@hidden AC_CHECK_PROGS (@var{variable}, @var{progs-to-check-for},
@ovar{value-
if-not-found}, @ovar{path})
address@hidden AC_CHECK_PROGS (@var{variable}, @var{progs-to-check-for}, @
+ @ovar{value-if-not-found}, @ovar{path})
@acindex{CHECK_PROGS}
Check for each program in the blank-separated list
@var{progs-to-check-for} existing in the @env{PATH}. If one is found, set
@@ -3867,7 +3871,8 @@ list are found, set @var{variable} to @v
is not changed. Calls @code{AC_SUBST} for @var{variable}.
@end defmac
address@hidden AC_CHECK_TARGET_TOOL (@var{variable}, @var{prog-to-check-for},
@ovar
{value-if-not-found}, @ovar{path})
address@hidden AC_CHECK_TARGET_TOOL (@var{variable}, @var{prog-to-check-for}, @
+ @ovar{value-if-not-found}, @ovar{path})
@acindex{CHECK_TARGET_TOOL}
Like @code{AC_CHECK_PROG}, but first looks for @var{prog-to-check-for}
with a prefix of the target type as determined by
@@ -3884,7 +3889,8 @@ compiler driver @r{(@command{gcc} for th
uses to produce objects, archives or executables}.
@end defmac
address@hidden AC_CHECK_TOOL (@var{variable}, @var{prog-to-check-for},
@ovar{value-if-
not-found}, @ovar{path})
address@hidden AC_CHECK_TOOL (@var{variable}, @var{prog-to-check-for}, @
+ @ovar{value-if-not-found}, @ovar{path})
@acindex{CHECK_TOOL}
Like @code{AC_CHECK_PROG}, but first looks for @var{prog-to-check-for}
with a prefix of the host type as determined by
@@ -3905,7 +3911,8 @@ For more information, see @ref{Specifyin
system type}.
@end defmac
address@hidden AC_CHECK_TARGET_TOOLS (@var{variable}, @var{progs-to-check-for},
@ovar
{value-if-not-found}, @ovar{path})
address@hidden AC_CHECK_TARGET_TOOLS (@var{variable}, @var{progs-to-check-for},
@
+ @ovar{value-if-not-found}, @ovar{path})
@acindex{CHECK_TARGET_TOOLS}
Like @code{AC_CHECK_TARGET_TOOL}, each of the tools in the list
@var{progs-to-check-for} are checked with a prefix of the target type as
@@ -3919,7 +3926,8 @@ is not specified, the value of @var{vari
@code{AC_SUBST} for @var{variable}.
@end defmac
address@hidden AC_CHECK_TOOLS (@var{variable}, @var{progs-to-check-for},
@ovar{value-
if-not-found}, @ovar{path})
address@hidden AC_CHECK_TOOLS (@var{variable}, @var{progs-to-check-for}, @
+ @ovar{value-if-not-found}, @ovar{path})
@acindex{CHECK_TOOLS}
Like @code{AC_CHECK_TOOL}, each of the tools in the list
@var{progs-to-check-for} are checked with a prefix of the host type as
@@ -3935,26 +3943,30 @@ In the future, when cross-compiling this
accept program names that are not prefixed with the host type.
@end defmac
address@hidden AC_PATH_PROG (@var{variable}, @var{prog-to-check-for},
@ovar{value-if-
not-found}, @ovar{path})
address@hidden AC_PATH_PROG (@var{variable}, @var{prog-to-check-for}, @
+ @ovar{value-if-not-found}, @ovar{path})
@acindex{PATH_PROG}
Like @code{AC_CHECK_PROG}, but set @var{variable} to the absolute
name of @var{prog-to-check-for} if found.
@end defmac
address@hidden AC_PATH_PROGS (@var{variable}, @var{progs-to-check-for},
@ovar{value-
if-not-found}, @ovar{path})
address@hidden AC_PATH_PROGS (@var{variable}, @var{progs-to-check-for}, @
+ @ovar{value-if-not-found}, @ovar{path})
@acindex{PATH_PROGS}
Like @code{AC_CHECK_PROGS}, but if any of @var{progs-to-check-for}
are found, set @var{variable} to the absolute name of the program
found.
@end defmac
address@hidden AC_PATH_TARGET_TOOL (@var{variable}, @var{prog-to-check-for},
@ovar
{value-if-not-found}, @ovar{path})
address@hidden AC_PATH_TARGET_TOOL (@var{variable}, @var{prog-to-check-for}, @
+ @ovar{value-if-not-found}, @ovar{path})
@acindex{PATH_TARGET_TOOL}
Like @code{AC_CHECK_TARGET_TOOL}, but set @var{variable} to the absolute
name of the program if it is found.
@end defmac
address@hidden AC_PATH_TOOL (@var{variable}, @var{prog-to-check-for},
@ovar{value-if-
not-found}, @ovar{path})
address@hidden AC_PATH_TOOL (@var{variable}, @var{prog-to-check-for}, @
+ @ovar{value-if-not-found}, @ovar{path})
@acindex{PATH_TOOL}
Like @code{AC_CHECK_TOOL}, but set @var{variable} to the absolute
name of the program if it is found.
@@ -3973,14 +3985,16 @@ these macros, ask yourself whether a run
solution. Be aware that, like most Autoconf macros, they test a feature
of the host machine, and therefore, they die when cross-compiling.
address@hidden AC_CHECK_FILE (@var{file}, @ovar{action-if-found},
@ovar{action-if-not-
found})
address@hidden AC_CHECK_FILE (@var{file}, @ovar{action-if-found}, @
+ @ovar{action-if-not-found})
@acindex{CHECK_FILE}
Check whether file @var{file} exists on the native system. If it is
found, execute @var{action-if-found}, otherwise do
@var{action-if-not-found}, if given.
@end defmac
address@hidden AC_CHECK_FILES (@var{files}, @ovar{action-if-found},
@ovar{action-if-
not-found})
address@hidden AC_CHECK_FILES (@var{files}, @ovar{action-if-found}, @
+ @ovar{action-if-not-found})
@acindex{CHECK_FILES}
Executes @code{AC_CHECK_FILE} once for each file listed in @var{files}.
Additionally, defines @address@hidden (@pxref{Standard Symbols})
@@ -3995,7 +4009,8 @@ for each file found.
The following macros check for the presence of certain C, C++, or Fortran
library archive files.
address@hidden AC_CHECK_LIB (@var{library}, @var{function},
@ovar{action-if-found},
@ovar{action-if-not-found}, @ovar{other-libraries})
address@hidden AC_CHECK_LIB (@var{library}, @var{function}, @
+ @ovar{action-if-found}, @ovar{action-if-not-found}, @ovar{other-libraries})
@acindex{CHECK_LIB}
Test whether the library @var{library} is available by trying to link
a test program that calls function @var{function} with the library.
@@ -4035,7 +4050,8 @@ days it is normally better to use @code{
@end defmac
address@hidden AC_SEARCH_LIBS (@var{function}, @var{search-libs},
@ovar{action-if-
found}, @ovar{action-if-not-found}, @ovar{other-libraries})
address@hidden AC_SEARCH_LIBS (@var{function}, @var{search-libs}, @
+ @ovar{action-if-found}, @ovar{action-if-not-found}, @ovar{other-libraries})
@acindex{SEARCH_LIBS}
Search for a library defining @var{function} if it's not already
available. This equates to calling
@@ -4228,7 +4244,8 @@ longer need to be worried about.
@item @code{sscanf}
@c @fuindex sscanf
@prindex @code{sscanf}
-On various old systems, e.g., @acronym{HP-UX} 9, @code{sscanf} requires that
its
+On various old systems, e.g., @acronym{HP-UX} 9, @code{sscanf} requires
+that its
input string be writable (though it doesn't actually change it). This
can be a problem when using @command{gcc} since it normally puts
constant strings in read-only memory (@pxref{Incompatibilities,
@@ -4389,6 +4406,7 @@ void *alloca (size_t);
@defmac AC_FUNC_CHOWN
@acindex{FUNC_CHOWN}
address@hidden HAVE_CHOWN
@c @fuindex chown
@prindex @code{chown}
If the @code{chown} function is available and works (in particular, it
@@ -4492,6 +4510,7 @@ yourself in new code:
@defmac AC_FUNC_FSEEKO
@acindex{FUNC_FSEEKO}
@cvindex _LARGEFILE_SOURCE
address@hidden HAVE_FSEEKO
@c @fuindex fseeko
@prindex @code{fseeko}
If the @code{fseeko} function is available, define @code{HAVE_FSEEKO}.
@@ -4504,6 +4523,7 @@ largefile-sensitive systems where @code{
@defmac AC_FUNC_GETGROUPS
@acindex{FUNC_GETGROUPS}
address@hidden HAVE_GETGROUPS
@ovindex GETGROUPS_LIBS
@c @fuindex getgroups
@prindex @code{getgroups}
@@ -4847,6 +4867,7 @@ variable @code{POW_LIB} to the extra lib
@defmac AC_FUNC_STRTOLD
@acindex{FUNC_STRTOLD}
address@hidden HAVE_STRTOLD
@prindex @code{strtold}
If the @code{strtold} function exists and conforms to C99, define
@code{HAVE_STRTOLD}.
@@ -4920,7 +4941,8 @@ If you need to check the behavior of a f
whether it is present, you have to write your own test for
it (@pxref{Writing Tests}).
address@hidden AC_CHECK_FUNC (@var{function}, @ovar{action-if-found},
@ovar{action-if-
not-found})
address@hidden AC_CHECK_FUNC (@var{function}, @ovar{action-if-found}, @
+ @ovar{action-if-not-found})
@acindex{CHECK_FUNC}
If C function @var{function} is available, run shell commands
@var{action-if-found}, otherwise @var{action-if-not-found}. If you just
@@ -4931,7 +4953,8 @@ standardized than C++. (@pxref{Language
about selecting the language for checks.)
@end defmac
address@hidden AC_CHECK_FUNCS (@address@hidden, @ovar{action-if-found}, @ovar
{action-if-not-found})
address@hidden AC_CHECK_FUNCS (@address@hidden, @ovar{action-if-found}, @
+ @ovar{action-if-not-found})
@acindex{CHECK_FUNCS}
@cvindex address@hidden
For each @var{function} enumerated in the blank-or-newline-separated argument
@@ -5042,6 +5065,7 @@ a convenient shorthand.
@defmac AC_REPLACE_FUNCS (@address@hidden)
@acindex{REPLACE_FUNCS}
address@hidden address@hidden
@ovindex LIBOBJS
Like @code{AC_CHECK_FUNCS}, but uses @samp{AC_LIBOBJ(@var{function})} as
@var{action-if-not-found}. You can declare your replacement function by
@@ -5554,7 +5578,8 @@ These macros are used to find system hea
as well as find out whether it is present, you have to write your own
test for it (@pxref{Writing Tests}).
address@hidden AC_CHECK_HEADER (@var{header-file}, @ovar{action-if-found}, @ovar
{action-if-not-found}, @dvar{includes, default-includes})
address@hidden AC_CHECK_HEADER (@var{header-file}, @ovar{action-if-found}, @
+ @ovar{action-if-not-found}, @dvar{includes, default-includes})
@acindex{CHECK_HEADER}
If the system header file @var{header-file} is compilable, execute shell
commands @var{action-if-found}, otherwise execute
@@ -5566,7 +5591,9 @@ For compatibility issues with older vers
below.
@end defmac
address@hidden AC_CHECK_HEADERS (@address@hidden, @ovar{action-if-found},
@ovar{action-if-not-found}, @dvar{includes, default-includes})
address@hidden AC_CHECK_HEADERS (@address@hidden, @
+ @ovar{action-if-found}, @ovar{action-if-not-found}, @
+ @dvar{includes, default-includes})
@acindex{CHECK_HEADERS}
@cvindex address@hidden
For each given system header file @var{header-file} in the
@@ -5646,7 +5673,8 @@ There are no specific macros for declara
These macros are used to find declarations not covered by the ``particular''
test macros.
address@hidden AC_CHECK_DECL (@var{symbol}, @ovar{action-if-found},
@ovar{action-if-
not-found}, @dvar{includes, default-includes})
address@hidden AC_CHECK_DECL (@var{symbol}, @ovar{action-if-found}, @
+ @ovar{action-if-not-found}, @dvar{includes, default-includes})
@acindex{CHECK_DECL}
If @var{symbol} (a function, variable, or constant) is not declared in
@var{includes} and a declaration is needed, run the shell commands
@@ -5660,7 +5688,8 @@ is much safer to avoid
introducing extra declarations when they are not needed.
@end defmac
address@hidden AC_CHECK_DECLS (@var{symbols}, @ovar{action-if-found},
@ovar{action-if-
not-found}, @dvar{includes, default-includes})
address@hidden AC_CHECK_DECLS (@var{symbols}, @ovar{action-if-found}, @
+ @ovar{action-if-not-found}, @dvar{includes, default-includes})
@acindex{CHECK_DECLS}
@cvindex address@hidden
For each of the @var{symbols} (@emph{comma}-separated list), define
@@ -5818,6 +5847,8 @@ current systems. New programs need not
@defmac AC_STRUCT_TIMEZONE
@acindex{STRUCT_TIMEZONE}
address@hidden HAVE_DECL_TZNAME
address@hidden HAVE_STRUCT_TM_TM_ZONE
@cvindex HAVE_TM_ZONE
@cvindex HAVE_TZNAME
Figure out how to get the current timezone. If @code{struct tm} has a
@@ -5833,7 +5864,9 @@ define @code{HAVE_DECL_TZNAME}.
These macros are used to find structure members not covered by the
``particular'' test macros.
address@hidden AC_CHECK_MEMBER (@address@hidden, @ovar{action-if-found},
@ovar{action-if-not-found}, @dvar{includes, default-includes})
address@hidden AC_CHECK_MEMBER (@address@hidden, @
+ @ovar{action-if-found}, @ovar{action-if-not-found}, @
+ @dvar{includes, default-includes})
@acindex{CHECK_MEMBER}
Check whether @var{member} is a member of the aggregate @var{aggregate}.
If no @var{includes} are specified, the default includes are used
@@ -5852,8 +5885,10 @@ AC_CHECK_MEMBER(struct top.middle.bot)
@end example
@end defmac
address@hidden AC_CHECK_MEMBERS (@var{members}, @ovar{action-if-found},
@ovar{action-
if-not-found}, @dvar{includes, default-includes})
address@hidden AC_CHECK_MEMBERS (@var{members}, @ovar{action-if-found}, @
+ @ovar{action-if-not-found}, @dvar{includes, default-includes})
@acindex{CHECK_MEMBERS}
address@hidden address@hidden@var{member}
Check for the existence of each @address@hidden@var{member}} of
@var{members} using the previous macro. When @var{member} belongs to
@var{aggregate}, define @address@hidden@var{member}} (in all
@@ -6132,7 +6167,8 @@ define @code{HAVE_UNSIGNED_LONG_LONG_INT
These macros are used to check for types not covered by the ``particular''
test macros.
address@hidden AC_CHECK_TYPE (@var{type}, @ovar{action-if-found},
@ovar{action-if-not-
found}, @dvar{includes, default-includes})
address@hidden AC_CHECK_TYPE (@var{type}, @ovar{action-if-found}, @
+ @ovar{action-if-not-found}, @dvar{includes, default-includes})
@acindex{CHECK_TYPE}
Check whether @var{type} is defined. It may be a compiler builtin type
or defined by the @var{includes} (@pxref{Default Includes}).
@@ -6145,8 +6181,10 @@ same test is applied when compiling for
@end defmac
address@hidden AC_CHECK_TYPES (@var{types}, @ovar{action-if-found},
@ovar{action-if-
not-found}, @dvar{includes, default-includes})
address@hidden AC_CHECK_TYPES (@var{types}, @ovar{action-if-found}, @
+ @ovar{action-if-not-found}, @dvar{includes, default-includes})
@acindex{CHECK_TYPES}
address@hidden address@hidden
For each @var{type} of the @var{types} that is defined, define
@address@hidden (in all capitals). Each @var{type} must follow
the rules of @code{AC_CHECK_TYPE}. If no @var{includes} are
@@ -6219,8 +6257,8 @@ static int test_array[sizeof (int) == 4
@noindent
To our knowledge, there is a single compiler that does not support this
-trick: the @acronym{HP} C compilers (the real ones, not only the ``bundled'')
on
address@hidden 11.00.
+trick: the @acronym{HP} C compilers (the real ones, not only the
+``bundled'') on @acronym{HP-UX} 11.00.
They incorrectly reject the above program with the diagnostic
``Variable-length arrays cannot have static storage.''
This bug comes from @acronym{HP} compilers' mishandling of @code{sizeof (int)},
@@ -6232,8 +6270,10 @@ Autoconf works around this problem by ca
@node Generic Compiler Characteristics
@subsection Generic Compiler Characteristics
address@hidden AC_CHECK_SIZEOF (@var{type-or-expr}, @ovar{unused},
@dvar{includes,
default-includes})
address@hidden AC_CHECK_SIZEOF (@var{type-or-expr}, @ovar{unused}, @
+ @dvar{includes, default-includes})
@acindex{CHECK_SIZEOF}
address@hidden address@hidden
Define @address@hidden (@pxref{Standard Symbols}) to be
the size in bytes of @var{type-or-expr}, which may be either a type or
an expression returning a value that has a size. If the expression
@@ -6256,6 +6296,7 @@ defines @code{SIZEOF_INT_P} to be 8 on D
@defmac AC_CHECK_ALIGNOF (@var{type}, @dvar{includes, default-includes})
@acindex{CHECK_ALIGNOF}
address@hidden address@hidden
Define @address@hidden (@pxref{Standard Symbols}) to be the
alignment in bytes of @var{type}. @address@hidden y;} must be valid as
a structure member declaration. If @samp{type} is unknown, the result
@@ -6263,15 +6304,16 @@ is 0. If no @var{includes} are specifie
(@pxref{Default Includes}).
@end defmac
address@hidden AC_COMPUTE_INT (@var{var}, @var{expression}, @dvar{includes,
default-
includes}, @ovar{action-if-fails})
address@hidden AC_COMPUTE_INT (@var{var}, @var{expression}, @
+ @dvar{includes, default-includes}, @ovar{action-if-fails})
@acindex{COMPUTE_INT}
Store into the shell variable @var{var} the value of the integer
@var{expression}. The
value should fit in an initializer in a C variable of type @code{signed
long}. To support cross compilation (in which case, the macro only works on
hosts that use twos-complement arithmetic), it should be possible to evaluate
-the expression at compile-time. If no @var{includes} are specified, the
default
-includes are used (@pxref{Default Includes}).
+the expression at compile-time. If no @var{includes} are specified, the
+default includes are used (@pxref{Default Includes}).
Execute @var{action-if-fails} if the value cannot be determined correctly.
@end defmac
@@ -6518,7 +6560,8 @@ set to accept C99; if not, the shell var
@end defmac
@defmac AC_C_BACKSLASH_A
address@hidden
address@hidden
address@hidden HAVE_C_BACKSLASH_A
Define @samp{HAVE_C_BACKSLASH_A} to 1 if the C compiler understands
@samp{\a}.
@@ -6526,7 +6569,8 @@ This macro is obsolescent, as current C
New programs need not use this macro.
@end defmac
address@hidden AC_C_BIGENDIAN (@ovar{action-if-true}, @ovar{action-if-false},
@ovar
{action-if-unknown}, @ovar{action-if-universal})
address@hidden AC_C_BIGENDIAN (@ovar{action-if-true}, @ovar{action-if-false}, @
+ @ovar{action-if-unknown}, @ovar{action-if-universal})
@acindex{C_BIGENDIAN}
@cvindex WORDS_BIGENDIAN
@cindex Endianness
@@ -6881,7 +6925,8 @@ program is not found.
@defmac AC_ERLANG_PATH_ERL (@ovar{value-if-not-found}, @ovar{path})
@acindex{ERLANG_PATH_ERL}
@ovindex ERL
-Determine an Erlang interpreter to use. If @code{ERL} is not already set in
the
+Determine an Erlang interpreter to use. If @code{ERL} is not already
+set in the
environment, check for @command{erl}. Set output variable @code{ERL} to the
complete path of the interpreter command found.
@@ -7195,7 +7240,8 @@ information other than through the C pre
to call Fortran routines from some language other than C/C++.
@end defmac
address@hidden AC_FC_SRCEXT (@var{ext}, @ovar{action-if-success},
@ovar{action-if-
failure})
address@hidden AC_FC_SRCEXT (@var{ext}, @ovar{action-if-success}, @
+ @ovar{action-if-failure})
@acindex{FC_SRCEXT}
By default, the @code{FC} macros perform their tests using a @file{.f}
extension for source-code files. Some compilers, however, only enable
@@ -7450,10 +7496,10 @@ configuration of an Erlang interpreter a
@acindex{ERLANG_SUBST_ROOT_DIR}
@ovindex ERLANG_ROOT_DIR
-Set the output variable @code{ERLANG_ROOT_DIR} to the path to the base
directory
-in which Erlang/OTP is installed (as returned by Erlang's @code
{code:root_dir/0}
-function). The result of this test is cached if caching is enabled when
running
address@hidden
+Set the output variable @code{ERLANG_ROOT_DIR} to the path to the base
+directory in which Erlang/OTP is installed (as returned by Erlang's
address@hidden:root_dir/0} function). The result of this test is cached if
+caching is enabled when running @command{configure}.
@end defmac
@defmac AC_ERLANG_SUBST_LIB_DIR
@@ -7467,7 +7513,8 @@ Erlang/OTP library. The result of this
when running @command{configure}.
@end defmac
address@hidden AC_ERLANG_CHECK_LIB (@var{library}, @ovar{action-if-found}, @ovar
{action-if-not-found})
address@hidden AC_ERLANG_CHECK_LIB (@var{library}, @ovar{action-if-found}, @
+ @ovar{action-if-not-found})
@acindex{ERLANG_CHECK_LIB}
@ovindex address@hidden
@ovindex address@hidden
@@ -7506,7 +7553,8 @@ Erlang libraries are to be installed:
@ovindex ERLANG_INSTALL_LIB_DIR
Set the @code{ERLANG_INSTALL_LIB_DIR} output variable to the directory into
-which every built Erlang library should be installed in a separate
subdirectory.
+which every built Erlang library should be installed in a separate
+subdirectory.
If this variable is not set in the environment when @command{configure} runs,
its default value is @code{$ERLANG_LIB_DIR}, which value is set by the
@code{AC_ERLANG_SUBST_LIB_DIR} macro.
@@ -7882,7 +7930,8 @@ fputs (hw, stdout);
@end example
In Erlang tests, the created source file is that of an Erlang module called
address@hidden (@file{conftest.erl}). This module defines and exports at
least
address@hidden (@file{conftest.erl}). This module defines and exports
+at least
one @code{start/0} function, which is called to perform the test. The
@var{prologue} is optional code that is inserted between the module header and
the @code{start/0} function definition. @var{body} is the body of the
@@ -7955,7 +8004,8 @@ Nevertheless, if you need to run the pre
The macros described in this section cannot be used for tests in Erlang or
Fortran, since those languages require no preprocessor.
address@hidden AC_PREPROC_IFELSE (@var{input}, @ovar{action-if-true},
@ovar{action-if-
false})
address@hidden AC_PREPROC_IFELSE (@var{input}, @ovar{action-if-true}, @
+ @ovar{action-if-false})
@acindex{PREPROC_IFELSE}
Run the preprocessor of the current language (@pxref{Language Choice})
on the @var{input}, run the shell commands @var{action-if-true} on
@@ -8009,7 +8059,8 @@ get rid of your old use of the macro @co
@code{AC_PREPROC_IFELSE}, but, in the first place, are you sure you need
to run the @emph{preprocessor} and not the compiler?
address@hidden AC_EGREP_HEADER (@var{pattern}, @var{header-file},
@var{action-if-
found}, @ovar{action-if-not-found})
address@hidden AC_EGREP_HEADER (@var{pattern}, @var{header-file}, @
+ @var{action-if-found}, @ovar{action-if-not-found})
@acindex{EGREP_HEADER}
If the output of running the preprocessor on the system header file
@var{header-file} matches the extended regular expression
@@ -8017,7 +8068,8 @@ If the output of running the preprocesso
execute @var{action-if-not-found}.
@end defmac
address@hidden AC_EGREP_CPP (@var{pattern}, @var{program},
@ovar{action-if-found},
@ovar{action-if-not-found})
address@hidden AC_EGREP_CPP (@var{pattern}, @var{program}, @
+ @ovar{action-if-found}, @ovar{action-if-not-found})
@acindex{EGREP_CPP}
@var{program} is the text of a C or C++ program, on which shell
variable, back quote, and backslash substitutions are performed. If the
@@ -8036,7 +8088,8 @@ Choice}) compiler, such as whether it re
simply to try some library feature, use @code{AC_COMPILE_IFELSE} to try
to compile a small program that uses that feature.
address@hidden AC_COMPILE_IFELSE (@var{input}, @ovar{action-if-true},
@ovar{action-if-
false})
address@hidden AC_COMPILE_IFELSE (@var{input}, @ovar{action-if-true}, @
+ @ovar{action-if-false})
@acindex{COMPILE_IFELSE}
Run the compiler and compilation flags of the current language
(@pxref{Language Choice}) on the @var{input}, run the shell commands
@@ -8053,8 +8106,8 @@ Linker}).
For tests in Erlang, the @var{input} must be the source code of a module named
@code{conftest}. @code{AC_COMPILE_IFELSE} generates a @file{conftest.beam}
file that can be interpreted by the Erlang virtual machine (@code{ERL}). It is
-recommended to use @code{AC_LANG_PROGRAM} to specify the test program, to
ensure
-that the Erlang module has the right name.
+recommended to use @code{AC_LANG_PROGRAM} to specify the test program,
+to ensure that the Erlang module has the right name.
@node Running the Linker
@section Running the Linker
@@ -8078,7 +8131,8 @@ checked for to @code{LIBS} temporarily a
program.
address@hidden AC_LINK_IFELSE (@var{input}, @ovar{action-if-true},
@ovar{action-if-
false})
address@hidden AC_LINK_IFELSE (@var{input}, @ovar{action-if-true}, @
+ @ovar{action-if-false})
@acindex{LINK_IFELSE}
Run the compiler (and compilation flags) and the linker of the current
language (@pxref{Language Choice}) on the @var{input}, run the shell
@@ -8114,7 +8168,8 @@ run it using @code{AC_RUN_IFELSE}. Avoi
possible, because this prevents people from configuring your package for
cross-compiling.
address@hidden AC_RUN_IFELSE (@var{input}, @ovar{action-if-true},
@ovar{action-if-
false}, @ovar{action-if-cross-compiling})
address@hidden AC_RUN_IFELSE (@var{input}, @ovar{action-if-true}, @
+ @ovar{action-if-false}, @ovar{action-if-cross-compiling})
@acindex{RUN_IFELSE}
If @var{program} compiles and links successfully and returns an exit
status of 0 when executed, run shell commands @var{action-if-true}.
@@ -8173,7 +8228,8 @@ Therefore, if a test must output configu
to create and to output data into the temporary file named @file{conftest.out},
using the functions of module @code{file}. The @code{conftest.out} file is
automatically deleted by the @code{AC_RUN_IFELSE} macro. For instance, a
-simplified implementation of Autoconf's @code{AC_ERLANG_SUBST_LIB_DIR} macro
is:
+simplified implementation of Autoconf's @code{AC_ERLANG_SUBST_LIB_DIR}
+macro is:
@example
AC_INIT([LibdirTest], [1.0], [bug-libdirtest@@example.org])
@@ -8346,6 +8402,7 @@ output.
@defmac AC_DEFINE (@var{variable}, @var{value}, @ovar{description})
@defmacx AC_DEFINE (@var{variable})
address@hidden @var{variable}
@acindex{DEFINE}
Define @var{variable} to @var{value} (verbatim), by defining a C
preprocessor macro for @var{variable}. @var{variable} should be a C
@@ -8388,6 +8445,7 @@ the last one wins.
@defmac AC_DEFINE_UNQUOTED (@var{variable}, @var{value}, @ovar{description})
@defmacx AC_DEFINE_UNQUOTED (@var{variable})
@acindex{DEFINE_UNQUOTED}
address@hidden @var{variable}
Like @code{AC_DEFINE}, but three shell expansions are
performed---once---on @var{variable} and @var{value}: variable expansion
(@samp{$}), command substitution (@samp{`}), and backslash escaping
@@ -8567,9 +8625,9 @@ and similarly if the variable is unset,
line argument, including when no cache is used:
@example
-$ @kbd{CC=/usr/bin/cc ./configure undeclared_var=raboof --silent}
+$ @kbd{CC=/usr/bin/cc ./configure var=raboof --silent}
$ @kbd{./config.status --recheck}
-running CONFIG_SHELL=/bin/sh /bin/sh ./configure undeclared_var=raboof \
+running CONFIG_SHELL=/bin/sh /bin/sh ./configure var=raboof \
CC=/usr/bin/cc --no-create --no-recursion
@end example
@end itemize
@@ -8635,7 +8693,8 @@ The @var{commands-to-set-it} @emph{must
setting the variable @var{cache-id}, see below.
@end defmac
address@hidden AC_CACHE_CHECK (@var{message}, @var{cache-id},
@var{commands-to-set-
it})
address@hidden AC_CACHE_CHECK (@var{message}, @var{cache-id}, @
+ @var{commands-to-set-it})
@acindex{CACHE_CHECK}
A wrapper for @code{AC_CACHE_VAL} that takes care of printing the
messages. This macro provides a convenient shorthand for the most
@@ -9871,8 +9930,13 @@ M4sugar''.
@subsection Redefined M4 Macros
@msindex{builtin}
address@hidden
address@hidden
address@hidden
address@hidden
@msindex{decr}
@msindex{define}
address@hidden
@msindex{dumpdef}
@msindex{errprint}
@msindex{esyscmd}
@@ -9888,6 +9952,8 @@ M4sugar''.
@msindex{substr}
@msindex{syscmd}
@msindex{sysval}
address@hidden
address@hidden
@msindex{translit}
@msindex{undefine}
With a few exceptions, all the M4 native macros are moved in the
@@ -9908,6 +9974,9 @@ Unlike the M4 builtin, this macro fails
defined. See @code{m4_undefine}.
@end defmac
address@hidden FIXME: Need to document m4_divert, m4_undivert, m4_divert_push,
address@hidden m4_divert_pop, m4_divert_text, m4_divert_once
+
@defmac m4_exit (@var{exit-status})
@msindex{exit}
This macro corresponds to @code{m4exit}.
@@ -10007,7 +10076,8 @@ underlying M4 provides.
The following macros implement loops in M4.
address@hidden m4_for (@var{var}, @var{first}, @var{last}, @ovar{step}, @var
{expression})
address@hidden m4_for (@var{var}, @var{first}, @var{last}, @ovar{step}, @
+ @var{expression})
@msindex{for}
Loop over the numeric values between @var{first} and @var{last}
including bounds by increments of @var{step}. For each iteration,
@@ -10224,7 +10294,8 @@ environment variables, or setting option
implementation-specific actions.
@end defmac
address@hidden AS_CASE (@var{word}, @ovar{pattern1}, @ovar{if-matched1},
@dots{},
@ovar{default})
address@hidden AS_CASE (@var{word}, @ovar{pattern1}, @ovar{if-matched1}, @
+ @dots{}, @ovar{default})
@asindex{CASE}
Expand into a shell @samp{case} statement, where @var{word} is matched
against one or more patterns. @var{if-matched} is run if the
@@ -11260,7 +11331,8 @@ of @address@hidden@}}. If the end of the v
boundary, the shell reports an error, as if you used @address@hidden@}}.
Instead of @address@hidden@}}, the shell may expand
@address@hidden@}}, or even @address@hidden@}}. This bug can often
-be worked around by omitting the braces: @code{$variable}. The bug was fixed
in
+be worked around by omitting the braces: @code{$variable}. The bug was
+fixed in
@samp{ksh93g} (1998-04-30) but as of 2006 many operating systems were
still shipping older versions with the bug.
@@ -11374,8 +11446,8 @@ Don't rely on file descriptors 0, 1, and
subsidiary program. If any of these descriptors is closed, the
operating system may open an unspecified file for the descriptor in the
new process image. Posix says this may be done only if the subsidiary
-program is set-user-ID or set-group-ID, but @acronym{HP-UX} 11.23 does it even
for
-ordinary programs.
+program is set-user-ID or set-group-ID, but @acronym{HP-UX} 11.23 does
+it even for ordinary programs.
Don't rely on open file descriptors being open in child processes. In
@command{ksh}, file descriptors above 2 which are opened using
@@ -12840,7 +12912,8 @@ Also please see the discussion of the @c
With the address@hidden 6.0 shell, the @command{set} command (without
any options) does not sort its output.
-The @command{set} builtin faces the usual problem with arguments starting with
a
+The @command{set} builtin faces the usual problem with arguments
+starting with a
dash. Modern shells such as Bash or Zsh understand @option{--} to specify
the end of the options (any argument after @option{--} is a parameter,
even @samp{-x} for instance), but many traditional shells (e.g., Solaris
@@ -12972,7 +13045,8 @@ not null, but this usage is not portable
Solaris 10 @command{/bin/sh}, which mishandle strings like @samp{!} and
@samp{-n}.
-Posix says that @samp{test ! "@var{string}"}, @samp{test -n "@var{string}"} and
+Posix also says that @samp{test ! "@var{string}"},
address@hidden -n "@var{string}"} and
@samp{test -z "@var{string}"} work with any string, but many
shells (such as Solaris, @acronym{AIX} 3.2, @sc{unicos} 10.0.0.6,
Digital Unix 4, etc.)@: get confused if
@@ -12985,7 +13059,7 @@ $ @kbd{test ! -n}
test: argument expected
@end example
-Similarly, Posix says that @samp{test "@var{string1}" = "@var{string2"}}
+Similarly, Posix says that both @samp{test "@var{string1}" = "@var{string2"}}
and @samp{test "@var{string1}" != "@var{string2"}} work for any pairs of
strings, but in practice this is not true for troublesome strings that
look like operators or parentheses, or that begin with @samp{-}.
@@ -13182,7 +13256,8 @@ bar
foo
@end example
-Some Awk implementations, such as @acronym{HP-UX} 11.0's native one, mishandle
anchors:
+Some Awk implementations, such as @acronym{HP-UX} 11.0's native one,
+mishandle anchors:
@example
$ @kbd{echo xfoo | $AWK '/foo|^bar/ @{ print @}'}
@@ -13533,7 +13608,7 @@ expr a : '\(b\)' \| ''
Unfortunately this behaves exactly as the original expression; see the
@command{expr} (@samp{|}) entry for more information.
-Ancient @command{expr} implementations (e.g., SunOS 4 @command{expr} and
+Some ancient @command{expr} implementations (e.g., SunOS 4 @command{expr} and
Solaris 8 @command{/usr/ucb/expr}) have a silly length limit that causes
@command{expr} to fail if the matched substring is longer than 120
bytes. In this case, you might want to fall back on @samp{echo|sed} if
@@ -16012,7 +16087,8 @@ should call @code{AC_ARG_WITH} to detect
user asked to use it. Whether each package is used or not by default,
and which arguments are valid, is up to you.
address@hidden AC_ARG_WITH (@var{package}, @var{help-string},
@ovar{action-if-given},
@ovar{action-if-not-given})
address@hidden AC_ARG_WITH (@var{package}, @var{help-string}, @
+ @ovar{action-if-given}, @ovar{action-if-not-given})
@acindex{ARG_WITH}
If the user gave @command{configure} the option @address@hidden
or @address@hidden, run shell commands
@@ -16126,7 +16202,8 @@ These three examples can be easily adapt
@ref{Package Options}).
@end defmac
address@hidden AC_WITH (@var{package}, @var{action-if-given},
@ovar{action-if-not-
given})
address@hidden AC_WITH (@var{package}, @var{action-if-given}, @
+ @ovar{action-if-not-given})
@acindex{WITH}
This is an obsolete version of @code{AC_ARG_WITH} that does not
support providing a help string.
@@ -16171,7 +16248,8 @@ For each optional feature, @file{configu
to include it. Whether each feature is included or not by default, and
which arguments are valid, is up to you.
address@hidden AC_ARG_ENABLE (@var{feature}, @var{help-string}, @ovar{action-if-
given}, @ovar{action-if-not-given})
address@hidden AC_ARG_ENABLE (@var{feature}, @var{help-string}, @
+ @ovar{action-if-given}, @ovar{action-if-not-given})
@acindex{ARG_ENABLE}
If the user gave @command{configure} the option
@address@hidden or @address@hidden, run
@@ -16196,7 +16274,8 @@ See the examples suggested with the defi
@code{AC_ARG_ENABLE}.
@end defmac
address@hidden AC_ENABLE (@var{feature}, @var{action-if-given},
@ovar{action-if-not-
given})
address@hidden AC_ENABLE (@var{feature}, @var{action-if-given}, @
+ @ovar{action-if-not-given})
@acindex{ENABLE}
This is an obsolete version of @code{AC_ARG_ENABLE} that does not
support providing a help string.
@@ -16215,7 +16294,7 @@ your own @samp{help strings} to line up
strings} do. This is the purpose of the @code{AS_HELP_STRING} macro.
@defmac AS_HELP_STRING (@var{left-hand-side}, @var{right-hand-side})
address@hidden
address@hidden
Expands into an help string that looks pretty when the user executes
@samp{configure --help}. It is typically used in @code{AC_ARG_WITH}
@@ -16277,16 +16356,15 @@ Even a warning message is undesirable he
automatically disables the warnings.
This default behavior may be modified in two ways. First, the installer
-can invoke @command{configure} with the
address@hidden or
address@hidden options to disable these
-warnings or turn them into fatal errors, respectively. Second, the
+can invoke @command{configure --disable-option-checking} to disable
+these warnings, or invoke @command{configure --enable-option-checking=fatal}
+options to turn them into fatal errors, respectively. Second, the
maintainer can use @code{AC_DISABLE_OPTION_CHECKING}.
@defmac AC_DISABLE_OPTION_CHECKING
@acindex{DISABLE_OPTION_CHECKING}
-By default, disable warnings for unrecognized
+By default, disable warnings related to any unrecognized
@address@hidden or @address@hidden
options. This is implied by @code{AC_CONFIG_SUBDIRS}.
@@ -16990,7 +17068,8 @@ typedef loff_t off_t;
Same as @samp{AC_MSG_NOTICE([checking @address@hidden
@end defmac
address@hidden AC_COMPILE_CHECK (@var{echo-text}, @var{includes}, @var{function-
body}, @var{action-if-true}, @ovar{action-if-false})
address@hidden AC_COMPILE_CHECK (@var{echo-text}, @var{includes}, @
+ @var{function-body}, @var{action-if-true}, @ovar{action-if-false})
@acindex{COMPILE_CHECK}
This is an obsolete version of @code{AC_TRY_COMPILE} itself replaced by
@code{AC_COMPILE_IFELSE} (@pxref{Running the Compiler}), with the
@@ -17058,7 +17137,7 @@ Does nothing, now integrated in @code{AC
@cvindex SYSNDIR
@cvindex SYSDIR
@cvindex NDIR
-Like calling @code{AC_FUNC_CLOSEDIR_VOID} address@hidden,
+Like calling @code{AC_FUNC_CLOSEDIR_VOID} and @code{AC_HEADER_DIRENT},
but defines a different set of C preprocessor macros to indicate which
header file is found:
@@ -17172,7 +17251,8 @@ These days portable programs should use
@code{AC_CHECK_HEADERS}
@end defmac
address@hidden AC_HAVE_LIBRARY (@var{library}, @ovar{action-if-found},
@ovar{action-
if-not-found}, @ovar{other-libraries})
address@hidden AC_HAVE_LIBRARY (@var{library}, @ovar{action-if-found}, @
+ @ovar{action-if-not-found}, @ovar{other-libraries})
@acindex{HAVE_LIBRARY}
This macro is equivalent to calling @code{AC_CHECK_LIB} with a
@var{function} argument of @code{main}. In addition, @var{library} can
@@ -17605,7 +17685,8 @@ issue.
@code{AC_HEADER_TIME}
@end defmac
address@hidden AC_TRY_COMPILE (@var{includes}, @var{function-body},
@ovar{action-if-
true}, @ovar{action-if-false})
address@hidden AC_TRY_COMPILE (@var{includes}, @var{function-body}, @
+ @ovar{action-if-true}, @ovar{action-if-false})
@acindex{TRY_COMPILE}
Same as:
@@ -17646,7 +17727,8 @@ AC_PREPROC_IFELSE(
This macro double quotes the @var{input}.
@end defmac
address@hidden AC_TRY_LINK (@var{includes}, @var{function-body},
@ovar{action-if-
true}, @ovar{action-if-false})
address@hidden AC_TRY_LINK (@var{includes}, @var{function-body}, @
+ @ovar{action-if-true}, @ovar{action-if-false})
@acindex{TRY_LINK}
Same as:
@@ -17679,14 +17761,16 @@ and compilation flags are determined by
@code{LIBS} are used for linking.
@end defmac
address@hidden AC_TRY_LINK_FUNC (@var{function}, @ovar{action-if-found},
@ovar{action-
if-not-found})
address@hidden AC_TRY_LINK_FUNC (@var{function}, @ovar{action-if-found}, @
+ @ovar{action-if-not-found})
@acindex{TRY_LINK_FUNC}
This macro is equivalent to
@samp{AC_LINK_IFELSE([AC_LANG_CALL([], address@hidden)],
address@hidden, address@hidden)}.
@end defmac
address@hidden AC_TRY_RUN (@var{program}, @ovar{action-if-true},
@ovar{action-if-
false}, @ovar{action-if-cross-compiling})
address@hidden AC_TRY_RUN (@var{program}, @ovar{action-if-true}, @
+ @ovar{action-if-false}, @ovar{action-if-cross-compiling})
@acindex{TRY_RUN}
Same as:
@@ -18684,7 +18768,8 @@ brackets to protect against included com
expansion. The contents ought to end with an end of line.
@end defmac
address@hidden AT_CHECK (@var{commands}, @dvar{status, 0}, @dvar{stdout, },
@dvar
{stderr, }, @ovar{run-if-fail}, @ovar{run-if-pass})
address@hidden AT_CHECK (@var{commands}, @dvar{status, 0}, @dvar{stdout, }, @
+ @dvar{stderr, }, @ovar{run-if-fail}, @ovar{run-if-pass})
@atindex{CHECK}
Execute a test by performing given shell @var{commands}. These commands
should normally exit with @var{status}, while producing expected
@@ -18928,8 +19013,8 @@ and manage to have @file{atconfig.in} an
distributed.
With all this in place, and if you have not initialized @samp{TESTSUITEFLAGS}
-within your makefile, you can fine-tune test suite execution with this
variable,
-for example:
+within your makefile, you can fine-tune test suite execution with this
+variable, for example:
@example
make check TESTSUITEFLAGS='-v -d -x 75 -k AC_PROG_CC CFLAGS=-g'
@@ -19645,7 +19730,7 @@ preceding @samp{AT_}.
@node Program & Function Index
@appendixsec Program and Function Index
-This is an alphabetical list of the programs and functions which
+This is an alphabetical list of the programs and functions whose
portability is discussed in this document.
@printindex pr
- texinfo cleanups,
Eric Blake <=