| README.git |
| ========== |
| |
| |
| repository issues |
| ----------------- |
| |
| FreeType's official repository site is |
| |
| https://gitlab.freedesktop.org/freetype , |
| |
| from which the 'freetype.git' and 'freetype-demos.git' repositories |
| can be cloned in the usual way. |
| |
| git clone https://gitlab.freedesktop.org/freetype/freetype.git |
| git clone https://gitlab.freedesktop.org/freetype/freetype-demos.git |
| |
| If you want to use the Savannah mirror instead, you have to do a |
| slightly different incantation because the repository names contain |
| digit '2' for historical reasons. |
| |
| git clone \ |
| https://git.savannah.nongnu.org/git/freetype/freetype2.git \ |
| freetype |
| git clone \ |
| https://git.savannah.nongnu.org/git/freetype/freetype2-demos.git \ |
| freetype-demos |
| |
| |
| standard builds with `configure` |
| -------------------------------- |
| |
| The git repository doesn't contain pre-built configuration scripts for |
| UNIXish platforms. To generate them say |
| |
| sh autogen.sh |
| |
| which in turn depends on the following packages: |
| |
| automake (1.10.1) |
| libtool (2.2.4) |
| autoconf (2.62) |
| |
| The versions given in parentheses are known to work. Newer versions |
| should work too, of course. Note that `autogen.sh` also sets up |
| proper file permissions for the `configure` and auxiliary scripts. |
| |
| The `autogen.sh` script checks whether the versions of the above three |
| tools match the numbers above. Otherwise it will complain and suggest |
| either upgrading or using environment variables to point to more |
| recent versions of the required tools. |
| |
| Note that `aclocal` is provided by the 'automake' package on Linux, |
| and that `libtoolize` is called `glibtoolize` on Darwin (OS X). |
| |
| |
| alternative build methods |
| ------------------------- |
| |
| For static builds that don't use platform-specific optimizations, no |
| configure script is necessary at all; saying |
| |
| make setup ansi |
| make |
| |
| should work on all platforms that have GNU `make` (or `makepp`). |
| |
| A build with `cmake` or `meson` can be done directly from the git |
| repository. However, if you want to use the `FT_DEBUG_LOGGING` macro |
| (see file `docs/DEBUG` for more information) it is currently mandatory |
| to execute `autogen.sh` in advance; this script clones the 'dlg' git |
| submodule and copies some files into FreeType's source tree. |
| |
| |
| contributing |
| ------------ |
| |
| If you want to contribute to FreeType it is recommended to install the |
| `git-merge-changelog` program – we use a `ChangeLog` file, which often |
| prevents simple merging due to conflicts. Most GNU/Linux |
| distributions have a package for this program; otherwise you can |
| install it via the 'gnulib' git repository. Detailed instructions can |
| be found at the beginning of |
| |
| https://git.savannah.gnu.org/cgit/gnulib.git/tree/lib/git-merge-changelog.c |
| |
| To make it actually work, add to file `.git/config` in the FreeType |
| git repository (or to your `$HOME/.gitconfig` file) the lines |
| |
| [merge "merge-changelog"] |
| name = GNU-style ChangeLog merge driver |
| driver = /usr/local/bin/git-merge-changelog %O %A %B |
| |
| |
| ---------------------------------------------------------------------- |
| |
| Copyright (C) 2005-2021 by |
| David Turner, Robert Wilhelm, and Werner Lemberg. |
| |
| This file is part of the FreeType project, and may only be used, |
| modified, and distributed under the terms of the FreeType project |
| license, LICENSE.TXT. By continuing to use, modify, or distribute |
| this file you indicate that you have read the license and understand |
| and accept it fully. |
| |
| |
| --- end of README.git --- |