]> git.pld-linux.org Git - packages/autoconf.git/commitdiff
- patch with autoconf man pages.
authorkloczek <kloczek@pld-linux.org>
Mon, 26 Apr 1999 18:10:09 +0000 (18:10 +0000)
committercvs2git <feedback@pld-linux.org>
Sun, 24 Jun 2012 12:13:13 +0000 (12:13 +0000)
Changed files:
    autoconf-man.patch -> 1.1

autoconf-man.patch [new file with mode: 0644]

diff --git a/autoconf-man.patch b/autoconf-man.patch
new file mode 100644 (file)
index 0000000..286ee74
--- /dev/null
@@ -0,0 +1,823 @@
+--- 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.
This page took 0.07208 seconds and 4 git commands to generate.