aclocal(1)

aclocal1

Generate aclocal.m4 by scanning configure.ac

Usage

aclocal [OPTION] ...

Overview

Generate 'aclocal.m4' by scanning 'configure.ac' or 'configure.in'

Options

--automake-acdir=DIR

directory holding automake-provided m4 files

--aclocal-path=PATH

colon-separated list of directories to search for third-party local files

--system-acdir=DIR

directory holding third-party system-wide files

--diff[=COMMAND]

run COMMAND [diff -u] on M4 files that would be changed (implies --install and --dry-run)

--dry-run

pretend to, but do not actually update any file

--force

always update output file

--help

print this help, then exit

-I DIR

add directory to search list for .m4 files

--install

copy third-party files to the first -I directory

--output=FILE

put output in FILE (default aclocal.m4)

--print-ac-dir

print name of directory holding system-wide third-party m4 files, then exit

--verbose

don't be silent

--version

print version number, then exit

-W, --warnings=CATEGORY

report the warnings falling in CATEGORY, defaults to $WARNINGS

Warning categories are:

cross

cross compilation issues

gnu

GNU coding standards (default in gnu and gnits modes)

obsolete

obsolete features or constructions (default)

override

user redefinitions of Automake rules or variables

portability

portability issues (default in gnu and gnits modes)

portability-recursive

nested Make variables (default with -Wportability)

extra-portability

extra portability issues related to obscure tools

syntax

dubious syntactic constructs (default)

unsupported

unsupported or incomplete features (default)

-W also understands:

all

turn on all the warnings

none

turn off all the warnings

no-CATEGORY

turn off warnings in CATEGORY

error

treat all enabled warnings as errors

Releases

5 releases since Debian 2.0 (Hamm); the text changed 2 times.

  1. 2.0–2.2
  2. 3.0
  3. Arch

--aclocal-path since Arch Linux 2026-11-01; --automake-acdir since Arch Linux 2026-11-01; --diff since Arch Linux 2026-11-01; --dry-run since Arch Linux 2026-11-01; --force since Arch Linux 2026-11-01; --install since Arch Linux 2026-11-01; --print-ac-dir since Arch Linux 2026-11-01; --system-acdir since Arch Linux 2026-11-01; --warnings since Arch Linux 2026-11-01; -W since Arch Linux 2026-11-01.

--acdir until Debian 3.0 (Woody); -v until Debian 2.2 (Potato).

Author

Written by Tom Tromey <[email protected]>

and Alexandre Duret-Lutz <[email protected]>.

Reporting bugs

Report bugs to <[email protected]>.
GNU Automake home page: <https://www.gnu.org/software/automake/>.
General help using GNU software: <https://www.gnu.org/gethelp/>.

From automake 1.19-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.