From 5a2d216f309fa91faf76a1ebebbcf8a36e21f592 Mon Sep 17 00:00:00 2001 From: Ebrahim Byagowi Date: Tue, 4 Aug 2020 15:25:48 +0430 Subject: [PATCH] [docs] meson related updates on install --- docs/usermanual-install-harfbuzz.xml | 83 ++++++++++------------------ 1 file changed, 29 insertions(+), 54 deletions(-) diff --git a/docs/usermanual-install-harfbuzz.xml b/docs/usermanual-install-harfbuzz.xml index e9d9a35c5..eab399733 100644 --- a/docs/usermanual-install-harfbuzz.xml +++ b/docs/usermanual-install-harfbuzz.xml @@ -71,8 +71,8 @@ From a shell in the top-level directory of the extracted source - code, you can run ./configure followed by - make as with any other standard package. + code, you can run meson build followed by + meson compile -C build as with any other standard package. This should leave you with a shared @@ -85,25 +85,23 @@ (2)(b) If you are building from the source in the HarfBuzz git repository, rather than installing from a downloaded tarball release, then you must install two more auxiliary tools before you - can build for the first time: pkg-config and - ragel. + can build for the first time: pkg-config. On Ubuntu or Debian, run: - sudo apt-get install autoconf automake libtool pkg-config ragel gtk-doc-tools + sudo apt-get install meson pkg-config gtk-doc-tools On Fedora, RHEL, CentOS, run: - sudo yum install autoconf automake libtool pkgconfig ragel gtk-doc + sudo yum install meson pkgconfig gtk-doc - With pkg-config and ragel - installed, you can now run ./autogen.sh, - followed by ./configure and - make to build HarfBuzz. + With pkg-config installed, you can now run + meson build then + meson compile -C build to build HarfBuzz. @@ -112,18 +110,8 @@ Building on Windows - On Windows, consider using Microsoft's free vcpkg utility - to build HarfBuzz, its dependencies, and other open-source - libraries. - - - If you need to build HarfBuzz from source, first put the - ragel binary on your - PATH, then follow the appveyor CI cmake - build - instructions. + Install meson and use it like `meson build --wrap-mode=default` + or use vcpkg. @@ -160,11 +148,11 @@ from a downloaded tarball release, extract the tarball and open a Terminal in the extracted source-code directory. Run: - ./configure + meson build followed by: - make + meson compile -C build to build HarfBuzz. @@ -177,28 +165,28 @@ If you are using MacPorts, you should run: - sudo port install autoconf automake libtool pkgconfig ragel gtk-doc + sudo port install meson pkgconfig gtk-doc to install the build dependencies. If you are using Homebrew, you should run: - brew install autoconf automake libtool pkgconfig ragel gtk-doc + brew install meson pkgconfig gtk-doc Finally, you can run: - ./autogen.sh + meson build (3) You can now build HarfBuzz (on either a MacPorts or a Homebrew system) by running: - ./configure + meson build followed by: - make + meson compile -C build @@ -221,22 +209,9 @@ - + - --with-libstdc++ - - - Allow linking with libstdc++. (Default = no) - - - This option enables or disables linking HarfBuzz to the - system's libstdc++ library. - - - - - - --with-glib + -Dglib=enabled Use GLib. (Default = auto) @@ -252,7 +227,7 @@ - --with-gobject + -Dgobject=enabled Use GObject. (Default = no) @@ -268,7 +243,7 @@ - --with-cairo + -Dcairo=enabled Use Cairo. (Default = auto) @@ -287,7 +262,7 @@ - --with-fontconfig + -Dfontconfig=enabled Use Fontconfig. (Default = auto) @@ -307,7 +282,7 @@ - --with-icu + -Dicu=enabled Use the ICU library. (Default = auto) @@ -325,7 +300,7 @@ - --with-graphite2 + -Dgraphite=enabled Use the Graphite2 library. (Default = no) @@ -339,7 +314,7 @@ - --with-freetype + -Dfreetype=enabled Use the FreeType library. (Default = auto) @@ -354,7 +329,7 @@ - --with-uniscribe + -Dgdi=enabled Use the - --with-directwrite + -Ddirectwrite=enabled Use the DirectWrite library (experimental). (Default = no) @@ -388,7 +363,7 @@ - --with-coretext + -Dcoretext=enabled Use the CoreText library. (Default = no) @@ -401,7 +376,7 @@ - --enable-gtk-doc + -Ddocs=enabled Use GTK-Doc. (Default = no)