* Invoking Automake:: Creating a Makefile.in
* configure:: Scanning configure.ac or configure.in
* Top level:: The top-level Makefile.am
+* Rebuilding:: Automatic rebuilding of Makefile
* Programs:: Building programs and libraries
* Other objects:: Other derived objects
* Other GNU Tools:: Other GNU Tools
installed in @file{$(datadir)/aclocal}.
-@node Top level, Programs, configure, Top
+@node Top level, Rebuilding, configure, Top
@chapter The top-level @file{Makefile.am}
@cindex SUBDIRS, explained
Automake will attempt to set it for you.
-@node Programs, Other objects, Top level, Top
+@node Rebuilding, Programs, Top level, Top
+@chapter Rebuilding Makefiles
+
+Automake generates rules to automatically rebuild @file{Makefile}s,
+@file{configure}, and other derived files like @file{Makefile.in}.
+
+If you are using @code{AM_MAINTAINER_MODE} in @file{configure.in}, then
+these automatic rebuilding rules are only enabled in maintainer mode.
+
+Sometimes you need to run @code{aclocal} with an argument like @code{-I}
+to tell it where to find @file{.m4} files. Since sometimes @code{make}
+will automatically run @code{aclocal}, you need a way to specify these
+arguments. You can do this by defining @code{ACLOCAL_AMFLAGS}; this
+holds arguments which are passed verbatim to @code{aclocal}. This macro
+is only useful in the top-level @file{Makefile.am}.
+@cindex ACLOCAL_AMFLAGS
+
+
+@node Programs, Other objects, Rebuilding, Top
@chapter Building Programs and Libraries
A large part of Automake's functionality is dedicated to making it easy