/[public]/psiconv/trunk/INSTALL

Diff of /psiconv/trunk/INSTALL

Parent Directory | Revision Log | View Patch Patch

Revision 49		Revision 150
1	PREFACE	1	Copyright 1994, 1995, 1996, 1999, 2000, 2001, 2002 Free Software
2	=======	2	Foundation, Inc.
3		3
4	As of version 0.5, the psiconv package uses automake, autoconf and libtool.	4	This file is free documentation; the Free Software Foundation gives
5	This should make it possible to compile it on almost any architecture.	5	unlimited permission to copy, distribute and modify it.
6	Of course, this all depends on whether I have isolated all possible
7	incompatibilities. If it does not compile for you, please send me a
8	bug report, with as much information as possible, or even patches if
9	you know what causes the problems.
10
11	If your platform has no 32-bit integers (as int, long or long long), you
12	can forget about compiling libpsiconv. Sorry.
13
14	There is no manpage yet for psiconv, but try `psiconv -h' for some help.
15
16	The included format data text files are translated by `make all' from
17	Psion Word to HTML. This process should succeed with no warnings or
18	errors. If the translation is ended without problems, psiconv is probably
19	working right.
20
21	If you want to use ImageMagick, please make sure that it is version 5.x.y.
22	Version 4 will no longer work.
23
24		6
25	Basic Installation	7	Basic Installation
26	==================	8	==================
27		9
28	These are generic installation instructions.	10	These are generic installation instructions.
…		…
30	The `configure' shell script attempts to guess correct values for	12	The `configure' shell script attempts to guess correct values for
31	various system-dependent variables used during compilation. It uses	13	various system-dependent variables used during compilation. It uses
32	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.
33	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
34	definitions. Finally, it creates a shell script `config.status' that	16	definitions. Finally, it creates a shell script `config.status' that
35	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
36	`config.cache' that saves the results of its tests to speed up	18	file `config.log' containing compiler output (useful mainly for
37	reconfiguring, and a file `config.log' containing compiler output	19	debugging `configure').
38	(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.)
39		26
40	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
41	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
42	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
43	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
44	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.
45		33
46	The file `configure.in' is used to create `configure' by a program	34	The file `configure.ac' (or `configure.in') is used to create
47	called `autoconf'. You only need `configure.in' if you want to change	35	`configure' by a program called `autoconf'. You only need
48	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'.
49		38
50	The simplest way to compile this package is:	39	The simplest way to compile this package is:
51		40
52	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
53	`./configure' to configure the package for your system. If you're	42	`./configure' to configure the package for your system. If you're
…		…
77		66
78	Compilers and Options	67	Compilers and Options
79	=====================	68	=====================
80		69
81	Some systems require unusual options for compilation or linking that	70	Some systems require unusual options for compilation or linking that
82	the `configure' script does not know about. You can give `configure'	71	the `configure' script does not know about. Run `./configure --help'
83	initial values for variables by setting them in the environment. Using	72	for details on some of the pertinent environment variables.
84	a Bourne-compatible shell, you can do that on the command line like
85	this:
86	CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
87		73
88	Or on systems that have the `env' program, you can do it like this:	74	You can give `configure' initial values for configuration parameters
89	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.
90		81
91	Compiling For Multiple Architectures	82	Compiling For Multiple Architectures
92	====================================	83	====================================
93		84
94	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
…		…
97	supports the `VPATH' variable, such as GNU `make'. `cd' to the	88	supports the `VPATH' variable, such as GNU `make'. `cd' to the
98	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
99	the `configure' script. `configure' automatically checks for the	90	the `configure' script. `configure' automatically checks for the
100	source code in the directory that `configure' is in and in `..'.	91	source code in the directory that `configure' is in and in `..'.
101		92
102	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'
103	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
104	in the source code directory. After you have installed the package for	95	time in the source code directory. After you have installed the
105	one architecture, use `make distclean' before reconfiguring for another	96	package for one architecture, use `make distclean' before reconfiguring
106	architecture.	97	for another architecture.
107		98
108	Installation Names	99	Installation Names
109	==================	100	==================
110		101
111	By default, `make install' will install the package's files in	102	By default, `make install' will install the package's files in
…		…
144	`--x-libraries=DIR' to specify their locations.	135	`--x-libraries=DIR' to specify their locations.
145		136
146	Specifying the System Type	137	Specifying the System Type
147	==========================	138	==========================
148		139
149	There may be some features `configure' can not figure out	140	There may be some features `configure' cannot figure out
150	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
151	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
152	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
153	`--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
154	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
155	CPU-COMPANY-SYSTEM	148	CPU-COMPANY-SYSTEM
156		149
		150	where SYSTEM can have one of these forms:
		151
		152	OS KERNEL-OS
		153
157	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
158	`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
159	need to know the host type.	156	need to know the machine type.
160		157
161	If you are building compiler tools for cross-compiling, you can also	158	If you are _building_ compiler tools for cross-compiling, you should
162	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
163	produce code for and the `--build=TYPE' option to select the type of	160	produce code for.
164	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'.
165		166
166	Sharing Defaults	167	Sharing Defaults
167	================	168	================
168		169
169	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,
…		…
172	`configure' looks for `PREFIX/share/config.site' if it exists, then	173	`configure' looks for `PREFIX/share/config.site' if it exists, then
173	`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
174	`CONFIG_SITE' environment variable to the location of the site script.	175	`CONFIG_SITE' environment variable to the location of the site script.
175	A warning: not all `configure' scripts look for a site script.	176	A warning: not all `configure' scripts look for a site script.
176		177
177	Operation Controls	178	Defining Variables
178	==================	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	======================
179		194
180	`configure' recognizes the following options to control how it	195	`configure' recognizes the following options to control how it
181	operates.	196	operates.
182		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
183	`--cache-file=FILE'	207	`--cache-file=FILE'
184	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,
185	`./config.cache'. Set FILE to `/dev/null' to disable caching, for	209	traditionally `config.cache'. FILE defaults to `/dev/null' to
186	debugging `configure'.	210	disable caching.
187		211
188	`--help'	212	`--config-cache'
189	Print a summary of the options to `configure', and exit.	213	`-C'
		214	Alias for `--cache-file=config.cache'.
190		215
191	`--quiet'	216	`--quiet'
192	`--silent'	217	`--silent'
193	`-q'	218	`-q'
194	Do not print messages saying which checks are being made. To	219	Do not print messages saying which checks are being made. To
…		…
197		222
198	`--srcdir=DIR'	223	`--srcdir=DIR'
199	Look for the package's source code in directory DIR. Usually	224	Look for the package's source code in directory DIR. Usually
200	`configure' can determine that directory automatically.	225	`configure' can determine that directory automatically.
201		226
202	`--version'
203	Print the version of Autoconf used to generate the `configure'
204	script, and exit.
205
206	`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.49
 


changed lines


 
Added in v.150
 Legend:



Removed from v.49
 


changed lines


 
Added in v.150
-Removed from v.49
+Added in v.150

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