Главная   Изменения   Спек   Патчи   Исходники   Загрузить   Gear   Bugs and FR  Repocop 

./0040755000076500007650000000000007257423054007375 5ustar  ldvldv./ifnames.10100644000076500007650000000514607257423054011104 0ustar  ldvldv.\" 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.
./autoconf.10100644000076500007650000000603107257423054011272 0ustar  ldvldv.\" 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 
\fBconfigure.in\fP, 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.
./autoupdate.10100644000076500007650000000510007257423054011623 0ustar  ldvldv.\" 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.
./autoscan.10100644000076500007650000000662107257423054011276 0ustar  ldvldv.\" 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.
./autoheader.10100644000076500007650000001070607257423054011601 0ustar  ldvldv.\" 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.
./autoreconf.10100644000076500007650000000721007257423054011621 0ustar  ldvldv.\" 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.