/[public]/psiconv/trunk/INSTALL

Diff of /psiconv/trunk/INSTALL

Parent Directory | Revision Log | View Patch Patch

Revision 152		Revision 154
		1	Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002 Free Software
		2	Foundation, Inc.
		3
		4	This file is free documentation; the Free Software Foundation gives
		5	unlimited permission to copy, distribute and modify it.
		6
1	Basic Installation	7	Basic Installation
2	==================	8	==================
3		9
4	These are generic installation instructions.	10	These are generic installation instructions.
5		11
6	The `configure' shell script attempts to guess correct values for	12	The `configure' shell script attempts to guess correct values for
7	various system-dependent variables used during compilation. It uses	13	various system-dependent variables used during compilation. It uses
8	those values to create a `Makefile' in each directory of the package.	14	those values to create a `Makefile' in each directory of the package.
9	It may also create one or more `.h' files containing system-dependent	15	It may also create one or more `.h' files containing system-dependent
10	definitions. Finally, it creates a shell script `config.status' that	16	definitions. Finally, it creates a shell script `config.status' that
11	you can run in the future to recreate the current configuration, a file	17	you can run in the future to recreate the current configuration, and a
12	`config.cache' that saves the results of its tests to speed up	18	file `config.log' containing compiler output (useful mainly for
13	reconfiguring, and a file `config.log' containing compiler output	19	debugging `configure').
14	(useful mainly for debugging `configure').	20
		21	It can also use an optional file (typically called `config.cache'
		22	and enabled with `--cache-file=config.cache' or simply `-C') that saves
		23	the results of its tests to speed up reconfiguring. (Caching is
		24	disabled by default to prevent problems with accidental use of stale
		25	cache files.)
15		26
16	If you need to do unusual things to compile the package, please try	27	If you need to do unusual things to compile the package, please try
17	to figure out how `configure' could check whether to do them, and mail	28	to figure out how `configure' could check whether to do them, and mail
18	diffs or instructions to the address given in the `README' so they can	29	diffs or instructions to the address given in the `README' so they can
19	be considered for the next release. If at some point `config.cache'	30	be considered for the next release. If you are using the cache, and at
20	contains results you don't want to keep, you may remove or edit it.	31	some point `config.cache' contains results you don't want to keep, you
		32	may remove or edit it.
21		33
22	The file `configure.in' is used to create `configure' by a program	34	The file `configure.ac' (or `configure.in') is used to create
23	called `autoconf'. You only need `configure.in' if you want to change	35	`configure' by a program called `autoconf'. You only need
24	it or regenerate `configure' using a newer version of `autoconf'.	36	`configure.ac' if you want to change it or regenerate `configure' using
		37	a newer version of `autoconf'.
25		38
26	The simplest way to compile this package is:	39	The simplest way to compile this package is:
27		40
28	1. `cd' to the directory containing the package's source code and type	41	1. `cd' to the directory containing the package's source code and type
29	`./configure' to configure the package for your system. If you're	42	`./configure' to configure the package for your system. If you're
…		…
53		66
54	Compilers and Options	67	Compilers and Options
55	=====================	68	=====================
56		69
57	Some systems require unusual options for compilation or linking that	70	Some systems require unusual options for compilation or linking that
58	the `configure' script does not know about. You can give `configure'	71	the `configure' script does not know about. Run `./configure --help'
59	initial values for variables by setting them in the environment. Using	72	for details on some of the pertinent environment variables.
60	a Bourne-compatible shell, you can do that on the command line like
61	this:
62	CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
63		73
64	Or on systems that have the `env' program, you can do it like this:	74	You can give `configure' initial values for configuration parameters
65	env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure	75	by setting variables in the command line or in the environment. Here
		76	is an example:
		77
		78	./configure CC=c89 CFLAGS=-O2 LIBS=-lposix
		79
		80	*Note Defining Variables::, for more details.
66		81
67	Compiling For Multiple Architectures	82	Compiling For Multiple Architectures
68	====================================	83	====================================
69		84
70	You can compile the package for more than one kind of computer at the	85	You can compile the package for more than one kind of computer at the
…		…
73	supports the `VPATH' variable, such as GNU `make'. `cd' to the	88	supports the `VPATH' variable, such as GNU `make'. `cd' to the
74	directory where you want the object files and executables to go and run	89	directory where you want the object files and executables to go and run
75	the `configure' script. `configure' automatically checks for the	90	the `configure' script. `configure' automatically checks for the
76	source code in the directory that `configure' is in and in `..'.	91	source code in the directory that `configure' is in and in `..'.
77		92
78	If you have to use a `make' that does not supports the `VPATH'	93	If you have to use a `make' that does not support the `VPATH'
79	variable, you have to compile the package for one architecture at a time	94	variable, you have to compile the package for one architecture at a
80	in the source code directory. After you have installed the package for	95	time in the source code directory. After you have installed the
81	one architecture, use `make distclean' before reconfiguring for another	96	package for one architecture, use `make distclean' before reconfiguring
82	architecture.	97	for another architecture.
83		98
84	Installation Names	99	Installation Names
85	==================	100	==================
86		101
87	By default, `make install' will install the package's files in	102	By default, `make install' will install the package's files in
…		…
120	`--x-libraries=DIR' to specify their locations.	135	`--x-libraries=DIR' to specify their locations.
121		136
122	Specifying the System Type	137	Specifying the System Type
123	==========================	138	==========================
124		139
125	There may be some features `configure' can not figure out	140	There may be some features `configure' cannot figure out
126	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
127	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
128	a message saying it can not guess the host type, give it the	144	a message saying it cannot guess the machine type, give it the
129	`--host=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
130	type, such as `sun4', or a canonical name with three fields:	146	type, such as `sun4', or a canonical name which has the form:
		147
131	CPU-COMPANY-SYSTEM	148	CPU-COMPANY-SYSTEM
132		149
		150	where SYSTEM can have one of these forms:
		151
		152	OS KERNEL-OS
		153
133	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
134	`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
135	need to know the host type.	156	need to know the machine type.
136		157
137	If you are building compiler tools for cross-compiling, you can also	158	If you are _building_ compiler tools for cross-compiling, you should
138	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
139	produce code for and the `--build=TYPE' option to select the type of	160	produce code for.
140	system on which you are compiling the package.	161
		162	If you want to _use_ a cross compiler, that generates code for a
		163	platform different from the build platform, you should specify the
		164	"host" platform (i.e., that on which the generated programs will
		165	eventually be run) with `--host=TYPE'.
141		166
142	Sharing Defaults	167	Sharing Defaults
143	================	168	================
144		169
145	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,
…		…
148	`configure' looks for `PREFIX/share/config.site' if it exists, then	173	`configure' looks for `PREFIX/share/config.site' if it exists, then
149	`PREFIX/etc/config.site' if it exists. Or, you can set the	174	`PREFIX/etc/config.site' if it exists. Or, you can set the
150	`CONFIG_SITE' environment variable to the location of the site script.	175	`CONFIG_SITE' environment variable to the location of the site script.
151	A warning: not all `configure' scripts look for a site script.	176	A warning: not all `configure' scripts look for a site script.
152		177
153	Operation Controls	178	Defining Variables
154	==================	179	==================
		180
		181	Variables not defined in a site shell script can be set in the
		182	environment passed to `configure'. However, some packages may run
		183	configure again during the build, and the customized values of these
		184	variables may be lost. In order to avoid this problem, you should set
		185	them in the `configure' command line, using `VAR=value'. For example:
		186
		187	./configure CC=/usr/local2/bin/gcc
		188
		189	will cause the specified gcc to be used as the C compiler (unless it is
		190	overridden in the site shell script).
		191
		192	`configure' Invocation
		193	======================
155		194
156	`configure' recognizes the following options to control how it	195	`configure' recognizes the following options to control how it
157	operates.	196	operates.
158		197
		198	`--help'
		199	`-h'
		200	Print a summary of the options to `configure', and exit.
		201
		202	`--version'
		203	`-V'
		204	Print the version of Autoconf used to generate the `configure'
		205	script, and exit.
		206
159	`--cache-file=FILE'	207	`--cache-file=FILE'
160	Use and save the results of the tests in FILE instead of	208	Enable the cache: use and save the results of the tests in FILE,
161	`./config.cache'. Set FILE to `/dev/null' to disable caching, for	209	traditionally `config.cache'. FILE defaults to `/dev/null' to
162	debugging `configure'.	210	disable caching.
163		211
164	`--help'	212	`--config-cache'
165	Print a summary of the options to `configure', and exit.	213	`-C'
		214	Alias for `--cache-file=config.cache'.
166		215
167	`--quiet'	216	`--quiet'
168	`--silent'	217	`--silent'
169	`-q'	218	`-q'
170	Do not print messages saying which checks are being made. To	219	Do not print messages saying which checks are being made. To
…		…
173		222
174	`--srcdir=DIR'	223	`--srcdir=DIR'
175	Look for the package's source code in directory DIR. Usually	224	Look for the package's source code in directory DIR. Usually
176	`configure' can determine that directory automatically.	225	`configure' can determine that directory automatically.
177		226
178	`--version'
179	Print the version of Autoconf used to generate the `configure'
180	script, and exit.
181
182	`configure' also accepts some other, not widely useful, options.	227	`configure' also accepts some other, not widely useful, options. Run
		228	`configure --help' for more details.
		229

 Legend:



Removed from v.152
 


changed lines


 
Added in v.154
 Legend:



Removed from v.152
 


changed lines


 
Added in v.154
-Removed from v.152
+Added in v.154

frodo@frodo.looijaard.name	ViewVC Help
Powered by ViewVC 1.1.26