Blame - docs/INSTALL.UNX - platform/external/freetype

blob: 148338098f5aa118e932d20ca44b0fe91b92e553 [file] [log] [blame]

David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	1	This document contains instructions on how to build the FreeType library
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame^]	2	on Unix systems. This also works for emulations like Cygwin or MSys on
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	3	Win32:
				4
				5
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame^]	6	1. Ensure that you are using GNU Make
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	7	-------------------------------------
				8
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame^]	9	The FreeType build system _exclusively_ works with GNU Make. You
				10	will not be able to compile the library with the instructions below
				11	using any other alternative (including BSD Make).
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	12
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame^]	13	[Well, this is not really correct. Recently, a perl implementation
				14	of make called `makepp' has appeared which can also build FreeType 2
				15	successfully on Unix platforms. See http://makepp.sourceforge.net
				16	for more details.]
				17
				18	Trying to compile the library with a different Make tool will print
				19	a message like:
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	20
				21	Sorry, GNU make is required to build FreeType2.
				22
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame^]	23	and the build process will be aborted. If this happens, install GNU
				24	Make on your system, and use the GNUMAKE environment variable to
				25	name it.
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	26
				27
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame^]	28	2. Build and install the library
				29	--------------------------------
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	30
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame^]	31	The following should work on all Unix systems where the `make'
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	32	command invokes GNU Make:
				33
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame^]	34	./configure [options]
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	35	make
				36	make install (as root)
				37
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame^]	38	The default installation path is "/usr/local". It can be changed
				39	with the `--prefix=<path>' option. Example:
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	40
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame^]	41	./configure --prefix=/usr
				42
				43	When using a different command to invoke GNU Make, use the GNUMAKE
				44	variable. For example, if `gmake' is the command to use on your
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	45	system, do something like:
				46
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame^]	47	GNUMAKE=gmake ./configure [options]
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	48	gmake
				49	gmake install (as root)
				50
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame^]	51	If this still doesn't work, something's rotten on your system
				52	(e.g. you are using a very old version of GNU Make).
				53
				54	It is possible to compile FreeType in a different directory.
				55	Assuming the FreeType source files in directory `/src/freetype' a
				56	compilation in directory `foo' works as follows:
				57
				58	cd foo
				59	/src/freetype/configure [options]
				60	make
				61	make install
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	62
				63
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame^]	64	--- end of INSTALL.UNX --