AUTOSCAN(1)
๐ autoscan โ girl help, I'm gonna write your configure.ac for you ๐
okay so this is autoscan, bestie, from the User Commands corner of the manual (section 1, as the girlies say). she's the vibe-checker of build systems and she is so underrated. let's get into it ๐ซถ
โจ NAME โจ
autoscan โ generate a preliminary configure.ac ๐ธ
like, a first-draft one. a little baby configure.ac. a situationship configure.ac, if you will.
๐ SYNOPSIS ๐
autoscan [OPTION]... [SRCDIR]
yes she takes options and yes she takes a directory and yes that's the whole thing, periodt ๐
๐ฆ DESCRIPTION ๐ฆ
okay so here's the tea: autoscan goes through source files in the directory tree rooted at SRCDIR โ or in the current directory if you don't give her one (she's flexible like that, she's a main character) ๐
then she does her little detective moment:
- she searches those source files for common portability problems ๐
- she checks whether your
configure.acis being incomplete (we've all been there, no judgement) - and she creates a file called
configure.scanโ which is a preliminaryconfigure.acfor that package โจ
it's giving "rough draft but make it infrastructure".configure.scanis a starting point, not a finished masterpiece โ it's literally called a preliminaryconfigure.ac, so read it before you commit to it, bestie ๐
now the options, and there's a whole squad of them:
-h,--helpโ prints the help text, then dips. that's it. that's the whole job ๐-V,--versionโ prints the version number, then exits. short and sweet, iconic behaviour ๐-v,--verboseโ reports processing verbosely. she will tell you EVERYTHING. yapper mode: activated ๐ฃ๏ธ-d,--debugโ doesn't remove temporary files. so when things go sideways you can go look at the crime scene ๐ฅ
๐ Library directories ๐
these two are about where she looks for stuff, and the order genuinely matters so pay attention bestie:
-B,--prepend-include=DIRโ prepend directory DIR to the search path. note the word prepend. front of the line. VIP section ๐-I,--include=DIRโ append directory DIR to the search path. back of the line. still invited, just not first ๐ฆ
๐ธ AUTHOR ๐ธ
written by David J. MacKenzie and Akim Demaille. legends, honestly. we love them for this ๐
๐ REPORTING BUGS ๐
found a bug? don't suffer in silence, tell the girlies:
- email:
bug-autoconf@gnu.org๐ง - or via Savannah:
https://savannah.gnu.org/support/?group=autoconf
fr fr, they wanna know ๐ซถ
๐ COPYRIGHT ๐
Copyright ยฉ 2026 Free Software Foundation, Inc. License GPLv3+/Autoconf: GNU GPL version 3 or later
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. no cap, that's the actual legal situation, she said what she said ๐
โญ SEE ALSO โญ
the whole friend group, in order:
autoconf(1), automake(1), autoreconf(1), autoupdate(1), autoheader(1), autoscan(1), config.guess(1), config.sub(1), ifnames(1), libtool(1)
(yes, autoscan(1) is listed in her own SEE ALSO. she's self-referential. she contains multitudes. slay ๐
)
The full documentation for Autoconf is maintained as a Texinfo manual. to read it locally, run:
info autoconf
and if you'd rather read it in a browser (valid, we respect it):
https://gnu.org/software/autoconf/manual/
and that's the whole page, bestie!! ๐ง this was GNU Autoconf 2.73, dated March 2026 โ go run autoscan on something and let her cook ๐โจ
๐ฆ where this page comes from
- alpine 3.24: autoconf-doc 2.73-r0 ยท GPL-3.0-or-later WITH Autoconf-exception-3.0
- arch rolling: autoconf 2.73-1 ยท GPL2 AND GPL3 AND custom
- nixos 26.05: autoconf 2.73
- nixpkgs unstable: autoconf 2.73
- ubuntu stonking: autoconf 2.73-2 ยท GPL-3.0-or-later
- ๐ girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms