99 lines
3.3 KiB
Plaintext
99 lines
3.3 KiB
Plaintext
README.git
|
||
----------
|
||
|
||
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
|
||
|
||
|
||
The git archive 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 now checks the versions of the above three
|
||
packages whether they match the numbers above. Otherwise it will
|
||
complain and suggest either upgrading or using an environment variable
|
||
to point to a more recent version of the required tool(s).
|
||
|
||
Note that `aclocal` is provided by the 'automake' package on Linux,
|
||
and that `libtoolize` is called `glibtoolize` on Darwin (OS X).
|
||
|
||
|
||
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`).
|
||
Similarly, a build with `cmake` or `meson` can be done directly from
|
||
the git repository.
|
||
|
||
|
||
For using the `FT_DEBUG_LOGGING` macro while debugging (see file
|
||
`docs/DEBUG` for more information) the following git commands are
|
||
necessary to check out the 'dlg' library as a git submodule.
|
||
|
||
git submodule init
|
||
git submodule update
|
||
|
||
|
||
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 ---
|