diff --git a/docs/usermanual-buffers-language-script-and-direction.xml b/docs/usermanual-buffers-language-script-and-direction.xml
index 9eddb71a9..68ce9bd0b 100644
--- a/docs/usermanual-buffers-language-script-and-direction.xml
+++ b/docs/usermanual-buffers-language-script-and-direction.xml
@@ -1,3 +1,9 @@
+
+
+
+]>
Buffers, language, script and direction
@@ -74,4 +80,4 @@ void somefunc(hb_buffer_t *buffer) {
-
\ No newline at end of file
+
diff --git a/docs/usermanual-clusters.xml b/docs/usermanual-clusters.xml
index 608371b00..7b2c7adc7 100644
--- a/docs/usermanual-clusters.xml
+++ b/docs/usermanual-clusters.xml
@@ -1,3 +1,9 @@
+
+
+
+]>
Clusters
diff --git a/docs/usermanual-fonts-and-faces.xml b/docs/usermanual-fonts-and-faces.xml
index 7de0f051a..553600439 100644
--- a/docs/usermanual-fonts-and-faces.xml
+++ b/docs/usermanual-fonts-and-faces.xml
@@ -1,3 +1,9 @@
+
+
+
+]>
Fonts and faces
-
\ No newline at end of file
+
diff --git a/docs/usermanual-getting-started.xml b/docs/usermanual-getting-started.xml
index f8f525c65..9e16ecbf2 100644
--- a/docs/usermanual-getting-started.xml
+++ b/docs/usermanual-getting-started.xml
@@ -1,3 +1,9 @@
+
+
+
+]>
Getting started with HarfBuzz
diff --git a/docs/usermanual-glyph-information.xml b/docs/usermanual-glyph-information.xml
index ca674c0c5..78f06c739 100644
--- a/docs/usermanual-glyph-information.xml
+++ b/docs/usermanual-glyph-information.xml
@@ -1,3 +1,9 @@
+
+
+
+]>
Glyph information
@@ -5,4 +11,4 @@
-
\ No newline at end of file
+
diff --git a/docs/usermanual-install-harfbuzz.xml b/docs/usermanual-install-harfbuzz.xml
index 54b5fc954..a6484fc5a 100644
--- a/docs/usermanual-install-harfbuzz.xml
+++ b/docs/usermanual-install-harfbuzz.xml
@@ -1,3 +1,9 @@
+
+
+
+]>
Installing HarfBuzz
@@ -376,11 +382,16 @@
--with-uniscribe
- Use the Uniscribe library. (Default = no)
+ Use the Uniscribe
+ library (experimental). (Default = no)
This option enables or disables usage of the Uniscribe
- font-rendering library. Uniscribe is available on Windows systems.
+ font-rendering library. Uniscribe is available on
+ Windows systems. Uniscribe support is used only for
+ testing purposes and does not need to be enabled for
+ HarfBuzz to run on Windows systems.
@@ -393,7 +404,10 @@
This option enables or disables usage of the DirectWrite
- font-rendering library. DirectWrite is available on Windows systems.
+ font-rendering library. DirectWrite is available on
+ Windows systems. DirectWrite support is used only for
+ testing purposes and does not need to be enabled for
+ HarfBuzz to run on Windows systems.
diff --git a/docs/usermanual-opentype-features.xml b/docs/usermanual-opentype-features.xml
index 470bab8d1..51ff55a77 100644
--- a/docs/usermanual-opentype-features.xml
+++ b/docs/usermanual-opentype-features.xml
@@ -1,3 +1,9 @@
+
+
+
+]>
Shaping and shape plans
-
\ No newline at end of file
+
diff --git a/docs/usermanual-shaping-concepts.xml b/docs/usermanual-shaping-concepts.xml
index 8c49ab136..bc9f1b830 100644
--- a/docs/usermanual-shaping-concepts.xml
+++ b/docs/usermanual-shaping-concepts.xml
@@ -1,3 +1,9 @@
+
+
+
+]>
Shaping concepts
diff --git a/docs/usermanual-what-is-harfbuzz.xml b/docs/usermanual-what-is-harfbuzz.xml
index 4d9acc99f..8532d7cc2 100644
--- a/docs/usermanual-what-is-harfbuzz.xml
+++ b/docs/usermanual-what-is-harfbuzz.xml
@@ -91,7 +91,8 @@
engines in Firefox, LibreOffice, and Chromium. Unless you are
writing one of these layout engines
yourself, you will probably not need to use HarfBuzz: normally,
- lower-level libraries will turn text into glyphs for you.
+ a layout engine, toolkit, or other library will turn text into
+ glyphs for you.
However, if you are writing a layout engine
@@ -301,8 +302,8 @@
In addition to OpenType shaping, HarfBuzz supports the latest
- version of Graphite shaping. HarfBuzz currently supports AAT
- shaping only on macOS and iOS systems.
+ version of Graphite shaping (the "Graphite 2" model) and AAT
+ shaping.
@@ -313,8 +314,9 @@
- HarfBuzz can run on top of the FreeType, CoreText, DirectWrite,
- or Uniscribe font renderers.
+ HarfBuzz is designed and tested to run on top of the FreeType
+ font renderer. It can run on Linux, Android, Windows, macOS, and
+ iOS systems.