AUTOCONF(1)

πŸ“¦ version 2.64, in debian bookworm, ubuntu jammy, ubuntu noble

✨ AUTOCONF(1) ✨

okay bestie, gather round, because we're talking about autoconf from the User Commands corner of the manual, and it is literally the girlboss that writes your configure scripts for you πŸ’…


🌸 NAME 🌸

autoconf β€” generate configuration scripts πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

autoconf [OPTION]... [TEMPLATE-FILE]

πŸ’– DESCRIPTION πŸ’–

So here's the tea β˜•: autoconf generates a configuration script. From what, you ask? From a TEMPLATE-FILE if you hand it one, or from configure.ac if that's chilling in the directory, or else from configure.in. It's giving "I'll find something to work with, don't worry" 🫢

Where does the output go? If you gave it a TEMPLATE-FILE, it goes straight to standard output. If you didn't, it goes into configure. Slay.

πŸ‘‘ Operation modes πŸ‘‘

  • -h, --help β€” prints the help text, then dips. Bye πŸ‘‹
  • -V, --version β€” prints the version number, then dips.
  • -v, --verbose β€” reports processing verbosely, aka it tells you everything, main character energy ✨
  • -d, --debug β€” does not remove temporary files (so you can go snooping, no cap)
  • -f, --force β€” considers all files obsolete
  • -o, --output=FILE β€” saves the output in FILE (and just so you know, stdout is the default)
  • -W, --warnings=CATEGORY β€” reports the warnings that fall in CATEGORY, and the default category is syntax

πŸŽ€ Warning categories include: πŸŽ€

  • cross β€” cross compilation issues
  • obsolete β€” obsolete constructs (it's giving outdated, bestie)
  • syntax β€” dubious syntactic constructs
  • all β€” all the warnings, the whole buffet
  • no-CATEGORY β€” turns off the warnings on CATEGORY
  • none β€” turns off all the warnings, silence is golden πŸ”‡
  • error β€” warnings are error
Also! The environment variables M4 and WARNINGS are honored. Respect them πŸ™‡β€β™€οΈ

🌈 Library directories 🌈

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

🧚 Tracing 🧚

  • -t, --trace=MACRO[:FORMAT] β€” reports the list of calls to MACRO
  • -i, --initialization β€” also traces Autoconf's initialization process
⚠️ Heads up: in tracing mode, no configuration script is created. Like, zero. None. It's busy tracing instead, okay?

And FORMAT defaults to $f:$l:$n:$% β€” if you want the full lore on FORMAT, go peek at autom4te --help πŸ‘€


πŸ’œ AUTHOR πŸ’œ

Written by David J. MacKenzie and Akim Demaille. Legends, fr fr πŸ‘‘


😭 REPORTING BUGS 😭

Found a bug? Report it to <bug-autoconf@gnu.org>. GNU Autoconf home page: <http://www.gnu.org/software/autoconf/>. And for general help using GNU software: <http://www.gnu.org/gethelp/>.


Copyright Β© 2009 Free Software Foundation, Inc. License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/old-licenses/gpl-2.0.html>

This is free software: you are free to change and redistribute it.

There is NO WARRANTY, to the extent permitted by law. Not even a little one πŸ’€

πŸ”₯ SEE ALSO πŸ”₯

The full documentation for autoconf is maintained as a Texinfo manual. If the info and autoconf programs are properly installed at your site, this command:

info autoconf

should give you access to the complete manual. Go get that knowledge, bestie πŸ“šβœ¨


and that's the whole page!! this one's from GNU Autoconf 2.64, dated July 2009 β€” yeah she's an elder but she ATE and left no crumbs πŸ‘‘πŸ’… mwah, love u, go configure something πŸ¦‹

πŸ“¦ where this page comes from