.\" Copyright (C) 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
.\" Copyright (C) 1998 Ben Pfaff.
.\"
.\" Permission is granted to make and distribute verbatim copies of
.\" this manual provided the copyright notice and this permission notice
.\" are preserved on all copies.
.\" 
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the entire
.\" resulting derived work is distributed under the terms of a permission
.\" notice identical to this one.
.\" 
.\" Permission is granted to copy and distribute translations of this manual
.\" into another language, under the above conditions for modified versions,
.\" except that this permission notice may be stated in a translation approved
.\" by the Foundation.
.\"
.TH AUTOCONF 1 "Autoconf"
.SH NAME
autoscan2.13 - help to create a configure.in file for a software package
.SH SYNOPSIS
.B autoscan2.13
[
.B --help
] [
.B --macrodir=dir
] [
.B --verbose
] [
.B --version
]
.SH DESCRIPTION
The 
.B autoscan2.13
program can help you create a 
.B configure.in
file for a
software package.  
.B autoscan2.13
examines source files in the directory
tree rooted at a directory given as a command line argument, or the
current directory if none is given.  It searches the source files for
common portability problems and creates a file 
.B configure.scan
which
is a preliminary 
.B configure.in
for that package.
.PP
You should manually examine 
.B configure.scan
before renaming it to
.BR configure.in ; 
it will probably need some adjustments.  Occasionally
.B autoscan2.13
outputs a macro in the wrong order relative to another
macro, so that 
.B autoconf2.13
produces a warning; you need to move such
macros manually.  Also, if you want the package to use a configuration
header file, you must add a call to 
.BR AC_CONFIG_HEADER .  
You might
also have to change or add some 
.B #if
directives to your program in
order to make it work with Autoconf (see 
.BR ifnames2.13 (1)), 
for information about a program that can help with that job).
.PP
.B autoscan2.13
uses several data files, which are installed along with the
distributed Autoconf macro files, to determine which macros to output
when it finds particular symbols in a package's source files.  These
files all have the same format.  Each line consists of a symbol,
whitespace, and the Autoconf macro to output if that symbol is
encountered.  Lines starting with 
.B #
are comments.
.PP

.B autoscan2.13
requires that a Perl interpreter is installed.
.PP

.B autoscan2.13
accepts the following options:
.TP
.BI --help
.TP
.BI -h
Print a summary of the command line options and exit.
.TP
.BI --macrodir=DIR
.TP
.BI -m\ DIR
Look for the installed macro files in directory DIR.  You can also
set the 
.B AC_MACRODIR
environment variable to a directory; this
option overrides the environment variable.
.TP
.BI --verbose
Print the names of the fiels it examines and the potentially
interesting symbols it finds in them.  This output can be voluminous.
.TP
.BI --version
Print the version number of Autoconf and exit.
.PP
.SH "SEE ALSO"
.BR autoconf2.13 (1),
.BR autoheader2.13 (1),
.BR autoreconf2.13 (1),
.BR autoupdate2.13 (1),
.BR ifnames2.13 (1)
.SH AUTHORS
David MacKenzie, with help from Franc,ois Pinard, Karl Berry, Richard
Pixley, Ian Lance Taylor, Roland McGrath, Noah Friedman, David
D. Zuhn, and many others.  This manpage written by Ben Pfaff
<pfaffben@debian.org> for the Debian GNU/Linux
.B autoconf2.13
package.