automake: aclocal Options
1
1 6.3.1 aclocal Options
1 ---------------------
1
1 ‘aclocal’ accepts the following options:
1
1 ‘--automake-acdir=DIR’
1 Look for the automake-provided macro files in DIR instead of in the
1 installation directory. This is typically used for debugging.
1
1 The environment variable ‘ACLOCAL_AUTOMAKE_DIR’ provides another
1 way to set the directory containing automake-provided macro files.
1 However ‘--automake-acdir’ takes precedence over it.
1
1 ‘--system-acdir=DIR’
1 Look for the system-wide third-party macro files (and the special
1 ‘dirlist’ file) in DIR instead of in the installation directory.
1 This is typically used for debugging.
1
1 ‘--diff[=COMMAND]’
1 Run COMMAND on M4 file that would be installed or overwritten by
1 ‘--install’. The default COMMAND is ‘diff -u’. This option
1 implies ‘--install’ and ‘--dry-run’.
1
1 ‘--dry-run’
1 Do not actually overwrite (or create) ‘aclocal.m4’ and M4 files
1 installed by ‘--install’.
1
1 ‘--help’
1 Print a summary of the command line options and exit.
1
1 ‘-I DIR’
1 Add the directory DIR to the list of directories searched for ‘.m4’
1 files.
1
1 ‘--install’
1 Install system-wide third-party macros into the first directory
1 specified with ‘-I DIR’ instead of copying them in the output file.
1 Note that this will happen also if DIR is an absolute path.
1
1 When this option is used, and only when this option is used,
1 ‘aclocal’ will also honor ‘#serial NUMBER’ lines that appear in
1 macros: an M4 file is ignored if there exists another M4 file with
1 the same basename and a greater serial number in the search path
1 (⇒Serials).
1
1 ‘--force’
1 Always overwrite the output file. The default is to overwrite the
1 output file only when really needed, i.e., when its contents
1 changes or if one of its dependencies is younger.
1
1 This option forces the update of ‘aclocal.m4’ (or the file
1 specified with ‘--output’ below) and only this file, it has
1 absolutely no influence on files that may need to be installed by
1 ‘--install’.
1
1 ‘--output=FILE’
1 Cause the output to be put into FILE instead of ‘aclocal.m4’.
1
1 ‘--print-ac-dir’
1 Prints the name of the directory that ‘aclocal’ will search to find
1 third-party ‘.m4’ files. When this option is given, normal
1 processing is suppressed. This option was used _in the past_ by
1 third-party packages to determine where to install ‘.m4’ macro
1 files, but _this usage is today discouraged_, since it causes
1 ‘$(prefix)’ not to be thoroughly honored (which violates the GNU
1 Coding Standards), and a similar semantics can be better obtained
11 with the ‘ACLOCAL_PATH’ environment variable; ⇒Extending
aclocal.
1
1 ‘--verbose’
1 Print the names of the files it examines.
1
1 ‘--version’
1 Print the version number of Automake and exit.
1
1 ‘-W CATEGORY’
1 ‘--warnings=CATEGORY’
1 Output warnings falling in CATEGORY. CATEGORY can be one of:
1 ‘syntax’
1 dubious syntactic constructs, underquoted macros, unused
1 macros, etc.
1 ‘unsupported’
1 unknown macros
1 ‘all’
1 all the warnings, this is the default
1 ‘none’
1 turn off all the warnings
1 ‘error’
1 treat warnings as errors
1
1 All warnings are output by default.
1
1 The environment variable ‘WARNINGS’ is honored in the same way as
1 it is for ‘automake’ (⇒automake Invocation).
1