autoconf2.13 (2.13-60) autoscan.1

--- autoconf2.13-2.13.orig/autoscan.1
+++ autoconf2.13-2.13/autoscan.1
@@ -0,0 +1,122 @@
+.\" 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.