FYI: invoking aclocal subsections

[Alexandre Duret-Lutz]

For some reason I can't use `#serial' in menu entries.  Emacs's
texinfo-all-menus-update would remove the description.

2005-02-06  Alexandre Duret-Lutz  <address@hidden>

        * doc/automake.texi (aclocal options, Macro search path,
        Extending aclocal, Local Macros, Serials, Future of aclocal): Make
        these subsection of ...
        (Invoking aclocal): ... this.

Index: doc/automake.texi
===================================================================
RCS file: /cvs/automake/automake/doc/automake.texi,v
retrieving revision 1.92
diff -u -r1.92 automake.texi
--- doc/automake.texi   6 Feb 2005 10:22:29 -0000       1.92
+++ doc/automake.texi   6 Feb 2005 10:30:38 -0000
@@ -135,18 +135,16 @@
 * Requirements::                Configuration requirements
 * Optional::                    Other things Automake recognizes
 * Invoking aclocal::            Auto-generating aclocal.m4
-* aclocal options::             aclocal command line arguments
-* Macro search path::           Modifying aclocal's search path
 * Macros::                      Autoconf macros supplied with Automake
-* Extending aclocal::           Writing your own aclocal macros
-* Local Macros::                Organizing local macros
-* Serials::                     #serial lines in Autoconf macros
-* Future of aclocal::           aclocal's scheduled death
 
 Auto-generating aclocal.m4
 
 * aclocal options::             Options supported by aclocal
 * Macro search path::           How aclocal finds .m4 files
+* Extending aclocal::           Writing your own aclocal macros
+* Local Macros::                Organizing local macros
+* Serials::                     Serial lines in Autoconf macros
+* Future of aclocal::           aclocal's scheduled death
 
 Autoconf macros supplied with Automake
 
@@ -1265,13 +1263,7 @@
 * Requirements::                Configuration requirements
 * Optional::                    Other things Automake recognizes
 * Invoking aclocal::            Auto-generating aclocal.m4
-* aclocal options::             aclocal command line arguments
-* Macro search path::           Modifying aclocal's search path
 * Macros::                      Autoconf macros supplied with Automake
-* Extending aclocal::           Writing your own aclocal macros
-* Local Macros::                Organizing local macros
-* Serials::                     #serial lines in Autoconf macros
-* Future of aclocal::           aclocal's scheduled death
 @end menu
 
 
@@ -1634,10 +1626,14 @@
 @menu
 * aclocal options::             Options supported by aclocal
 * Macro search path::           How aclocal finds .m4 files
+* Extending aclocal::           Writing your own aclocal macros
+* Local Macros::                Organizing local macros
+* Serials::                     Serial lines in Autoconf macros
+* Future of aclocal::           aclocal's scheduled death
 @end menu
 
 @node aclocal options
address@hidden aclocal options
address@hidden aclocal options
 
 @cindex @command{aclocal}, Options
 @cindex Options, @command{aclocal}
@@ -1730,7 +1726,7 @@
 @end table
 
 @node Macro search path
address@hidden Macro search path
address@hidden Macro search path
 
 @cindex Macro search path
 @cindex @command{aclocal} search path
@@ -1764,7 +1760,7 @@
 As explained in (@pxref{aclocal options}), there are several options that
 can be used to change or extend this search path.
 
address@hidden Modifying the macro search path: @code{--acdir}
address@hidden Modifying the macro search path: @code{--acdir}
 
 The most erroneous option to modify the search path is
 @address@hidden, which changes default directory and
@@ -1778,7 +1774,7 @@
 This option, @code{--acdir}, is intended for use by the internal
 automake test suite only; it is not ordinarily needed by end-users.
 
address@hidden Modifying the macro search path: @code{-I @var{dir}}
address@hidden Modifying the macro search path: @code{-I @var{dir}}
 
 Any extra directories specified using @code{-I} options
 (@pxref{aclocal options}) are @emph{prepended} to this search list.  Thus,
@@ -1791,7 +1787,7 @@
 @item @var{acdir}
 @end enumerate
 
address@hidden Modifying the macro search path: @file{dirlist}
address@hidden Modifying the macro search path: @file{dirlist}
 @cindex @file{dirlist}
 
 There is a third mechanism for customizing the search path.  If a
@@ -1871,239 +1867,8 @@
 macros installed at other places on the system.
 
 
