Changeset 8251b48

Timestamp:

08/30/2023 12:58:02 AM (9 months ago)

Author:

Douglas R. Reno <renodr@…>

Branches:

12.0, 12.1, ken/TL2024, ken/tuningfonts, lazarus, plabs/newcss, python3.11, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18

Children:

fcf7e13

Parents:

a41ab12f

Message:

Tuning Fontconfig: Minor text tweaks

File:

• x/installing/tuning-fontconfig.xml (modified) (16 diffs)

x/installing/tuning-fontconfig.xml

@@ -49 +49 @@
       <xref linkend="rxvt-unicode"/> which can use fonts listed in
       <filename>~/.Xresources</filename>, and <xref linkend="abiword"/> which
-      only uses the specified font).  The default search path is <filename
+      only uses the specified font). The default search path is <filename
       class="directory">/usr/share/fonts</filename> and <filename
-      class="directory">~/.local/share/fonts</filename> although for the moment
+      class="directory">~/.local/share/fonts</filename>, although for the moment
       the old and deprecated location <filename
       class="directory">~/.fonts</filename> still works.
       <application>Fontconfig</application> searches directories in its path
       recursively and maintains a cache of the font characteristics in each
-      directory.  If the cache appears to be out of date, it is ignored, and
+      directory. If the cache appears to be out of date, it is ignored, and
       information is fetched from the fonts themselves (that can take a few
-      seconds if you installed a lot of fonts).
+      seconds if you have a lot of fonts installed).
     </para>
 
@@ -94 +94 @@
 
     <para>
-      <command>fc-list | less</command> : show a list of all available fonts
+      <command>fc-list | less</command> : shows a list of all available fonts
       (/path/to/filename: Font Name:style). If you installed a font more than
       30 seconds ago but it does not show, then it or one of its directories is
@@ -101 +101 @@
 
     <para>
-      <command>fc-match 'Font Name'</command> : will tell you which font will
+      <command>fc-match 'Font Name'</command> : tells you which font will
       be used if the named font is requested. Typically you would use this to
       see what happens if a font you have not installed is requested, but you
       can also use it if the system is giving you a different font from
       what you expected (perhaps because <application>fontconfig</application>
-      does not agree that the font supports your language).
-    </para>
-
-    <para>
-      <command>fc-match -a 'Type' | less</command> : will provide a list of all
+      does not think that the font supports your language).
+    </para>
+
+    <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
@@ -161 +161 @@
       <listitem>
         <para>
-          10-19 system rendering defaults (antialiasing etc)
+          10-19 system rendering defaults (such as antialiasing)
         </para>
       </listitem>
@@ -208 +208 @@
     <para>
       You can also have a personal <filename>fonts.conf</filename> in
-      $XDG_CONFIG_HOME which is <filename
-      class="directory">~/.config/fontconfig/</filename>.
+      $XDG_CONFIG_HOME (which is <filename
+      class="directory">~/.config/fontconfig/</filename>).
     </para>
 
@@ -225 +225 @@
 
     <para>
-      But if the document or page requested a font which is not installed
+      However, if the document or page requested a font which is not installed
       (or, occasionally, does not contain all the required codepoints) the
       following rules come into play: First,
@@ -238 +238 @@
       Persian and other non-latin writing systems. All of these files prefer
       commercial fonts if they are present, although modern libre fonts are
-      often at least their equals.
-    </para>
-
-    <para>
-      Since fontconfig-2.12.5 there is also generic family matching for some
-      emoji and math fonts, see {45,60}-generic.conf.
+      often at least equal.
+    </para>
+
+    <para>
+      Since fontconfig-2.12.5, there is also generic family matching for some
+      emoji and math fonts, please see {45,60}-generic.conf.
     </para>
 
@@ -268 +268 @@
     <para>
       To try out different settings, you may need to exit from Xorg and then
-      rerun <command>startx</command> so that all applications use the new
-      settings. And if you use Gnome or KDE their desktops can override these
-      changes. To explore the possibilities, create a file for your user:
+      run <command>startx</command> again so that all applications use the new
+      settings. If you use GNOME, KDE, or LXQt, their desktops can override
+      these changes. To explore the possibilities, create a file for your user:
     </para>
 
@@ -340 +340 @@
       installed. Now, many people will not need to install any of them. But if
       for some reason you have installed one or more bitmap fonts, you can
-      prevent them being used by <application>fontconfig</application> by
-      creating the following file as the
-      <systemitem class="username">root</systemitem> user :
+      prevent them from being used by <application>fontconfig</application> by
+      creating the following file as the &root; user :
     </para>
 
@@ -381 +380 @@
       <listitem>
         <para>
-          There are hundreds of files, which makes selecting the font hard.
+          There are hundreds of files, which makes selecting fonts difficult.
         </para>
       </listitem>
@@ -396 +395 @@
         <para>
           Several fonts have multiple sizes and impenetrable short names, which
-          both make selecting the correct font even harder.
+          both make selecting the correct font even more difficult.
         </para>
       </listitem>
@@ -441 +440 @@
 
   </sect2>
-
 
   <sect2 role="configuration" id="preferring-certain-fonts" xreflabel="Preferring certain fonts">
@@ -471 +469 @@
       <para>
         If you have installed the current version, the user documentation is
-        available in html, PDF and text versions at <filename
+        available in HTML, PDF, and text versions at <filename
         class="directory">/usr/share/doc/fontconfig-&fontconfig-version;/</filename>
         : change the version if you installed a different one.
@@ -603 +601 @@
   <sect2 role="configuration" id="editing-old-style-conf-files"
   xreflabel="Editing Old-Style conf files">
-  <title>Editing Old-style conf files</title>
+  <title>Editing Old-Style conf files</title>
 
     <para>
@@ -636 +634 @@
       The following example is the first part of
       <filename>64-arphic-uming.conf</filename> from <xref linkend="UMing"/> -
-      there are a lot more similar items which also need changing :
+      there are many more similar items which also need changing :
     </para>
 
@@ -657 +655 @@
     <para>
       The process to correct this is straightforward but tedious - for every
-      item which produces an error message, using your editor (as the
-      <systemitem class="username">root</systemitem> user) edit the installed
+      item which produces an error message, using your editor (as the &root;
+      user), edit the installed
       file to repeat the whole block as many times as there are multiple
       variables, then reduce each example to have only one of them. You may