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

blob: 13cb896ba23b920687286605bacbce2bb7d03891 [file] [log] [blame]

Werner Lemberg	5993924	2006-01-31 20:17:42 +0000	[diff] [blame^]	1	This document contains instructions on how to build the FreeType
				2	library on Unix systems. This also works for emulations like Cygwin
				3	or MSys on Win32:
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	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	5993924	2006-01-31 20:17:42 +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
				11	below using any other alternative (including BSD Make).
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	12
Werner Lemberg	5993924	2006-01-31 20:17:42 +0000	[diff] [blame^]	13	[Well, this is not really correct. A few years ago a perl
				14	implementation of make called `makepp' has appeared which can also
				15	build FreeType 2 successfully on Unix platforms. See
Werner Lemberg	a723526	2005-08-30 00:22:46 +0000	[diff] [blame]	16
				17	http://makepp.sourceforge.net
				18
Werner Lemberg	5993924	2006-01-31 20:17:42 +0000	[diff] [blame^]	19	for more details; you need version 1.19 or newer, and you must
				20	pass option `--norc-substitution'.]
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame]	21
Werner Lemberg	5993924	2006-01-31 20:17:42 +0000	[diff] [blame^]	22	Trying to compile the library with a different Make tool will
				23	print a message like:
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	24
				25	Sorry, GNU make is required to build FreeType2.
				26
Werner Lemberg	5993924	2006-01-31 20:17:42 +0000	[diff] [blame^]	27	and the build process will be aborted. If this happens, install
				28	GNU Make on your system, and use the GNUMAKE environment variable
				29	to name it, if necessary.
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	30
				31
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame]	32	2. Build and install the library
				33	--------------------------------
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	34
Werner Lemberg	5993924	2006-01-31 20:17:42 +0000	[diff] [blame^]	35	The following should work on all Unix systems where the `make'
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	36	command invokes GNU Make:
				37
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame]	38	./configure [options]
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	39	make
				40	make install (as root)
				41
Werner Lemberg	5993924	2006-01-31 20:17:42 +0000	[diff] [blame^]	42	The default installation path is `/usr/local'. It can be changed
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame]	43	with the `--prefix=<path>' option. Example:
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	44
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame]	45	./configure --prefix=/usr
				46
Werner Lemberg	5993924	2006-01-31 20:17:42 +0000	[diff] [blame^]	47	When using a different command to invoke GNU Make, use the GNUMAKE
				48	variable. For example, if `gmake' is the command to use on your
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	49	system, do something like:
				50
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame]	51	GNUMAKE=gmake ./configure [options]
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	52	gmake
				53	gmake install (as root)
				54
Werner Lemberg	5993924	2006-01-31 20:17:42 +0000	[diff] [blame^]	55	If this still doesn't work, there must be a problem with your
				56	system (e.g., you are using a very old version of GNU Make).
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame]	57
Werner Lemberg	5993924	2006-01-31 20:17:42 +0000	[diff] [blame^]	58	It is possible to compile FreeType in a different directory.
				59	Assuming the FreeType source files in directory `/src/freetype' a
Werner Lemberg	a16c4a7	2003-04-21 13:30:27 +0000	[diff] [blame]	60	compilation in directory `foo' works as follows:
				61
				62	cd foo
				63	/src/freetype/configure [options]
				64	make
				65	make install
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	66
Werner Lemberg	5993924	2006-01-31 20:17:42 +0000	[diff] [blame^]	67	----------------------------------------------------------------------
David Turner	66cbc20	2003-03-20 07:04:40 +0000	[diff] [blame]	68
Werner Lemberg	5993924	2006-01-31 20:17:42 +0000	[diff] [blame^]	69	Copyright 2003, 2004, 2005, 2006 by
Werner Lemberg	56c368c	2005-06-04 23:00:25 +0000	[diff] [blame]	70	David Turner, Robert Wilhelm, and Werner Lemberg.
				71
Werner Lemberg	5993924	2006-01-31 20:17:42 +0000	[diff] [blame^]	72	This file is part of the FreeType project, and may only be used,
				73	modified, and distributed under the terms of the FreeType project
				74	license, LICENSE.TXT. By continuing to use, modify, or distribute
				75	this file you indicate that you have read the license and understand
				76	and accept it fully.
Werner Lemberg	56c368c	2005-06-04 23:00:25 +0000	[diff] [blame]	77
				78
				79	--- end of INSTALL.UNX ---