address@hidden Macros
address@hidden Autoconf macros supplied with Automake
-
-Automake ships with several Autoconf macros that you can use from your
address@hidden  When you use one of them it will be included by
address@hidden in @file{aclocal.m4}.
-
address@hidden
-* Public macros::               Macros that you can use.
-* Private macros::              Macros that you should not use.
address@hidden menu
-
address@hidden consider generating the following subsections automatically from 
m4 files.
-
address@hidden Public macros
address@hidden Public macros
-
address@hidden @code
address@hidden AM_CONFIG_HEADER
address@hidden AM_CONFIG_HEADER
-Automake will generate rules to automatically regenerate the config
-header.  This obsolete macro is a synonym of @code{AC_CONFIG_HEADERS}
-today (@pxref{Optional}).
-
address@hidden AM_ENABLE_MULTILIB
address@hidden AM_ENABLE_MULTILIB
-This is used when a ``multilib'' library is being built.  The first
-optional argument is the name of the @file{Makefile} being generated; it
-defaults to @samp{Makefile}.  The second option argument is used to find
-the top source directory; it defaults to the empty string (generally
-this should not be used unless you are familiar with the internals).
address@hidden
-
address@hidden AM_C_PROTOTYPES
address@hidden AM_C_PROTOTYPES
address@hidden ANSI2KNR
address@hidden U
-Check to see if function prototypes are understood by the compiler.  If
-so, define @samp{PROTOTYPES} and set the output variables @samp{U} and
address@hidden to the empty string.  Otherwise, set @samp{U} to
address@hidden and @samp{ANSI2KNR} to @samp{./ansi2knr}.  Automake uses these
-values to implement automatic de-ANSI-fication.
-
address@hidden AM_HEADER_TIOCGWINSZ_NEEDS_SYS_IOCTL
address@hidden AM_HEADER_TIOCGWINSZ_NEEDS_SYS_IOCTL
-If the use of @code{TIOCGWINSZ} requires @file{<sys/ioctl.h>}, then
-define @code{GWINSZ_IN_SYS_IOCTL}.  Otherwise @code{TIOCGWINSZ} can be
-found in @file{<termios.h>}.  This macro is obsolete, you should
-use Autoconf's @code{AC_HEADER_TIOCGWINSZ} instead.
-
address@hidden AM_INIT_AUTOMAKE([OPTIONS])
address@hidden AM_INIT_AUTOMAKE(PACKAGE, VERSION, [NO-DEFINE])
address@hidden AM_INIT_AUTOMAKE
-Runs many macros required for proper operation of the generated Makefiles.
-
address@hidden AUTOMAKE_OPTIONS
-This macro has two forms, the first of which is preferred.
-In this form, @code{AM_INIT_AUTOMAKE} is called with a
-single argument --- a space-separated list of Automake options which should
-be applied to every @file{Makefile.am} in the tree.  The effect is as if
-each option were listed in @code{AUTOMAKE_OPTIONS} (@pxref{Options}).
-
address@hidden AC_INIT
-The second, deprecated, form of @code{AM_INIT_AUTOMAKE} has two required
-arguments: the package and the version number.  This form is
-obsolete because the @var{package} and @var{version} can be obtained
-from Autoconf's @code{AC_INIT} macro (which itself has an old and a new
-form).
-
-If your @file{configure.ac} has:
-
address@hidden
-AC_INIT(src/foo.c)
-AM_INIT_AUTOMAKE(mumble, 1.5)
address@hidden example
-
address@hidden
-you can modernize it as follows:
-
address@hidden
-AC_INIT(mumble, 1.5)
-AC_CONFIG_SRCDIR(src/foo.c)
-AM_INIT_AUTOMAKE
address@hidden example
-
-Note that if you're upgrading your @file{configure.ac} from an earlier
-version of Automake, it is not always correct to simply move the package
-and version arguments from @code{AM_INIT_AUTOMAKE} directly to
address@hidden, as in the example above.  The first argument to
address@hidden should be the name of your package (e.g. @samp{GNU Automake}),
-not the tarball name (e.g. @samp{automake}) that you used to pass to
address@hidden  Autoconf tries to derive a tarball name from
-the package name, which should work for most but not all package names.
-(If it doesn't work for yours, you can use the
-four-argument form of @code{AC_INIT} --- supported in Autoconf versions
-greater than 2.52g --- to provide the tarball name explicitly).
-
address@hidden @code{PACKAGE}, prevent definition
address@hidden @code{VERSION}, prevent definition
address@hidden no-define
-By default this macro @code{AC_DEFINE}'s @samp{PACKAGE} and
address@hidden  This can be avoided by passing the @samp{no-define}
-option, as in:
address@hidden
-AM_INIT_AUTOMAKE([gnits 1.5 no-define dist-bzip2])
address@hidden example
-or by passing a third non-empty argument to the obsolete form.
-
address@hidden AM_PATH_LISPDIR
address@hidden AM_PATH_LISPDIR
address@hidden EMACS
address@hidden lispdir
-Searches for the program @code{emacs}, and, if found, sets the output
-variable @code{lispdir} to the full path to Emacs' site-lisp directory.
-
-Note that this test assumes the @code{emacs} found to be a version that
-supports Emacs Lisp (such as @sc{gnu} Emacs or XEmacs).  Other emacsen
-can cause this test to hang (some, like old versions of MicroEmacs,
-start up in interactive mode, requiring @samp{C-x C-c} to exit, which
-is hardly obvious for a non-emacs user).  In most cases, however, you
-should be able to use @samp{C-c} to kill the test.  In order to avoid
-problems, you can set @code{EMACS} to ``no'' in the environment, or
-use the @samp{--with-lispdir} option to @command{configure} to
-explicitly set the correct path (if you're sure you have an @code{emacs}
-that supports Emacs Lisp.
-
address@hidden AM_PROG_AS
address@hidden AM_PROG_AS
address@hidden CCAS
address@hidden CCASFLAGS
-Use this macro when you have assembly code in your project.  This will
-choose the assembler for you (by default the C compiler) and set
address@hidden, and will also set @code{CCASFLAGS} if required.
-
address@hidden AM_PROG_CC_C_O
address@hidden AM_PROG_CC_C_O
address@hidden AC_PROG_CC_C_O
-This is like @code{AC_PROG_CC_C_O}, but it generates its results in
-the manner required by automake.  You must use this instead of
address@hidden when you need this functionality, that is, when
-using per-target flags or subdir-objects with C sources.
-
address@hidden AM_PROG_LEX
address@hidden AM_PROG_LEX
address@hidden AC_PROG_LEX
address@hidden HP-UX 10, @command{lex} problems
address@hidden @command{lex} problems with HP-UX 10
-Like @code{AC_PROG_LEX} (@pxref{Particular Programs, , Particular
-Program Checks, autoconf, The Autoconf Manual}), but uses the
address@hidden script on systems that do not have @code{lex}.
address@hidden 10} is one such system.
-
address@hidden AM_PROG_GCJ
address@hidden AM_PROG_GCJ
address@hidden GCJ
address@hidden GCJFLAGS
-This macro finds the @code{gcj} program or causes an error.  It sets
address@hidden and @samp{GCJFLAGS}.  @code{gcj} is the Java front-end to the
-GNU Compiler Collection.
-
address@hidden AM_SYS_POSIX_TERMIOS
address@hidden AM_SYS_POSIX_TERMIOS
address@hidden POSIX termios headers
address@hidden termios POSIX headers
-Check to see if POSIX termios headers and functions are available on the
-system.  If so, set the shell variable @code{am_cv_sys_posix_termios} to
address@hidden  If not, set the variable to @samp{no}.  This macro is obsolete,
-you should use Autoconf's @code{AC_SYS_POSIX_TERMIOS} instead.
-
address@hidden AM_WITH_DMALLOC
address@hidden AM_WITH_DMALLOC
address@hidden @command{dmalloc}, support for
address@hidden WITH_DMALLOC
address@hidden --with-dmalloc
-Add support for the
address@hidden://ftp.letters.com/src/dmalloc/dmalloc.tar.gz, dmalloc}
-package.  If the user configures with @samp{--with-dmalloc}, then define
address@hidden and add @samp{-ldmalloc} to @code{LIBS}.
-
address@hidden AM_WITH_REGEX
address@hidden AM_WITH_REGEX
address@hidden WITH_REGEX
address@hidden --with-regex
address@hidden regex package
address@hidden rx package
-Adds @samp{--with-regex} to the @code{configure} command line.  If
-specified (the default), then the @samp{regex} regular expression
-library is used, @file{regex.o} is put into @samp{LIBOBJS}, and
address@hidden is defined.  If @samp{--without-regex} is given, then
-the @samp{rx} regular expression library is used, and @file{rx.o} is put
-into @samp{LIBOBJS}.
-
address@hidden table
-
address@hidden Private macros
address@hidden Private macros
-
-The following macros are private macros you should not call directly.
-They are called by the other public macros when appropriate.  Do not
-rely on them, as they might be changed in a future version.  Consider
-them as implementation details; or better, do not consider them at all:
-skip this section!
-
address@hidden @code
address@hidden _AM_DEPENDENCIES
address@hidden AM_SET_DEPDIR
address@hidden AM_DEP_TRACK
address@hidden AM_OUTPUT_DEPENDENCY_COMMANDS
-These macros are used to implement Automake's automatic dependency
-tracking scheme.  They are called automatically by automake when
-required, and there should be no need to invoke them manually.
-
address@hidden AM_MAKE_INCLUDE
-This macro is used to discover how the user's @code{make} handles
address@hidden statements.  This macro is automatically invoked when
-needed; there should be no need to invoke it manually.
-
address@hidden AM_PROG_INSTALL_STRIP
-This is used to find a version of @code{install} which can be used to
address@hidden a program at installation time.  This macro is
-automatically included when required.
-
address@hidden AM_SANITY_CHECK
-This checks to make sure that a file created in the build directory is
-newer than a file in the source directory.  This can fail on systems
-where the clock is set incorrectly.  This macro is automatically run
-from @code{AM_INIT_AUTOMAKE}.
-
address@hidden ftable
-
-
 @node Extending aclocal
