2021-08-19 22:53:54 +08:00
|
|
|
|
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
|
2021-04-28 12:43:51 +08:00
|
|
|
|
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
|
2021-08-19 22:53:54 +08:00
|
|
|
|
should work too, of course. Note that `autogen.sh` also sets up
|
|
|
|
|
|
proper file permissions for the `configure` and auxiliary scripts.
|
2021-04-28 12:43:51 +08:00
|
|
|
|
|
2021-08-19 22:53:54 +08:00
|
|
|
|
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.
|
2021-04-28 12:43:51 +08:00
|
|
|
|
|
2021-08-19 22:53:54 +08:00
|
|
|
|
Note that `aclocal` is provided by the 'automake' package on Linux,
|
|
|
|
|
|
and that `libtoolize` is called `glibtoolize` on Darwin (OS X).
|
2021-04-28 12:43:51 +08:00
|
|
|
|
|
|
|
|
|
|
|
2021-08-19 22:53:54 +08:00
|
|
|
|
alternative build methods
|
|
|
|
|
|
-------------------------
|
|
|
|
|
|
|
|
|
|
|
|
For static builds that don't use platform-specific optimizations, no
|
2021-04-28 12:43:51 +08:00
|
|
|
|
configure script is necessary at all; saying
|
|
|
|
|
|
|
|
|
|
|
|
make setup ansi
|
|
|
|
|
|
make
|
|
|
|
|
|
|
2021-08-19 22:53:54 +08:00
|
|
|
|
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
|
2021-04-28 12:43:51 +08:00
|
|
|
|
|
2021-08-19 22:53:54 +08:00
|
|
|
|
To make it actually work, add to file `.git/config` in the FreeType
|
|
|
|
|
|
git repository (or to your `$HOME/.gitconfig` file) the lines
|
2021-04-28 12:43:51 +08:00
|
|
|
|
|
2021-08-19 22:53:54 +08:00
|
|
|
|
[merge "merge-changelog"]
|
|
|
|
|
|
name = GNU-style ChangeLog merge driver
|
|
|
|
|
|
driver = /usr/local/bin/git-merge-changelog %O %A %B
|
2021-04-28 12:43:51 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
|
|
|
2021-08-19 22:53:54 +08:00
|
|
|
|
Copyright (C) 2005-2021 by
|
2021-04-28 12:43:51 +08:00
|
|
|
|
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 ---
|
