ref: ff34ea8eda9bc679761c80de44718709d8419b03
parent: e1f364e5097008c845f1963f938b6e8adab5e4e6
author: Werner Lemberg <wl@gnu.org>
date: Sat Feb 27 06:02:53 EST 2021
Improve build documentation. Fixes #1012.
--- a/README
+++ b/README
@@ -15,6 +15,9 @@
Read the files `docs/INSTALL*` for installation instructions; see the
file `docs/LICENSE.TXT` for the available licenses.
+For using FreeType's git repository instead of a distribution bundle,
+please read file `README.git`.
+
The FreeType 2 API reference is located in directory `docs/reference`;
use the file `index.html` as the top entry point. [Please note that
currently the search function for locally installed documentation
--- a/docs/INSTALL
+++ b/docs/INSTALL
@@ -7,8 +7,20 @@
I. Normal installation and upgrades
===================================
- 1. Unix Systems (including Mac OS X, Cygwin, and MSys on Windows)
+ 0. Modify `include/freetype/config/ftoption.h', if necessary, to
+ control how the FreeType library gets built. Normally, you don't
+ need to change anything.
+ Applications can't control FreeType's behaviour at build time.
+ To make applications control (some of) FreeType's behaviour at
+ run-time, look at the documentation of function
+ `FT_Property_Set'.
+
+ 1. Unix and Unix-like systems
+
+ This also includes MacOS, Cygwin, MinGW + MSYS, Mingw-w64 + MSYS2,
+ and possibly other, similar environments.
+
Please read `INSTALL.UNIX' to install or upgrade FreeType 2 on a
Unix system. Note that you *need* GNU Make for automatic
compilation, since other make tools won't work (this includes BSD
@@ -26,10 +38,11 @@
3. Other systems using GNU Make
- On non-Unix platforms, it is possible to build the library using
- GNU Make utility. Note that *NO OTHER MAKE TOOL WILL WORK*[1]!
- This methods supports several compilers on Windows, OS/2, and
- BeOS, including MinGW, Visual C++, Borland C++, and more.
+ On some non-Unix platforms, it is possible to build the library
+ using only the GNU Make utility. Note that *NO OTHER MAKE TOOL
+ WILL WORK*[1]! This methods supports several compilers on
+ Windows, OS/2, and BeOS, including MinGW* (without MSYS*), Visual
+ C++, Borland C++, and more.
Instructions are provided in the file `INSTALL.GNU'.
--- a/docs/INSTALL.UNIX
+++ b/docs/INSTALL.UNIX
@@ -44,8 +44,8 @@
sh autogen.sh
- In case of problems, you may need to install or upgrade Automake,
- Autoconf or Libtool. See README.git in the top-level directory
+ In case of problems, you may need to install or upgrade Automake,
+ Autoconf or Libtool. See `README.git' in the top-level directory
for more information.
@@ -52,6 +52,13 @@
3. Build and install the library
--------------------------------
+ Say
+
+ ./configure --help
+
+ to see the list of possible configuration options and important
+ environment variables.
+
The following should work on all Unix systems where the `make'
command invokes GNU Make:
@@ -74,6 +81,18 @@
If this still doesn't work, there must be a problem with your
system (e.g., you are using a very old version of GNU Make).
+
+ For library identification, FreeType's `configure' script uses the
+ `pkg-config' interface: Assuming it needs library `foo', it calls
+ the `pkg-config' program to find information on library `foo',
+ which in turn looks for a `foo.pc' file installed at the system.
+ Some platforms, however, don't come with `pkg-support'; you then
+ have to use environment variables as described by `configure
+ --help'. Example:
+
+ LIBPNG_CFLAGS="-I/path/to/libpng/include/directory" \
+ LIBPNG_LIBS="-L/path/to/libpng/lib/directory" \
+ configure ...
It is possible to compile FreeType in a different directory.
Assuming the FreeType source files in directory `/src/freetype' a