diff --git a/docs/usermanual-buffers-language-script-and-direction.xml b/docs/usermanual-buffers-language-script-and-direction.xml
index 9eddb71a9cb65874e8d1234024828ccffec8ab21..68ce9bd0b7489e78d2c96e06b1a784f61c494a9e 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 608371b00d7a5a5d271876c0ec7a634d11071a0f..7b2c7adc707ce22011a5401ea85d3885774b8fe7 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 7de0f051a80eca77332c4adceceb17552f68df79..55360043904bc7996f564501b535012fed8aa9ee 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 f8f525c65ac173f8be644d3a5c91dd9ae82cf861..9e16ecbf288c246593efc6b568d0c3ea8feb2911 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 ca674c0c588d7404eaddb3a5ce82501bf551dbf5..78f06c73912ac67b1815fa10093ab4a688107708 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 54b5fc9542e07a3ed4e5f1a152a38fd80fc63415..a6484fc5aee5a38926430847cf643b1bfd828cda 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 470bab8d1fb57f608133310c09830edae90e7680..51ff55a770e371a2eca9f4426bfc2f8c8b8f28b8 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 8c49ab136a5a4fc6e97f21f0e5fcecbe8c413054..bc9f1b8302ed910e8ec62292a9f4dac4c48e7ade 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 4d9acc99f0dd2c71c005cca0e8d7742cc303b83a..8532d7cc2b617cb7f880297e6b39e5bad2bc7d44 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.