* Optional:: Other things Automake recognizes
* aclocal Invocation:: Auto-generating aclocal.m4
* Macros:: Autoconf macros supplied with Automake
++* Obsolete Macros:: Obsolete macros you should no longer use
Auto-generating aclocal.m4
@menu
* Public Macros:: Macros that you can use.
-* Obsolete Macros:: Macros that will soon be removed.
* Private Macros:: Macros that you should not use.
++* Obsolete Macros:: Obsolete macros you should no longer use
@end menu
@c consider generating the following subsections automatically from m4 files.
@end table
-@subsection Obsolete Macros
+ @node Obsolete Macros
-@cindex autoupdate
++@subsection Obsolete macros you should no longer use
+ @cindex obsolete macros
-releases, you should not use any of them in new code. @emph{All
-these macros will be removed in the next major Automake version};
-if you are still using them, running @command{autoupdate} should
-adjust your @file{configure.ac} automatically (@pxref{autoupdate
-Invocation, , Using @command{autoupdate} to Modernize
-@file{configure.ac}, autoconf, The Autoconf Manual}).
-@emph{Do it NOW!}
+
+ Although using some of the following macros was required in past
-@item AM_PROG_MKDIR_P
-@acindex AM_PROG_MKDIR_P
-@cindex @code{mkdir -p}, macro check
-@vindex MKDIR_P
-@vindex mkdir_p
-
-From Automake 1.8 to 1.9.6 this macro used to define the output
-variable @code{mkdir_p} to one of @code{mkdir -p}, @code{install-sh
--d}, or @code{mkinstalldirs}.
-
-Nowadays Autoconf provides a similar functionality with
-@code{AC_PROG_MKDIR_P} (@pxref{Particular Programs, , Particular
-Program Checks, autoconf, The Autoconf Manual}), however this defines
-the output variable @code{MKDIR_P} instead. In case you are still
-using the @code{AM_PROG_MKDIR_P} macro in your @file{configure.ac},
-or its provided variable @code{$(mkdir_p)} in your @file{Makefile.am},
-you are advised to switch ASAP to the more modern Autoconf-provided
-interface instead; both the macro and the variable @emph{will be
-removed} in the next major Automake release.
-
++releases, you should not use any of them in new code. Also, all
++these macros will be @emph{removed in some future Automake version},
++so you should consider updating your @file{configure.ac} to avoid
++problems in the future.
+
+ @table @code
+
+ @item AM_PROG_CC_C_O
+ @acindex AM_PROG_CC_C_O
+ @acindex AC_PROG_CC_C_O
+ This is an @emph{obsolete wrapper} around @code{AC_PROG_CC_C_O}. New
+ code needs not to use this macro. It will be deprecated, and then
+ removed, in future Automake versions.
+
-
+ @end table
+
@node Private Macros
@subsection Private Macros