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