autoconf: autoscan Invocation

1 
1 3.2 Using `autoscan' to Create `configure.ac'
1 =============================================
1 
1 The `autoscan' program can help you create and/or maintain a
1 `configure.ac' file for a software package.  `autoscan' examines source
1 files in the directory tree rooted at a directory given as a command
1 line argument, or the current directory if none is given.  It searches
1 the source files for common portability problems and creates a file
1 `configure.scan' which is a preliminary `configure.ac' for that
1 package, and checks a possibly existing `configure.ac' for completeness.
1 
1    When using `autoscan' to create a `configure.ac', you should
1 manually examine `configure.scan' before renaming it to `configure.ac';
1 it probably needs some adjustments.  Occasionally, `autoscan' outputs a
1 macro in the wrong order relative to another macro, so that `autoconf'
1 produces a warning; you need to move such macros manually.  Also, if
1 you want the package to use a configuration header file, you must add a
1 call to `AC_CONFIG_HEADERS' (⇒Configuration Headers).  You might
1 also have to change or add some `#if' directives to your program in
1 order to make it work with Autoconf (⇒ifnames Invocation, for
1 information about a program that can help with that job).
1 
1    When using `autoscan' to maintain a `configure.ac', simply consider
1 adding its suggestions.  The file `autoscan.log' contains detailed
1 information on why a macro is requested.
1 
1    `autoscan' uses several data files (installed along with Autoconf)
1 to determine which macros to output when it finds particular symbols in
1 a package's source files.  These data files all have the same format:
1 each line consists of a symbol, one or more blanks, and the Autoconf
1 macro to output if that symbol is encountered.  Lines starting with `#'
1 are comments.
1 
1    `autoscan' accepts the following options:
1 
1 `--help'
1 `-h'
1      Print a summary of the command line options and exit.
1 
1 `--version'
1 `-V'
1      Print the version number of Autoconf and exit.
1 
1 `--verbose'
1 `-v'
1      Print the names of the files it examines and the potentially
1      interesting symbols it finds in them.  This output can be
1      voluminous.
1 
1 `--debug'
1 `-d'
1      Don't remove temporary files.
1 
1 `--include=DIR'
1 `-I DIR'
1      Append DIR to the include path.  Multiple invocations accumulate.
1 
1 `--prepend-include=DIR'
1 `-B DIR'
1      Prepend DIR to the include path.  Multiple invocations accumulate.
1