Imported Upstream version 2.6.7
[platform/upstream/harfbuzz.git] / BUILD.md
1 On Linux, install the development packages for FreeType,
2 Cairo, and GLib. For example, on Ubuntu / Debian, you would do:
3
4     sudo apt-get install gcc g++ libfreetype6-dev libglib2.0-dev libcairo2-dev
5
6 whereas on Fedora, RHEL, CentOS, and other Red Hat based systems you would do:
7
8     sudo yum install gcc gcc-c++ freetype-devel glib2-devel cairo-devel
9
10 on Windows, consider using [vcpkg](https://github.com/Microsoft/vcpkg)
11 or `meson build && ninja -Cbuild`.
12
13 on macOS, using MacPorts:
14
15     sudo port install freetype glib2 cairo
16
17 or using Homebrew:
18
19     brew install freetype glib cairo
20
21 If you are using a tarball, you can now proceed to running configure and make
22 as with any other standard package. That should leave you with a shared
23 library in `src/`, and a few utility programs including `hb-view` and `hb-shape`
24 under `util/`.
25
26 If you are bootstrapping from git, you need a few more tools before you can
27 run `autogen.sh` for the first time. Namely, `pkg-config` and `ragel`.
28
29 Again, on Ubuntu / Debian:
30
31     sudo apt-get install autoconf automake libtool pkg-config ragel gtk-doc-tools
32
33 and on Fedora, RHEL, CentOS:
34
35     sudo yum install autoconf automake libtool pkgconfig ragel gtk-doc
36
37 on the Mac, using MacPorts:
38
39     sudo port install autoconf automake libtool pkgconfig ragel gtk-doc
40
41 or using Homebrew:
42
43     brew install autoconf automake libtool pkgconfig ragel gtk-doc
44
45 To build the Python bindings, you also need:
46
47     brew install pygobject3