ref: 56cc2ad446e920164e823e78a21972cadb339bfc
dir: /README.git/
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 ---