| 1 | Copyright 1994, 1995, 1996, 1999, 2000, 2001 Free Software Foundation, | 
1 | Copyright 1994, 1995, 1996, 1999, 2000, 2001, 2002 Free Software | 
| 2 | Inc. | 
2 | Foundation, Inc. | 
| 3 |  | 
3 |  | 
| 4 |    This file is free documentation; the Free Software Foundation gives | 
4 |    This file is free documentation; the Free Software Foundation gives | 
| 5 | unlimited permission to copy, distribute and modify it. | 
5 | unlimited permission to copy, distribute and modify it. | 
| 6 |  | 
6 |  | 
| 7 | Basic Installation | 
7 | Basic Installation | 
| … |  | 
… |  | 
| 69 |  | 
69 |  | 
| 70 |    Some systems require unusual options for compilation or linking that | 
70 |    Some systems require unusual options for compilation or linking that | 
| 71 | the `configure' script does not know about.  Run `./configure --help' | 
71 | the `configure' script does not know about.  Run `./configure --help' | 
| 72 | for details on some of the pertinent environment variables. | 
72 | for details on some of the pertinent environment variables. | 
| 73 |  | 
73 |  | 
| 74 |    You can give `configure' initial values for variables by setting | 
74 |    You can give `configure' initial values for configuration parameters | 
| 75 | them in the environment.  You can do that on the command line like this: | 
75 | by setting variables in the command line or in the environment.  Here | 
 | 
 | 
76 | is an example: | 
| 76 |  | 
77 |  | 
| 77 |      ./configure CC=c89 CFLAGS=-O2 LIBS=-lposix | 
78 |      ./configure CC=c89 CFLAGS=-O2 LIBS=-lposix | 
| 78 |  | 
79 |  | 
| 79 |    *Note Defining Variables::, for more details. | 
80 |    *Note Defining Variables::, for more details. | 
| 80 |  | 
81 |  | 
| … |  | 
… |  | 
| 135 |  | 
136 |  | 
| 136 | Specifying the System Type | 
137 | Specifying the System Type | 
| 137 | ========================== | 
138 | ========================== | 
| 138 |  | 
139 |  | 
| 139 |    There may be some features `configure' cannot figure out | 
140 |    There may be some features `configure' cannot figure out | 
| 140 | automatically, but needs to determine by the type of host the package | 
141 | automatically, but needs to determine by the type of machine the package | 
| 141 | will run on.  Usually `configure' can figure that out, but if it prints | 
142 | will run on.  Usually, assuming the package is built to be run on the | 
 | 
 | 
143 | _same_ architectures, `configure' can figure that out, but if it prints | 
| 142 | a message saying it cannot guess the host type, give it the | 
144 | a message saying it cannot guess the machine type, give it the | 
| 143 | `--build=TYPE' option.  TYPE can either be a short name for the system | 
145 | `--build=TYPE' option.  TYPE can either be a short name for the system | 
| 144 | type, such as `sun4', or a canonical name which has the form: | 
146 | type, such as `sun4', or a canonical name which has the form: | 
| 145 |  | 
147 |  | 
| 146 |      CPU-COMPANY-SYSTEM | 
148 |      CPU-COMPANY-SYSTEM | 
| 147 |  | 
149 |  | 
| … |  | 
… |  | 
| 149 |  | 
151 |  | 
| 150 |      OS KERNEL-OS | 
152 |      OS KERNEL-OS | 
| 151 |  | 
153 |  | 
| 152 |    See the file `config.sub' for the possible values of each field.  If | 
154 |    See the file `config.sub' for the possible values of each field.  If | 
| 153 | `config.sub' isn't included in this package, then this package doesn't | 
155 | `config.sub' isn't included in this package, then this package doesn't | 
| 154 | need to know the host type. | 
156 | need to know the machine type. | 
| 155 |  | 
157 |  | 
| 156 |    If you are _building_ compiler tools for cross-compiling, you should | 
158 |    If you are _building_ compiler tools for cross-compiling, you should | 
| 157 | use the `--target=TYPE' option to select the type of system they will | 
159 | use the `--target=TYPE' option to select the type of system they will | 
| 158 | produce code for. | 
160 | produce code for. | 
| 159 |  | 
161 |  | 
| 160 |    If you want to _use_ a cross compiler, that generates code for a | 
162 |    If you want to _use_ a cross compiler, that generates code for a | 
| 161 | platform different from the build platform, you should specify the host | 
163 | platform different from the build platform, you should specify the | 
| 162 | platform (i.e., that on which the generated programs will eventually be | 
164 | "host" platform (i.e., that on which the generated programs will | 
| 163 | run) with `--host=TYPE'.  In this case, you should also specify the | 
165 | eventually be run) with `--host=TYPE'. | 
| 164 | build platform with `--build=TYPE', because, in this case, it may not | 
 | 
 | 
| 165 | be possible to guess the build platform (it sometimes involves | 
 | 
 | 
| 166 | compiling and running simple test programs, and this can't be done if | 
 | 
 | 
| 167 | the compiler is a cross compiler). | 
 | 
 | 
| 168 |  | 
166 |  | 
| 169 | Sharing Defaults | 
167 | Sharing Defaults | 
| 170 | ================ | 
168 | ================ | 
| 171 |  | 
169 |  | 
| 172 |    If you want to set default values for `configure' scripts to share, | 
170 |    If you want to set default values for `configure' scripts to share, |