address@hidden Writing your own aclocal macros
address@hidden Writing your own aclocal macros
 
 @cindex @command{aclocal}, extending
 @cindex Extending @command{aclocal}
@@ -2188,7 +1953,7 @@
 Macros}.
 
 @node Local Macros
address@hidden Handling Local Macros
address@hidden Handling Local Macros
 
 Feature tests offered by Autoconf do not cover all needs.  People
 often have to supplement existing tests with their own macros, or
@@ -2292,7 +2057,7 @@
 
 
 @node Serials
address@hidden Serial Numbers
address@hidden Serial Numbers
 @cindex serial numbers in macros
 @cindex macro serial numbers
 @cindex @code{#serial} syntax
@@ -2441,7 +2206,7 @@
 
 
 @node Future of aclocal
address@hidden The Future of @command{aclocal}
address@hidden The Future of @command{aclocal}
 @cindex @command{aclocal}'s scheduled death
 
 @command{aclocal} is expected to disappear.  This feature really
@@ -2489,6 +2254,237 @@
 
 
 
address@hidden Macros
address@hidden Autoconf macros supplied with Automake
+
+Automake ships with several Autoconf macros that you can use from your
address@hidden  When you use one of them it will be included by
address@hidden in @file{aclocal.m4}.
+
address@hidden
+* Public macros::               Macros that you can use.
+* Private macros::              Macros that you should not use.
address@hidden menu
+
address@hidden consider generating the following subsections automatically from 
m4 files.
+
address@hidden Public macros
address@hidden Public macros
+
address@hidden @code
address@hidden AM_CONFIG_HEADER
address@hidden AM_CONFIG_HEADER
+Automake will generate rules to automatically regenerate the config
+header.  This obsolete macro is a synonym of @code{AC_CONFIG_HEADERS}
+today (@pxref{Optional}).
+
address@hidden AM_ENABLE_MULTILIB
address@hidden AM_ENABLE_MULTILIB
+This is used when a ``multilib'' library is being built.  The first
+optional argument is the name of the @file{Makefile} being generated; it
+defaults to @samp{Makefile}.  The second option argument is used to find
+the top source directory; it defaults to the empty string (generally
+this should not be used unless you are familiar with the internals).
address@hidden
+
address@hidden AM_C_PROTOTYPES
address@hidden AM_C_PROTOTYPES
address@hidden ANSI2KNR
address@hidden U
+Check to see if function prototypes are understood by the compiler.  If
+so, define @samp{PROTOTYPES} and set the output variables @samp{U} and
address@hidden to the empty string.  Otherwise, set @samp{U} to
address@hidden and @samp{ANSI2KNR} to @samp{./ansi2knr}.  Automake uses these
+values to implement automatic de-ANSI-fication.
+
address@hidden AM_HEADER_TIOCGWINSZ_NEEDS_SYS_IOCTL
address@hidden AM_HEADER_TIOCGWINSZ_NEEDS_SYS_IOCTL
+If the use of @code{TIOCGWINSZ} requires @file{<sys/ioctl.h>}, then
+define @code{GWINSZ_IN_SYS_IOCTL}.  Otherwise @code{TIOCGWINSZ} can be
+found in @file{<termios.h>}.  This macro is obsolete, you should
+use Autoconf's @code{AC_HEADER_TIOCGWINSZ} instead.
+
address@hidden AM_INIT_AUTOMAKE([OPTIONS])
address@hidden AM_INIT_AUTOMAKE(PACKAGE, VERSION, [NO-DEFINE])
address@hidden AM_INIT_AUTOMAKE
+Runs many macros required for proper operation of the generated Makefiles.
+
address@hidden AUTOMAKE_OPTIONS
+This macro has two forms, the first of which is preferred.
+In this form, @code{AM_INIT_AUTOMAKE} is called with a
+single argument --- a space-separated list of Automake options which should
+be applied to every @file{Makefile.am} in the tree.  The effect is as if
+each option were listed in @code{AUTOMAKE_OPTIONS} (@pxref{Options}).
+
address@hidden AC_INIT
+The second, deprecated, form of @code{AM_INIT_AUTOMAKE} has two required
+arguments: the package and the version number.  This form is
+obsolete because the @var{package} and @var{version} can be obtained
+from Autoconf's @code{AC_INIT} macro (which itself has an old and a new
+form).
+
+If your @file{configure.ac} has:
+
address@hidden
+AC_INIT(src/foo.c)
+AM_INIT_AUTOMAKE(mumble, 1.5)
address@hidden example
+
address@hidden
+you can modernize it as follows:
+
address@hidden
+AC_INIT(mumble, 1.5)
+AC_CONFIG_SRCDIR(src/foo.c)
+AM_INIT_AUTOMAKE
address@hidden example
+
+Note that if you're upgrading your @file{configure.ac} from an earlier
+version of Automake, it is not always correct to simply move the package
+and version arguments from @code{AM_INIT_AUTOMAKE} directly to
address@hidden, as in the example above.  The first argument to
address@hidden should be the name of your package (e.g. @samp{GNU Automake}),
+not the tarball name (e.g. @samp{automake}) that you used to pass to
address@hidden  Autoconf tries to derive a tarball name from
+the package name, which should work for most but not all package names.
+(If it doesn't work for yours, you can use the
+four-argument form of @code{AC_INIT} --- supported in Autoconf versions
+greater than 2.52g --- to provide the tarball name explicitly).
+
address@hidden @code{PACKAGE}, prevent definition
address@hidden @code{VERSION}, prevent definition
address@hidden no-define
+By default this macro @code{AC_DEFINE}'s @samp{PACKAGE} and
address@hidden  This can be avoided by passing the @samp{no-define}
+option, as in:
address@hidden
+AM_INIT_AUTOMAKE([gnits 1.5 no-define dist-bzip2])
address@hidden example
+or by passing a third non-empty argument to the obsolete form.
+
address@hidden AM_PATH_LISPDIR
address@hidden AM_PATH_LISPDIR
address@hidden EMACS
address@hidden lispdir
+Searches for the program @code{emacs}, and, if found, sets the output
+variable @code{lispdir} to the full path to Emacs' site-lisp directory.
+
+Note that this test assumes the @code{emacs} found to be a version that
+supports Emacs Lisp (such as @sc{gnu} Emacs or XEmacs).  Other emacsen
+can cause this test to hang (some, like old versions of MicroEmacs,
+start up in interactive mode, requiring @samp{C-x C-c} to exit, which
+is hardly obvious for a non-emacs user).  In most cases, however, you
+should be able to use @samp{C-c} to kill the test.  In order to avoid
+problems, you can set @code{EMACS} to ``no'' in the environment, or
+use the @samp{--with-lispdir} option to @command{configure} to
+explicitly set the correct path (if you're sure you have an @code{emacs}
+that supports Emacs Lisp.
+
address@hidden AM_PROG_AS
address@hidden AM_PROG_AS
address@hidden CCAS
address@hidden CCASFLAGS
+Use this macro when you have assembly code in your project.  This will
+choose the assembler for you (by default the C compiler) and set
address@hidden, and will also set @code{CCASFLAGS} if required.
+
address@hidden AM_PROG_CC_C_O
address@hidden AM_PROG_CC_C_O
address@hidden AC_PROG_CC_C_O
+This is like @code{AC_PROG_CC_C_O}, but it generates its results in
+the manner required by automake.  You must use this instead of
address@hidden when you need this functionality, that is, when
+using per-target flags or subdir-objects with C sources.
+
address@hidden AM_PROG_LEX
address@hidden AM_PROG_LEX
address@hidden AC_PROG_LEX
address@hidden HP-UX 10, @command{lex} problems
address@hidden @command{lex} problems with HP-UX 10
+Like @code{AC_PROG_LEX} (@pxref{Particular Programs, , Particular
+Program Checks, autoconf, The Autoconf Manual}), but uses the
address@hidden script on systems that do not have @code{lex}.
address@hidden 10} is one such system.
+
address@hidden AM_PROG_GCJ
address@hidden AM_PROG_GCJ
address@hidden GCJ
address@hidden GCJFLAGS
+This macro finds the @code{gcj} program or causes an error.  It sets
address@hidden and @samp{GCJFLAGS}.  @code{gcj} is the Java front-end to the
+GNU Compiler Collection.
+
address@hidden AM_SYS_POSIX_TERMIOS
address@hidden AM_SYS_POSIX_TERMIOS
address@hidden POSIX termios headers
address@hidden termios POSIX headers
+Check to see if POSIX termios headers and functions are available on the
+system.  If so, set the shell variable @code{am_cv_sys_posix_termios} to
address@hidden  If not, set the variable to @samp{no}.  This macro is obsolete,
+you should use Autoconf's @code{AC_SYS_POSIX_TERMIOS} instead.
+
address@hidden AM_WITH_DMALLOC
address@hidden AM_WITH_DMALLOC
address@hidden @command{dmalloc}, support for
address@hidden WITH_DMALLOC
address@hidden --with-dmalloc
+Add support for the
address@hidden://ftp.letters.com/src/dmalloc/dmalloc.tar.gz, dmalloc}
+package.  If the user configures with @samp{--with-dmalloc}, then define
address@hidden and add @samp{-ldmalloc} to @code{LIBS}.
+
address@hidden AM_WITH_REGEX
address@hidden AM_WITH_REGEX
address@hidden WITH_REGEX
address@hidden --with-regex
address@hidden regex package
address@hidden rx package
+Adds @samp{--with-regex} to the @code{configure} command line.  If
+specified (the default), then the @samp{regex} regular expression
+library is used, @file{regex.o} is put into @samp{LIBOBJS}, and
address@hidden is defined.  If @samp{--without-regex} is given, then
+the @samp{rx} regular expression library is used, and @file{rx.o} is put
+into @samp{LIBOBJS}.
+
address@hidden table
+
address@hidden Private macros
address@hidden Private macros
+
+The following macros are private macros you should not call directly.
+They are called by the other public macros when appropriate.  Do not
+rely on them, as they might be changed in a future version.  Consider
+them as implementation details; or better, do not consider them at all:
+skip this section!
+
address@hidden @code
address@hidden _AM_DEPENDENCIES
address@hidden AM_SET_DEPDIR
address@hidden AM_DEP_TRACK
address@hidden AM_OUTPUT_DEPENDENCY_COMMANDS
+These macros are used to implement Automake's automatic dependency
+tracking scheme.  They are called automatically by automake when
+required, and there should be no need to invoke them manually.
+
address@hidden AM_MAKE_INCLUDE
+This macro is used to discover how the user's @code{make} handles
address@hidden statements.  This macro is automatically invoked when
+needed; there should be no need to invoke it manually.
+
address@hidden AM_PROG_INSTALL_STRIP
+This is used to find a version of @code{install} which can be used to
address@hidden a program at installation time.  This macro is
+automatically included when required.
+
address@hidden AM_SANITY_CHECK
+This checks to make sure that a file created in the build directory is
+newer than a file in the source directory.  This can fail on systems
+where the clock is set incorrectly.  This macro is automatically run
+from @code{AM_INIT_AUTOMAKE}.
+
address@hidden ftable
+
+
 @node Directories
 @chapter Directories
 

-- 
Alexandre Duret-Lutz