freebsd-dev/contrib/binutils/etc/configure.man
1998-03-01 22:58:51 +00:00

167 lines
3.5 KiB
Groff

.\" -*- nroff -*-
.\" Copyright (c) 1991, 1992, 1996 Cygnus Support
.\" written by K. Richard Pixley
.TH configure 1 "29 March 1996" "cygnus support" "Cygnus Support"
.de BP
.sp
.ti \-.2i
\(**
..
.SH NAME
configure \- prepare source code to be built
.SH SYNOPSIS
configure HOST [--target=TARGET] [--srcdir=DIR] [--rm]
[--site=SITE] [--prefix=DIR] [--exec_prefix=DIR]
[--program_prefix=DIR] [--tmpdir=DIR]
[--with-PACKAGE[=YES/NO]] [--without-PACKAGE]
[--enable-FEATURE[=YES/NO]] [--disable-FEATURE]
[--norecursion] [--nfp] [-s] [-v] [-V | --version] [--help]
.SH DESCRIPTION
.I configure
is a program used to prepare souce code to be built. It does this by
generating Makefiles and .gdbinit files, creating symlinks, recursing
in subdirectories, and some other miscellaneous file editing.
.SH OPTIONS
.I configure
accepts the following options:
.TP
.I \--target=TARGET
Requests that the sources be configured to target the
.I TARGET
machine. If no target is specified explicitly, the target is assumed
to be the same as the host.
.TP
.I \--srcdir=DIR
tells configure to find the source in
.I DIR.
Object code is always built in the current directory,
.I `.'.
.TP
.I \--rm
asks configure to remove a configuration rather than create one.
.TP
.I \--site=SITE
asks configure to use any site-specific Makefile fragments for
.I SITE
when building Makefiles.
.TP
.I \--prefix=DIR
sets the location in which to install files to
.I DIR.
The default is "/usr/local".
.TP
.I \--exec_prefix=DIR
sets the root directory for host-dependent files to
.I DIR.
The default location is the value of
.I prefix.
.TP
.I \--program_prefix=DIR
configures the source to install programs which have the same names as
common Unix programs, such as "make", in
.I DIR.
Also applies to programs which might be used for cross-compilation.
.TP
.I \--tmpdir=DIR
sets the directory in which configure creates temporary files to
.I DIR.
.TP
.I \--with-PACKAGE[=YES/NO]
sets a flag for the build to recognize that
.I PACKAGE
is explicitly present or not present. If
.I \=YES/NO
is nonexistent, the default is
.I YES.
.I \--without-PACKAGE
is equivalent to
.IR \--with-PACKAGE=no .
.TP
.I \--enable-FEATURE[=YES/NO]
sets a flag for the build to recognize that
.I FEATURE
should be included or not included. If
.I \=YES/NO
is nonexistent, the default is
.I YES.
.I \--disable-FEATURE
is equivalent to
.IR --enable-FEATURE=no .
.TP
.I \--norecursion
asks that only the current directory be configured. Normally
.I configure
recurs on subdirectories.
.TP
.I \-nfp
Notifies
.I configure
that all of the specified hosts have
.I no floating point
units.
.TP
.I \-s
used internally by configure to supress status messages on
subdirectory recursions. Override with
.I \-v
.TP
.I \-v
verbose output. Asks that configure print status lines for each
directory configured. Normally, only the status lines for the current
directory are printed.
.TP
.I \--version
.I \-V
prints
.I configure
version number.
.TP
.I \-help
displays a brief usage summary.
.SH FILES
configure.in for each directory's individual needs
.br
Makefile.in Makefile template
.br
config.sub for parsing configuration names
.br
config.guess for guessing HOST when not specified
.br
config.status non-recursively rebuilds current directory
.SH FILES
.ta \w'gmon.sum 'u
a.out the namelist and text space.
.br
gmon.out dynamic call graph and profile.
.br
gmon.sum summarized dynamic call graph and profile.
.SH "SEE ALSO"
.RB "`\|" configure "\|'"
entry in
.B
info.