| 1 | .\" -*- nroff -*- |
| 2 | .\" Copyright (c) 1991 Cygnus Support |
| 3 | .\" $Id$ |
| 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 |
| 15 | configure host1 [host2 [host3 ...]] [-datadir=dir] [-gas] [-help] |
| 16 | [-host=h] [-namesubdir=name] [-nfp] [-norecursion] [-objdir=dir] |
| 17 | [-prefix=dir] [-recurring] [-rm] [-site=s] [-srcdir=dir] [-subdirs] |
| 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 |
| 31 | .I \-datadir=dir |
| 32 | sets the root directory for host independent files to |
| 33 | .I dir. |
| 34 | |
| 35 | .TP |
| 36 | .I \-gas |
| 37 | tells configure that the GNU assembler is available on this machine |
| 38 | even if it is not ordinarily. |
| 39 | |
| 40 | .TP |
| 41 | .I \-help |
| 42 | displays a brief summary of the calling convention. |
| 43 | |
| 44 | .TP |
| 45 | .I \-host=h |
| 46 | asks configure to prepare the source to be compiled in an environment |
| 47 | called |
| 48 | .I h. |
| 49 | This option is very confusing and is best ignored. FIXME: I don't |
| 50 | think it should even be documented. |
| 51 | |
| 52 | .TP |
| 53 | .I \-namesubdir=name |
| 54 | When using -subdirs, this option sets the name of the subdir to be |
| 55 | created. This isn't very useful when configuring for multiple hosts. |
| 56 | NOTE: support for this option is temporarily suspended. |
| 57 | |
| 58 | .TP |
| 59 | .I \-nfp |
| 60 | Notifies configure that all of the specified hosts have |
| 61 | .I no floating point |
| 62 | units. |
| 63 | |
| 64 | .TP |
| 65 | .I \-norecursion |
| 66 | asks that only the current directory be configured. Normally |
| 67 | configure recurs on subdirectories. |
| 68 | |
| 69 | .TP |
| 70 | .I \-objdir=dir |
| 71 | asks that the build directories be created in dir. NOTE: support for |
| 72 | this option is at least temporarily suspended. |
| 73 | |
| 74 | .TP |
| 75 | .I \-prefix=dir |
| 76 | sets the default location in which to install files to dir. The |
| 77 | default is "/usr/local". |
| 78 | |
| 79 | .TP |
| 80 | .I \-recurring |
| 81 | used internally by configure to supress status messages on |
| 82 | subdirectory recursions. |
| 83 | |
| 84 | .TP |
| 85 | .I \-rm |
| 86 | asks configure to remove a configuration rather than creating one. |
| 87 | |
| 88 | .TP |
| 89 | .I \-site=s |
| 90 | asks configure to use any site specific Makefile fragments for s when |
| 91 | building Makefiles. |
| 92 | |
| 93 | .TP |
| 94 | .I \-srcdir=dir |
| 95 | tells configure to find the source in srcdir. |
| 96 | |
| 97 | .TP |
| 98 | .I \-subdirs |
| 99 | asks configure to create subdirectories of the build directory named |
| 100 | "H-host" for each host. If the configuration is not native, (host is |
| 101 | not target), the the directory will be named "X-host-target" instead. |
| 102 | NOTE: support for this option is temporarily suspended. |
| 103 | |
| 104 | .TP |
| 105 | .I \-target=t |
| 106 | Requests that the sources be configured to target the t machine. If |
| 107 | no targets are specified explicitly, the target is assumed to be the |
| 108 | same as the host. If multiple targets are specified, configurations |
| 109 | for each are created and -subdirs is assumed. |
| 110 | |
| 111 | NOTE: support for multiple targets is at least temporarily suspended. |
| 112 | |
| 113 | .TP |
| 114 | .I \-tmpdir=dir |
| 115 | Sets the directory in which configure creates temporary files to |
| 116 | tmpdir. |
| 117 | |
| 118 | .TP |
| 119 | .I \-verbose |
| 120 | .I \-v |
| 121 | Asks that configure print status lines for each directory configured. |
| 122 | Normally, only the status lines for the current directory are printed. |
| 123 | |
| 124 | .TP |
| 125 | .I \-x |
| 126 | Tells configure that MIT style X11 header files and libraries are |
| 127 | available on this machine, even if they are not normally available. |
| 128 | |
| 129 | .SH FILES |
| 130 | configure.in for each directory's individual needs |
| 131 | config.subr for parsing configuration names |
| 132 | |
| 133 | .SH "SEE ALSO" |
| 134 | .RB "`\|" configure "\|'" |
| 135 | entry in |
| 136 | .B |
| 137 | info. (not yet available). |