--- autoconf-2.13.orig/autoconf.1 +++ autoconf-2.13/autoconf.1 @@ -0,0 +1,126 @@ +.\" 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 +autoconf - creates scripts to configure source code packages using templates +.SH SYNOPSIS +.B autoconf +[ +.B --help +| +.B -h +] [ +.B --localdir=dir +| +.B -l dir +] [ +.B --macrodir=dir +| +.B -m dir +] [ +.B --version +] +.SH DESCRIPTION +.PP +To create +.B configure +from +.BR configure.in , run the +.B autoconf +program with no arguments. +.B autoconf +processes +.B configure.in +with +the +.B m4 +macro processor, using the Autoconf macros. If you give +.B autoconf +an argument, it reads that file instead of +.B configure.in +and writes the configuration script to the standard output instead of +to +.B configure +. If you give +.B autoconf +the argument +.BR - , +it reads the +standard input instead of +.B configure.in +and writes the configuration +script on the standard output. +.PP +The Autoconf macros are defined in several files. Some of the files +are distributed with Autoconf; +.B autoconf +reads them first. Then it +looks for the optional file +.B acsite.m4 +in the directory that contains +the distributed Autoconf macro files, and for the optional file +.B aclocal.m4 +in the current directory. Those files can contain your +site's or the package's own Autoconf macro definitions. If a macro is +defined in more than one of the files that +.B autoconf +reads, the last +definition it reads overrides the earlier ones. +.PP + +.B autoconf +accepts the following options: +.TP +.BI --help +.TP +.BI -h +Print a summary of the command line options and exit. +.TP +.BI --localdir=DIR +.TP +.BI -l\ DIR +Look for the package file +.B aclocal.m4 +in directory DIR instead of +in the current directory. +.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 --version +Print the version number of Autoconf and exit. +.PP +.SH "SEE ALSO" +.BR autoheader (1), +.BR autoreconf (1), +.BR autoscan (1), +.BR autoupdate (1), +.BR ifnames (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 + for the Debian GNU/Linux +.B autoconf +package. --- autoconf-2.13.orig/autoheader.1 +++ autoconf-2.13/autoheader.1 @@ -0,0 +1,197 @@ +.\" 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 AUTOHEADER 1 "Autoconf" +.SH NAME +autoheader - creates a template file of C #define's for use by +configure. +.SH SYNOPSIS +.B autoheader +[ +.B --help +| +.B -h +] [ +.B --localdir=dir +| +.B -l dir +] [ +.B --macrodir=dir +| +.B -m dir +] [ +.B --version +] +.SH DESCRIPTION +.PP +The +.B autoheader +program can create a template file of C +.B #define +statements for +.B configure +to use. If +.B configure.in +invokes +.BR AC_CONFIG_HEADER(FILE) , +.B autoheader +creates +.BR FILE.in ; +if multiple +file arguments are given, the first one is used. Otherwise, +.B autoheader +creates +.BR config.h.in . +.PP +If you give +.B autoheader +an argument, it uses that file instead of +.B configure.in +and writes the header file to the standard output +instead of to +.B config.h.in +. If you give +.B autoheader +an argument of +.BR - , +it reads the standard input instead of +.B configure.in +and writes +the header file to the standard output. +.PP +.B autoheader +scans +.B configure.in +and figures out which C +preprocessor symbols it might define. It copies comments and +.B #define +and +.B #undef +statements from a file called +.BR acconfig.h , +which comes +with and is installed with Autoconf. It also uses a file called +.B acconfig.h +in the current directory, if present. If you +.B AC_DEFINE +any additional symbols, you must create that file with entries for +them. For symbols defined by +.BR AC_CHECK_HEADERS , +.BR AC_CHECK_FUNCS , +.BR AC_CHECK_SIZEOF , +or +.BR AC_CHECK_LIB , +.B autoheader +generates comments +and +.B #undef +statements itself rather than copying them from a file, +since the possible symbols are effectively limitless. +.PP +The file that +.B autoheader +creates contains mainly +.B #define +and +.B #undef +statements and their accompanying comments. If +.B ./acconfig.h +contains the string +.BR @TOP@ , +.B autoheader +copies the lines before the +line containing +.B @TOP@ +into the top of the file that it generates. +Similarly, if +.B ./acconfig.h +contains the string +.BR @BOTTOM@ , +.B autoheader +copies the lines after that line to the end of the file it +generates. Either or both of those strings may be omitted. +.PP +An alternate way to produce the same effect is to create the files +.B FILE.top +(typically +.BR config.h.top ) +and/or +.B FILE.bot +in the current +directory. If they exist, +.B autoheader +copies them to the beginning +and end, respectively, of its output. Their use is discouraged because +they have file names that contain two periods, and so can not be stored +on MS-DOS; also, they are two more files to clutter up the directory. +But if you use the +.B --localdir=DIR +option to use an +.B acconfig.h +in +another directory, they give you a way to put custom boilerplate in each +individual +.BR config.h.in . +.PP +.B autoheader +accepts the following options: +.TP +.BI --help +.TP +.BI -h +Print a summary of the command line options and exit. +.TP +.BI --localdir=DIR +.TP +.BI -l\ DIR +Look for the package files +.B aclocal.m4 +and +.B acconfig.h +(but not +.B FILE.top +and +.BR FILE.bot ) +in directory DIR instead of in the current +directory. +.TP +.BI --macrodir=DIR +.TP +.BI -m\ DIR +Look for the installed macro files and +.B acconfig.h +in directory DIR. +You can also set the +.B AC_MACRODIR +environment variable to a +directory; this option overrides the environment variable. +.TP +.BI --version +Print the version number of Autoconf and exit. +.SH "SEE ALSO" +.BR autoconf (1), +.BR autoreconf (1), +.BR autoscan (1), +.BR autoupdate (1), +.BR ifnames (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 + for the Debian GNU/Linux +.B autoconf +package. --- autoconf-2.13.orig/autoreconf.1 +++ autoconf-2.13/autoreconf.1 @@ -0,0 +1,165 @@ +.\" 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 AUTORECONF 1 "Autoconf" +.SH NAME +autoreconf - update configure scripts +.SH SYNOPSIS +.B autoreconf +[ +.B --help +| +.B -h +] [ +.B --force +| +.B -f +] [ +.B --localdir=dir +| +.B -l dir +] [ +.B --macrodir=dir +| +.B -m dir +] [ +.B --verbose +] [ +.B --version +] +.SH DESCRIPTION +.PP +If you have a lot of Autoconf-generated +.B configure +scripts, the +.B autoreconf +program can save you some work. It runs +.B autoconf +(and +.BR autoheader , +where appropriate) repeatedly to remake the Autoconf +.B configure +scripts and configuration header templates in the directory +tree rooted at the current directory. By default, it only remakes +those files that are older than their +.B configure.in +or (if present) +.BR aclocal.m4 . +Since +.B autoheader +does not change the timestamp of its +output file if the file wouldn't be changing, this is not necessarily +the minimum amount of work. If you install a new version of Autoconf, +you can make +.B autoreconf +remake +.I all +of the files by giving it the +.B --force +option. +.PP +If you give +.B autoreconf +the +.B --macrodir=DIR +or +.B --localdir=DIR +options, it passes them down to +.B autoconf +and +.B autoheader +(with +relative paths adjusted properly). +.PP +.B autoreconf +does not support having, in the same directory tree, +both directories that are parts of a larger package (sharing +.B aclocal.m4 +and +.BR acconfig.h ), +and directories that are independent +packages (each with their own +.B aclocal.m4 +and +.BR acconfig.h ). +It +assumes that they are all part of the same package, if you use +.BR --localdir , +or that each directory is a separate package, if you +don't use it. This restriction may be removed in the future. +.PP +.B autoreconf +accepts the following options: +.TP +.BI --help +.TP +.BI -h +Print a summary of the command line options and exit. +.TP +.BI --force +.TP +.BI -f +Remake even +.B configure +scripts and configuration headers that are +newer than their input files +.RB ( configure.in +and, if present, +.BR aclocal.m4 ). +.TP +.BI --localdir=DIR +.TP +.BI -l\ DIR +Look for the package file +.B aclocal.m4 +in directory DIR instead of +in the current directory. +.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 name of each directory where +.B autoreconf +runs +.B autoconf +(and +.BR autoheader , +if appropriate). +.TP +.BI --version +Print the version number of Autoconf and exit. +.PP +.SH "SEE ALSO" +.BR autoconf (1), +.BR autoheader (1), +.BR autoscan (1), +.BR autoupdate (1), +.BR ifnames (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 + for the Debian GNU/Linux +.B autoconf +package. --- autoconf-2.13.orig/autoscan.1 +++ autoconf-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 +autoscan - help to create a configure.in file for a software package +.SH SYNOPSIS +.B autoscan +[ +.B --help +] [ +.B --macrodir=dir +] [ +.B --verbose +] [ +.B --version +] +.SH DESCRIPTION +The +.B autoscan +program can help you create a +.B configure.in +file for a +software package. +.B autoscan +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 autoscan +outputs a macro in the wrong order relative to another +macro, so that +.B autoconf +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 ifnames (1)), +for information about a program that can help with that job). +.PP +.B autoscan +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 autoscan +requires that a Perl interpreter is installed. +.PP + +.B autoscan +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 autoconf (1), +.BR autoheader (1), +.BR autoreconf (1), +.BR autoupdate (1), +.BR ifnames (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 + for the Debian GNU/Linux +.B autoconf +package. --- autoconf-2.13.orig/autoupdate.1 +++ autoconf-2.13/autoupdate.1 @@ -0,0 +1,97 @@ +.\" 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 AUTOUPDATE 1 "Autoconf" +.SH NAME +autoupdate - updates an old configure.in file to version 2 +.SH SYNOPSIS +.B autoconf +[ +.B --help +| +.B -h +] [ +.B --macrodir=dir +| +.B -m dir +] [ +.B --version +] +.SH DESCRIPTION +The +.B autoupdate +program updates a +.B configure.in +file that calls +Autoconf macros by their old names to use the current macro names. In +version 2 of Autoconf, most of the macros were renamed to use a more +uniform and descriptive naming scheme. Although the old names still +work , you can make your +.B configure.in +files more readable and make +it easier to use the current Autoconf documentation if you update them +to use the new macro names. +If given no arguments, +.B autoupdate +updates +.BR configure.in , +backing up +the original version with the suffix +.B ~ +(or the value of the +environment variable +.BR SIMPLE_BACKUP_SUFFIX , +if that is set). If you +give +.B autoupdate +an argument, it reads that file instead of +.B configure.in +and writes the updated file to the standard output. +.PP +.B autoconf +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 --version +Print the version number of Autoconf and exit. +.PP +.SH "SEE ALSO" +.BR autoconf (1), +.BR autoheader (1), +.BR autoreconf (1), +.BR autoscan (1), +.BR ifnames (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 + for the Debian GNU/Linux +.B autoconf +package. --- autoconf-2.13.orig/ifnames.1 +++ autoconf-2.13/ifnames.1 @@ -0,0 +1,98 @@ +.\" 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 IFNAMES 1 "Autoconf" +.SH NAME +ifnames - print identifiers that a package uses in C preprocessor +conditionals +.SH SYNOPSIS +.B ifnames +[ +.B --help +| +.B -h +] [ +.B --macrodir=dir +| +.B -m dir +] [ +.B --version +] +.SH DESCRIPTION +.PP +.B ifnames +can help when writing a +.B configure.in +for a software +package. It prints the identifiers that the package already uses in C +preprocessor conditionals. If a package has already been set up to +have some portability, this program can help you figure out what its +.B configure +needs to check for. It may help fill in some gaps in a +.B configure.in +generated by +.B autoscan +(see +.BR autoscan (1)). +.PP +.B ifnames +scans all of the C source files named on the command line +(or the standard input, if none are given) and writes to the standard +output a sorted list of all the identifiers that appear in those files +in +.BR #if , +.BR #elif , +.BR #ifdef , +or +.B #ifndef +directives. It prints each +identifier on a line, followed by a space-separated list of the files +in which that identifier occurs. +.PP +.B ifnames +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 --version +Print the version number of Autoconf and exit. +.PP +.SH "SEE ALSO" +.BR autoconf (1), +.BR autoheader (1), +.BR autoreconf (1), +.BR autoscan (1), +.BR autoupdate (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 + for the Debian GNU/Linux +.B autoconf +package.