diff options
Diffstat (limited to 'freetype/docs/INSTALL')
-rw-r--r-- | freetype/docs/INSTALL | 82 |
1 files changed, 53 insertions, 29 deletions
diff --git a/freetype/docs/INSTALL b/freetype/docs/INSTALL index 814fc7bc..be56e02c 100644 --- a/freetype/docs/INSTALL +++ b/freetype/docs/INSTALL @@ -4,65 +4,89 @@ your system and the level of customization you need. Here is a short overview of the documentation available: -I. Normal installation and upgrades -=================================== +I. Prerequisites and dependencies +================================= - 1. Unix Systems (including Mac OS X, Cygwin, and MSys on Windows) + FreeType is a low level C library that only depends on the standard + C library with very few platform-dependent optimizations utilized at + build time. Any C99-compliant compiler should be able to compile + FreeType. System libraries, such as zlib, Gzip, bzip2, Brotli, + and libpng, might be used to handle compressed fonts or decode + embedded PNG glyphs. - Please read `INSTALL.UNIX' to install or upgrade FreeType 2 on a + FreeType auto-configuration scripts should be able to detect the + prerequisites if the necessary headers are available at the default + locations. Otherwise, modify `include/freetype/config/ftoption.h` + to control how the FreeType library gets built. Normally, you don't + need to change anything. + + Applications have very limited control over FreeType's behaviour at + run-time; look at the documentation of function `FT_Property_Set`. + + +II. Normal installation and upgrades +==================================== + + 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 Make). GNU Make VERSION 3.81 OR NEWER IS NEEDED! - [For `cmake' see below.] + 2. Other systems using GNU Make - 2. On VMS with the `mms' build tool + 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. - See `INSTALL.VMS' for installation instructions on this platform. + Instructions are provided in the file `INSTALL.GNU`. - 3. Other systems using GNU Make + 3. Other build tools and platforms. - 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. + A few other tools can be used to build FreeType. You can find + the corresponding instruction files in the FreeType root folder + or the builds/ sub-folder. - Instructions are provided in the file `INSTALL.GNU'. + CMake :: see `CMakeLists.txt` for more information + Meson :: see `meson.build` for more information + MSBuild :: see `builds/windows/vc2010/freetype.vcxproj` + MMS :: see `vms_make.com` and `docs/INSTALL.VMS` 4. With an IDE Project File (e.g., for Visual Studio or CodeWarrior) - We provide a small number of `project files' for various IDEs to + We provide a small number of 'project files' for various IDEs to automatically build the library as well. Note that these files - are not supported and only sporadically maintained by FreeType - developers, so don't expect them to work in each release. + are not actively supported by FreeType developers, they can break + or become obsolete. - To find them, have a look at the content of the `builds/<system>' + To find them, have a look at the content of the `builds/<system>` directory, where <system> stands for your OS or environment. - 5. Using cmake - - See the top-level `CMakeLists.txt' file for more information. - - - 6. From you own IDE, or own Makefiles + 5. From you own IDE, or own Makefiles If you want to create your own project file, follow the - instructions given in the `INSTALL.ANY' document of this + instructions given in the `INSTALL.ANY` document of this directory. -II. Custom builds of the library -================================ +III. Custom builds of the library +================================= Customizing the compilation of FreeType is easy, and allows you to select only the components of the font engine that you really need. - For more details read the file `CUSTOMIZE'. + For more details read the file `CUSTOMIZE`. ---------------------------------------------------------------------- @@ -73,11 +97,11 @@ II. Custom builds of the library https://makepp.sourceforge.net for more information; you need version 2.0 or newer, and you must - pass option `--norc-substitution'. + pass option `--norc-substitution`. ---------------------------------------------------------------------- -Copyright (C) 2000-2020 by +Copyright (C) 2000-2021 by David Turner, Robert Wilhelm, and Werner Lemberg. This file is part of the FreeType project, and may only be used, |