- unify ftp.gnu.org urls

[packages/autoconf2_13.git] / autoconf2_13-man.patch

--- 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
+<pfaffben@pilot.msu.edu> 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
+<pfaffben@pilot.msu.edu> 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
+<pfaffben@pilot.msu.edu> 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
+<pfaffben@pilot.msu.edu> 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
+<pfaffben@pilot.msu.edu> 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
+<pfaffben@pilot.msu.edu> for the Debian GNU/Linux
+.B autoconf
+package.