Index: x/installing/tuning-fontconfig.xml
===================================================================
--- x/installing/tuning-fontconfig.xml	(revision d1d1e5d284275caaf0720169edaebea3b6c343ab)
+++ x/installing/tuning-fontconfig.xml	(revision 9d8ea2319b5a9b11c23362ef3e79e75d7cc76908)
@@ -37,4 +37,47 @@
       to understand the changes you are making.
     </para>
+
+    <para>The following links are to assist navigation in this page.</para>
+    <itemizedlist>
+      <listitem>
+        <para><xref linkend="xft-font-protocol"/></para>
+      </listitem>
+      <listitem>
+        <para><xref linkend="useful-commands"/></para>
+      </listitem>
+      <listitem>
+        <para><xref linkend="the-various-files"/></para>
+      </listitem>
+      <listitem>
+        <para><xref linkend="rules-to-choose-a-font"/></para>
+      </listitem>
+      <listitem>
+        <para><xref linkend="hinting-and-antialiasing"/></para>
+      </listitem>
+      <listitem>
+        <para><xref linkend="disabling-bitmap-fonts"/></para>
+      </listitem>
+      <listitem>
+        <para><xref linkend="adding-extra-directories"/></para>
+      </listitem>
+      <listitem>
+        <para><xref linkend="preferring-certain-fonts"/></para>
+      </listitem>
+      <listitem>
+        <para><xref linkend="fontconfig-user-docs"/></para>
+      </listitem>
+      <listitem>
+        <para><xref linkend="prefer-a-specific-font"/></para>
+      </listitem>
+      <listitem>
+        <para><xref linkend="prefer-chosen-CJK-fonts"/></para>
+      </listitem>
+      <listitem>
+        <para><xref linkend="editing-old-style-conf-files"/></para>
+      </listitem>
+      <listitem>
+        <para><xref linkend="see-also"/></para>
+      </listitem>
+    </itemizedlist>
 
     </sect2>
@@ -90,5 +133,7 @@
 
     <para>
-      The following commands may be helpful when working with fontconfig:
+      The following commands may be helpful when working with fontconfig,
+      particularly if you are interested in overriding which font will be
+      chosen. 'TYPE' should be one of serif, sans-serif or monospace.
     </para>
 
@@ -110,9 +155,10 @@
 
     <para>
-      <command>fc-match -a 'Type' | less</command> : provides a list of all
-      fonts which can be used for that type (Monospace, Sans, Serif). Note that
-      in-extremis <application>fontconfig</application> will take a glyph from
-      any available font, even if it is not of the specified type, and unless it
-      knows about the font's type it will assume it is Sans.
+      <command>fc-match -a <replaceable>Type</replaceable> | less</command> :
+      provides a list of all fonts which can be used for that type (Monospace,
+      Sans Sasn-serif, Serif <emphasis>(capital letters optional)</emphasis>).
+      Note that in-extremis <application>fontconfig</application> will take a
+      glyph from any available font, even if it is not of the specified type,
+      and unless it knows about the font's type it will assume it is Sans.
     </para>
 
@@ -122,5 +168,10 @@
       It does not mean that the reported font will necessarily be able to show
       Japanese ideograms, so a fallback might be used, or some glyphs may be
-      missing.
+      missing. For language codes use  ISO-639 value such as 'fr', 'ja', 'zh-cn'.
+      Note that an unrecognized value such as just 'zh' will not return any
+      match. To illustrate the fallback, on a system wherei both Noto Sans Mono
+      and DejaVu Sans Mono are installed, <command>fc-match 'monospace
+      :lang=en</command> shows Noto Sans Mono will be used, but if the lang is
+      changed to 'ar' (arabic) DejaVu Sans will be used.
     </para>
 
@@ -140,11 +191,11 @@
       particularly useful for CJK languages, and you can also pass a
       language, e.g. PANGO_LANGUAGE=en;ja (English, then assume Japanese)
-      or just zh-cn (or other variants - 'zh' on its own is not valid).
+      or just zh-cn (or other variants such as zh-sg or zh-tw).
     </para>
 
     </sect2>
 
-    <sect2 role="configuration" id="the-various-files" xreflabel="The various files">
-    <title>The various files</title>
+    <sect2 role="configuration" id="the-various-files" xreflabel="The configuration files">
+    <title>The configuation files</title>
 
     <para>
@@ -553,5 +604,5 @@
 
     <bridgehead renderas="sect3" id="prefer-a-specific-font"
-    xreflabel="fontconfig-prefer-specific-font">Prefer a specific font</bridgehead>
+    xreflabel="prefer-specific-font">Prefer a specific font</bridgehead>
 
       <para>
