[binutils.git] / configure.man

.\" -*- nroff -*-
.\" Copyright (c) 1991, 1992 Cygnus Support
.\" written by K. Richard Pixley
.TH configure 1 "13 December 1991" "cygnus support" "Cygnus Support"
.de BP
.sp
.ti \-.2i
\(**
..

.SH NAME
configure \(em\& prepare source code to be built

.SH SYNOPSIS
configure host1 [host2 [host3 ...]] [-exec_prefix=dir] [-gas] [-help]
[-host=h] [-nfp] [-norecursion]
[-prefix=dir] [-s] [-rm] [-site=s] [-srcdir=dir]
[-target=t] [-v] [-x]

.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, digging
directories, and some other miscellaneous file editting.

.SH OPTIONS
.I Configure
accepts the following options:

.TP
.I \-exec_prefix=dir
sets the root directory for host dependent files to
.I dir.
The default location is the same as
.I prefix.

.TP
.I \-gas
tells configure that the GNU assembler is available on this machine
even if it is not ordinarily.

.TP
.I \-help
displays a brief summary of the calling convention.

.TP
.I \-host=h
asks configure to prepare the source to be compiled in an environment
called
.I h.
This option is very confusing and is best ignored.  FIXME: I don't
think it should even be documented.

.TP
.I \-nfp
Notifies configure that all of the specified hosts have
.I no floating point
units.

.TP
.I \-norecursion
asks that only the current directory be configured.  Normally
configure recurs on subdirectories.

.TP
.I \-prefix=dir
sets the default location in which to install files to dir.  The
default is "/usr/local".

.TP
.I \-s
used internally by configure to supress status messages on
subdirectory recursions.

.TP
.I \-rm
asks configure to remove a configuration rather than creating one.

.TP
.I \-site=s
asks configure to use any site specific Makefile fragments for s when
building Makefiles.

.TP
.I \-srcdir=dir
tells configure to find the source in srcdir.

.TP
.I \-target=t
Requests that the sources be configured to target the t machine.  If
no targets are specified explicitly, the target is assumed to be the
same as the host. 

.TP
.I \-tmpdir=dir
Sets the directory in which configure creates temporary files to
tmpdir.

.TP
.I \-verbose
.I \-v
Asks that configure print status lines for each directory configured.
Normally, only the status lines for the current directory are printed.

.TP
.I \-x
Tells configure that MIT style X11 header files and libraries are
available on this machine, even if they are not normally available.

.SH FILES
configure.in	for each directory's individual needs
config.sub	for parsing configuration names

.SH "SEE ALSO"
.RB "`\|" configure "\|'"
entry in 
.B
info. (not yet available).
Commit	Line	Data
8f861f08	1	.\" -- nroff --
787c6bfe RP	2	.\" Copyright (c) 1991, 1992 Cygnus Support
787c6bfe RP	3	.\" written by K. Richard Pixley
8f861f08 RP	4	.TH configure 1 "13 December 1991" "cygnus support" "Cygnus Support"
	5	.de BP
	6	.sp
	7	.ti \-.2i
	8	\(**
	9	..
	10
	11	.SH NAME
	12	configure \(em\& prepare source code to be built
	13
	14	.SH SYNOPSIS
787c6bfe RP	15	configure host1 [host2 [host3 ...]] [-exec_prefix=dir] [-gas] [-help]
	16	[-host=h] [-nfp] [-norecursion]
	17	[-prefix=dir] [-s] [-rm] [-site=s] [-srcdir=dir]
8f861f08 RP	18	[-target=t] [-v] [-x]
	19
	20	.SH DESCRIPTION
	21	.I Configure
	22	is a program used to prepare souce code to be built. It does this by
	23	generating Makefiles and .gdbinit files, creating symlinks, digging
	24	directories, and some other miscellaneous file editting.
	25
	26	.SH OPTIONS
	27	.I Configure
	28	accepts the following options:
	29
	30	.TP
787c6bfe RP	31	.I \-exec_prefix=dir
787c6bfe RP	32	sets the root directory for host dependent files to
8f861f08	33	.I dir.
787c6bfe RP	34	The default location is the same as
787c6bfe RP	35	.I prefix.
8f861f08 RP	36
	37	.TP
	38	.I \-gas
	39	tells configure that the GNU assembler is available on this machine
	40	even if it is not ordinarily.
	41
	42	.TP
	43	.I \-help
	44	displays a brief summary of the calling convention.
	45
	46	.TP
	47	.I \-host=h
	48	asks configure to prepare the source to be compiled in an environment
	49	called
	50	.I h.
	51	This option is very confusing and is best ignored. FIXME: I don't
	52	think it should even be documented.
	53
8f861f08 RP	54	.TP
	55	.I \-nfp
	56	Notifies configure that all of the specified hosts have
	57	.I no floating point
	58	units.
	59
	60	.TP
	61	.I \-norecursion
	62	asks that only the current directory be configured. Normally
	63	configure recurs on subdirectories.
	64
8f861f08 RP	65	.TP
	66	.I \-prefix=dir
	67	sets the default location in which to install files to dir. The
	68	default is "/usr/local".
	69
	70	.TP
787c6bfe	71	.I \-s
8f861f08 RP	72	used internally by configure to supress status messages on
	73	subdirectory recursions.
	74
	75	.TP
	76	.I \-rm
	77	asks configure to remove a configuration rather than creating one.
	78
	79	.TP
	80	.I \-site=s
	81	asks configure to use any site specific Makefile fragments for s when
	82	building Makefiles.
	83
	84	.TP
	85	.I \-srcdir=dir
	86	tells configure to find the source in srcdir.
	87
8f861f08 RP	88	.TP
	89	.I \-target=t
	90	Requests that the sources be configured to target the t machine. If
	91	no targets are specified explicitly, the target is assumed to be the
787c6bfe	92	same as the host.
8f861f08 RP	93
	94	.TP
	95	.I \-tmpdir=dir
	96	Sets the directory in which configure creates temporary files to
	97	tmpdir.
	98
	99	.TP
	100	.I \-verbose
	101	.I \-v
	102	Asks that configure print status lines for each directory configured.
	103	Normally, only the status lines for the current directory are printed.
	104
	105	.TP
	106	.I \-x
	107	Tells configure that MIT style X11 header files and libraries are
	108	available on this machine, even if they are not normally available.
	109
	110	.SH FILES
	111	configure.in for each directory's individual needs
787c6bfe	112	config.sub for parsing configuration names
8f861f08 RP	113
	114	.SH "SEE ALSO"
	115	.RB "`\\|" configure "\\|'"
	116	entry in
	117	.B
	118	info. (not yet available).