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