diff --git a/docs/usermanual-install-harfbuzz.xml b/docs/usermanual-install-harfbuzz.xml
index f032b888d..cd1e2e134 100644
--- a/docs/usermanual-install-harfbuzz.xml
+++ b/docs/usermanual-install-harfbuzz.xml
@@ -229,6 +229,10 @@
Allow linking with libstdc++. (Default = no)
+
+ This option enables or disables linking HarfBuzz to the
+ system's libstdc++ library.
+
@@ -236,8 +240,15 @@
--with-glib
- Use GLib. (Default = auto)
+ Use GLib. (Default = auto)
+
+ This option enables or disables usage of the GLib
+ library. The default setting is to check for the
+ presence of GLib and, if it is found, build with
+ GLib support. GLib is native to GNU/Linux systems but is
+ available on other operating system as well.
+
@@ -245,8 +256,15 @@
--with-gobject
- Use GObject. (Default = no)
-
+ Use GObject. (Default = no)
+
+
+ This option enables or disables usage of the GObject
+ library. The default setting is to check for the
+ presence of GObject and, if it is found, build with
+ GObject support. GObject is native to GNU/Linux systems but is
+ available on other operating system as well.
+
@@ -254,8 +272,14 @@
--with-cairo
- Use Cairo. (Default = auto)
-
+ Use Cairo. (Default = auto)
+
+
+ This option enables or disables usage of the Cairo
+ graphics-rendering library. The default setting is to
+ check for the presence of Cairo and, if it is found,
+ build with Cairo support.
+
@@ -263,8 +287,15 @@
--with-fontconfig
- Use Fontconfig. (Default = auto)
+ Use Fontconfig. (Default = auto)
+
+ This option enables or disables usage of the Fontconfig
+ library, which provides font-matching functions and
+ provides access to font properties. The default setting
+ is to check for the presence of Fontconfig and, if it is
+ found, build with Fontconfig support.
+
@@ -272,8 +303,17 @@
--with-icu
- Use the ICU library. (Default = auto)
+ Use the ICU library. (Default = auto)
+
+ This option enables or disables usage of the
+ International Components for
+ Unicode (ICU) library, which provides access
+ to Unicode Character Database (UCD) properties as well
+ as normalization and conversion functions. The default
+ setting is to check for the presence of ICU and, if it
+ is found, build with ICU support.
+
@@ -281,8 +321,17 @@
--with-ucdn
- Use the built-in UCDN library. (Default = auto)
+ Use HarfBuzz's built-in UCDN library. (Default = auto)
+
+ The HarfBuzz source tree includes a Unicode
+ Database and Normalization (UCDN) library
+ that provides access to basic character properties in
+ the Unicode Character Database (UCD) as well as low-level
+ normalization functions. HarfBuzz can be built without
+ this UCDN support if the usage of a different UCDN
+ library is desired.
+
@@ -290,8 +339,13 @@
--with-graphite2
- Use the graphite2 library. (Default = no)
+ Use the Graphite2 library. (Default = no)
+
+ This option enables or disables usage of the Graphite2
+ library, which provides support for the Graphite shaping
+ model.
+
@@ -299,8 +353,14 @@
--with-freetype
- Use the FreeType library. (Default = auto)
+ Use the FreeType library. (Default = auto)
+
+ This option enables or disables usage of the FreeType
+ font-rendering library. The default setting is to check for the
+ presence of FreeType and, if it is found, build with
+ FreeType support.
+
@@ -308,8 +368,12 @@
--with-uniscribe
- Use the Uniscribe library. (Default = no)
+ Use the Uniscribe library. (Default = no)
+
+ This option enables or disables usage of the Uniscribe
+ font-rendering library. Uniscribe is available on Windows systems.
+
@@ -317,8 +381,12 @@
--with-directwrite
- se the DirectWrite library (experimental). (Default = no)
+ Use the DirectWrite library (experimental). (Default = no)
+
+ This option enables or disables usage of the DirectWrite
+ font-rendering library. DirectWrite is available on Windows systems.
+
@@ -326,20 +394,14 @@
--with-coretext
- Use the CoreText library. (Default = no)
+ Use the CoreText library. (Default = no)
-
-
-
-
-
-
- (Default = no)
-
+ This option enables or disables usage of the CoreText
+ library. CoreText is available on macOS and iOS systems.
+
-
-
+