From 69c8f9fa3f8f494f5a69561a3e1d8afc2b55dd2f Mon Sep 17 00:00:00 2001
From: Ken Moffat <ken@linuxfromscratch.org>
Date: Thu, 7 Dec 2023 08:52:04 +0000
Subject: [PATCH] tuningfonts:

Rework second fc-match example:

'fcmatch -a TYPE | less' is useless: -a functions similarly to
fc-list, any following parameter is ignored. So the example listed
all installed font-style-weight combinations for all three TYPEs.

Replace by plain fc-match TYPE.

Remove TYPE specification from introductory paragraph, it is only
used for the replacement command here. Use the same markup for the
command and in the explanations, so that a capital TYPE in the
explanations is replaced by a smaller slanted TYPE.

The command after this shows a fuller variant with the type, lang
and weight being specified.
---
 x/installing/tuning-fontconfig.xml | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/x/installing/tuning-fontconfig.xml b/x/installing/tuning-fontconfig.xml
index 9a0cf7dc24..4ae020bef6 100644
--- a/x/installing/tuning-fontconfig.xml
+++ b/x/installing/tuning-fontconfig.xml
@@ -153,7 +153,7 @@
       The following commands may be helpful when working with
       <application>Fontconfig</application>,
       particularly if you are interested in overriding which font will be
-      chosen. 'TYPE' should be one of serif, sans-serif or monospace.
+      chosen.
     </para>
 
     <para>
@@ -173,12 +173,14 @@
     </para>
 
     <para>
-      <command>fc-match -a <replaceable>Type</replaceable> | less</command> :
-      provides a list of all fonts which can be used for that type (Monospace,
-      Sans, Sans-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.
+      <command>fc-match <replaceable>TYPE</replaceable></command> : shows which
+      font will be used in the current language for that
+      <!-- match style of TYPE in command and explanations -->
+      <replaceable>TYPE</replaceable> (Monospace, Sans, Serif <emphasis>(initial
+      capital letter is optional)</emphasis>). If that font does not map a
+      codepoint, <application>Fontconfig</application> can take a glyph from any
+      available font, even if it is not of the specified type. Any other value
+      for <replaceable>TYPE</replaceable> will be assumed to be Sans.
     </para>
 
     <para>