AUTOHEADER(1)

โœจ AUTOHEADER โ€” bestie's guide to the template header machine โœจ

okay so. autoheader is the little icon that makes a template header for configure. that's the whole vibe. let's get into it ๐Ÿ’–


๐ŸŒธ NAME ๐ŸŒธ

autoheader โ€” create a template header for configure


๐Ÿฆ‹ SYNOPSIS ๐Ÿฆ‹

autoheader [OPTION]... [TEMPLATE-FILE]

๐Ÿ’… DESCRIPTION ๐Ÿ’…

so what it does is: it makes you a template file of C #define statements that configure is gonna use. iconic behavior, honestly.

to do that, it scans TEMPLATE-FILE โ€” OR, if you didn't hand it one, it looks for configure.ac, and if that's not there either, it goes for configure.in. slay ๐ŸŽ€

โœจ OPTIONS โœจ

  • -h, --help โ€” prints the help text, then dips out. bye ๐Ÿ‘‹
  • -V, --version โ€” prints the version number, then exits.
  • -v, --verbose โ€” reports what it's doing, but verbosely. yapper mode ๐Ÿ—ฃ๏ธ
  • -d, --debug โ€” does NOT delete the temporary files. leaving the evidence fr ๐Ÿ’€
  • -f, --force โ€” treats every single file as obsolete. no mercy.
  • -R, --replace-handwritten โ€” overwrites an existing template file that looks like it was not made by autoheader. careful bestie, this one's spicy ๐ŸŒถ๏ธ
  • -W, --warnings=CATEGORY โ€” reports the warnings that fall under CATEGORY. and yes, you can pass a comma-separated list if you're feeling ambitious.

๐Ÿ‘‘ Warning categories are: ๐Ÿ‘‘

  • cross โ€” cross compilation issues
  • gnu โ€” GNU coding standards (this is the 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 the warnings in CATEGORY
  • error โ€” treats every enabled warning as an error ๐Ÿšจ

๐Ÿ“ Library directories: ๐Ÿ“

  • -B, --prepend-include=DIR โ€” prepends directory DIR to the search path
  • -I, --include=DIR โ€” appends directory DIR to the search path

๐Ÿซถ AUTHOR ๐Ÿซถ

written by Roland McGrath and Akim Demaille. legends only ๐Ÿ‘‘


๐Ÿ˜ญ REPORTING BUGS ๐Ÿ˜ญ

found a bug? spill it to bug-autoconf@gnu.org, or slide into Savannah: https://savannah.gnu.org/support/?group=autoconf.


Copyright ยฉ 2026 Free Software Foundation, Inc. License GPLv3+/Autoconf: GNU GPL version 3 or later https://gnu.org/licenses/gpl.html, https://gnu.org/licenses/exceptions.html

this is free software: you are free to change it and redistribute it. and there is NO WARRANTY, to the extent permitted by law. periodt.


๐ŸŒŸ SEE ALSO ๐ŸŒŸ

autoconf(1), automake(1), autoreconf(1), autoupdate(1), autoheader(1), autoscan(1), config.guess(1), config.sub(1), ifnames(1), libtool(1).

the full documentation for Autoconf lives in a Texinfo manual, bestie. to read it locally, run:

info autoconf

and you can also peek the Web version of the manual at https://gnu.org/software/autoconf/manual/.


okay that's the whole page, mwah ๐Ÿ’‹ this was GNU Autoconf 2.73, from March 2026, and it was giving AUTOHEADER(1) energy the entire time. go forth and template your headers ๐Ÿฆ‹โœจ

๐Ÿ“ฆ where this page comes from