Sync FAQ docs re: FontCache slowness

docs/CHANGES.txt

@@ -6,7 +6,7 @@ Copyright (c) 2002-2024
 Various contributors (see below, and AUTHORS.txt)
 https://tuxpaint.org/
 
-2024.June.2 (0.9.33)
+2024.June.4 (0.9.33)
   * New Magic Tools:
     ----------------
     * Dither & Dither (Keep Color): Replaces all or part of a drawing

docs/en/FAQ.txt

@@ -5,7 +5,7 @@
         Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                 May 14, 2024
+                                 June 4, 2024
 
 +------------------------------+
 |      Table of Contents       |
@@ -504,6 +504,29 @@ Tux Paint won't run
 
 
 
+Tux Paint launches very slowly
+
+    The first time Tux Paint is launched (for a particular user), it may take a
+    minute or more to respond. The font system used by Tux Paint (FontConfig,
+    via Pango) is creating a 'cache' of information about the fonts on your
+    system. Subsequent launches of Tux Paint should be fast.
+
+    While the font cache is generated behind the scenes, Tux Paint should
+    remain interactive (showing an animated 'please wait' animation) as this
+    process runs.
+
+    If this delay persists or reoccurs, it could be that the cache is being
+    deleted — for example, in an environment (such as a school computer lab)
+    where a system is returned into a default state when a user finishes using
+    the program. Some versions of Tux Paint ship with a file, "fonts.conf" (
+    documented at freedesktop.org), which can be modified to have FontConfig
+    store the file elsewhere, e.g.:
+
+        <cachedir>C:\Documents and Settings\All Users\Application Data\
+        fontconfig\cache</cachedir>
+
+
+
 I can't quit Tux Paint
 
     The "no quit" option is set. This disables the "Quit" button in Tux Paint's

docs/en/html/FAQ.html

@@ -96,7 +96,7 @@
       </p>
 
       <p>
-        May 14, 2024      </p>
+        June  4, 2024      </p>
     </center>
 
     <table border="2"
@@ -678,6 +678,23 @@
           To disable the lockfile, add the "<code>--nolockfile</code>" argument to Tux Paint's command-line, or "<code>nolockfile=yes</code>" to the configuration file.        </p>
       </dd>
 
+      <dt>
+        Tux Paint launches very slowly      </dt>
+
+      <dd>
+        <p>
+          The first time Tux Paint is launched (for a particular user), it may take a minute or more to respond. The font system used by Tux Paint (FontConfig, via Pango) is creating a 'cache' of information about the fonts on your system. Subsequent launches of Tux Paint should be fast.        </p>
+
+        <p>
+          While the font cache is generated behind the scenes, Tux Paint should remain interactive (showing an animated 'please wait' animation) as this process runs.        </p>
+
+        <p>
+          If this delay persists or reoccurs, it could be that the cache is being deleted &mdash; for example, in an environment  (such as a school computer lab) where a system is returned into a default state when a user finishes using the program. Some versions of Tux Paint ship with a file, <nobr>"<code style='background: #EEE;'>fonts.conf</code>"</nobr> (<a href="https://fontconfig.pages.freedesktop.org/fontconfig/fontconfig-user.html">documented at freedesktop.org</a>), which can be modified to have FontConfig store the file elsewhere, e.g.:          <blockquote>
+            <code>&lt;cachedir&gt;C:\Documents and Settings\All Users\Application Data\fontconfig\cache&lt;/cachedir&gt;</code>
+          </blockquote>
+        </p>
+      </dd>
+
       <dt>
         I can't quit Tux Paint      </dt>
 

docs/es_ES.UTF-8/FAQ.txt

@@ -5,7 +5,7 @@
         Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                 mayo 14, 2024
+                                 junio 4, 2024
 
 +------------------------------+
 |      Table of Contents       |
@@ -504,6 +504,29 @@ Tux Paint won't run
 
 
 
+Tux Paint launches very slowly
+
+    The first time Tux Paint is launched (for a particular user), it may take a
+    minute or more to respond. The font system used by Tux Paint (FontConfig,
+    via Pango) is creating a 'cache' of information about the fonts on your
+    system. Subsequent launches of Tux Paint should be fast.
+
+    While the font cache is generated behind the scenes, Tux Paint should
+    remain interactive (showing an animated 'please wait' animation) as this
+    process runs.
+
+    If this delay persists or reoccurs, it could be that the cache is being
+    deleted — for example, in an environment (such as a school computer lab)
+    where a system is returned into a default state when a user finishes using
+    the program. Some versions of Tux Paint ship with a file, "fonts.conf" (
+    documented at freedesktop.org), which can be modified to have FontConfig
+    store the file elsewhere, e.g.:
+
+        <cachedir>C:\Documents and Settings\All Users\Application Data\
+        fontconfig\cache</cachedir>
+
+
+
 I can't quit Tux Paint
 
     The "no quit" option is set. This disables the "Quit" button in Tux Paint's

docs/es_ES.UTF-8/html/FAQ.html

@@ -96,7 +96,7 @@
       </p>
 
       <p>
-        mayo 14, 2024      </p>
+        junio  4, 2024      </p>
     </center>
 
     <table border="2"
@@ -678,6 +678,23 @@
           To disable the lockfile, add the "<code>--nolockfile</code>" argument to Tux Paint's command-line, or "<code>nolockfile=yes</code>" to the configuration file.        </p>
       </dd>
 
+      <dt>
+        Tux Paint launches very slowly      </dt>
+
+      <dd>
+        <p>
+          The first time Tux Paint is launched (for a particular user), it may take a minute or more to respond. The font system used by Tux Paint (FontConfig, via Pango) is creating a 'cache' of information about the fonts on your system. Subsequent launches of Tux Paint should be fast.        </p>
+
+        <p>
+          While the font cache is generated behind the scenes, Tux Paint should remain interactive (showing an animated 'please wait' animation) as this process runs.        </p>
+
+        <p>
+          If this delay persists or reoccurs, it could be that the cache is being deleted &mdash; for example, in an environment  (such as a school computer lab) where a system is returned into a default state when a user finishes using the program. Some versions of Tux Paint ship with a file, <nobr>"<code style='background: #EEE;'>fonts.conf</code>"</nobr> (<a href="https://fontconfig.pages.freedesktop.org/fontconfig/fontconfig-user.html">documented at freedesktop.org</a>), which can be modified to have FontConfig store the file elsewhere, e.g.:          <blockquote>
+            <code>&lt;cachedir&gt;C:\Documents and Settings\All Users\Application Data\fontconfig\cache&lt;/cachedir&gt;</code>
+          </blockquote>
+        </p>
+      </dd>
+
       <dt>
         I can't quit Tux Paint      </dt>
 

docs/fr_FR.UTF-8/FAQ.txt

@@ -5,7 +5,7 @@
        Copyright © 2002-2024 by divers contributeurs; voir AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                 mai 14, 2024
+                                 juin 4, 2024
 
 +-----------------------------------+
 |        Table des matières         |
@@ -546,6 +546,29 @@ Tux Paint ne veut pas fonctionner
 
 
 
+Tux Paint launches very slowly
+
+    The first time Tux Paint is launched (for a particular user), it may take a
+    minute or more to respond. The font system used by Tux Paint (FontConfig,
+    via Pango) is creating a 'cache' of information about the fonts on your
+    system. Subsequent launches of Tux Paint should be fast.
+
+    While the font cache is generated behind the scenes, Tux Paint should
+    remain interactive (showing an animated 'please wait' animation) as this
+    process runs.
+
+    If this delay persists or reoccurs, it could be that the cache is being
+    deleted — for example, in an environment (such as a school computer lab)
+    where a system is returned into a default state when a user finishes using
+    the program. Some versions of Tux Paint ship with a file, "fonts.conf" (
+    documented at freedesktop.org), which can be modified to have FontConfig
+    store the file elsewhere, e.g.:
+
+        <cachedir>C:\Documents and Settings\All Users\Application Data\
+        fontconfig\cache</cachedir>
+
+
+
 Je ne peux pas quitter Tux Paint
 
     L'option "noquit" est activée. Cela désactive le bouton "Quitter" dans la

docs/fr_FR.UTF-8/html/FAQ.html

@@ -96,7 +96,7 @@
       </p>
 
       <p>
-        mai 14, 2024      </p>
+        juin  4, 2024      </p>
     </center>
 
     <table border="2"
@@ -679,6 +679,23 @@ cible "nosound". (c'est-à-dire, ne lancez pas "<code>make nosound</code>") Assu
           Pour désactiver le fichier de verrouillage, ajoutez l'argument "<code>--nolockfile</code>" à la ligne de commande de Tux Paint, ou "<code>nolockfile=yes</code>" au fichier de configuration.        </p>
       </dd>
 
+      <dt>
+        Tux Paint launches very slowly      </dt>
+
+      <dd>
+        <p>
+          The first time Tux Paint is launched (for a particular user), it may take a minute or more to respond. The font system used by Tux Paint (FontConfig, via Pango) is creating a 'cache' of information about the fonts on your system. Subsequent launches of Tux Paint should be fast.        </p>
+
+        <p>
+          While the font cache is generated behind the scenes, Tux Paint should remain interactive (showing an animated 'please wait' animation) as this process runs.        </p>
+
+        <p>
+          If this delay persists or reoccurs, it could be that the cache is being deleted &mdash; for example, in an environment  (such as a school computer lab) where a system is returned into a default state when a user finishes using the program. Some versions of Tux Paint ship with a file, <nobr>"<code style='background: #EEE;'>fonts.conf</code>"</nobr> (<a href="https://fontconfig.pages.freedesktop.org/fontconfig/fontconfig-user.html">documented at freedesktop.org</a>), which can be modified to have FontConfig store the file elsewhere, e.g.:          <blockquote>
+            <code>&lt;cachedir&gt;C:\Documents and Settings\All Users\Application Data\fontconfig\cache&lt;/cachedir&gt;</code>
+          </blockquote>
+        </p>
+      </dd>
+
       <dt>
         Je ne peux pas quitter Tux Paint      </dt>
 

docs/gl_ES.UTF-8/FAQ.txt

@@ -5,7 +5,7 @@
         Copyright © 2002-2024 by varios colaboradores; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                              14 de Maio de 2024
+                               4 de Xuño de 2024
 
 +--------------------------------------------+
 |                   Índice                   |
@@ -526,6 +526,29 @@ Tux Paint non funciona
 
 
 
+Tux Paint launches very slowly
+
+    The first time Tux Paint is launched (for a particular user), it may take a
+    minute or more to respond. The font system used by Tux Paint (FontConfig,
+    via Pango) is creating a 'cache' of information about the fonts on your
+    system. Subsequent launches of Tux Paint should be fast.
+
+    While the font cache is generated behind the scenes, Tux Paint should
+    remain interactive (showing an animated 'please wait' animation) as this
+    process runs.
+
+    If this delay persists or reoccurs, it could be that the cache is being
+    deleted — for example, in an environment (such as a school computer lab)
+    where a system is returned into a default state when a user finishes using
+    the program. Some versions of Tux Paint ship with a file, "fonts.conf" (
+    documented at freedesktop.org), which can be modified to have FontConfig
+    store the file elsewhere, e.g.:
+
+        <cachedir>C:\Documents and Settings\All Users\Application Data\
+        fontconfig\cache</cachedir>
+
+
+
 Non podo saír de Tux Paint
 
     Está estabelecida a opción «non saír». Isto desactiva o botón «Saír» na

docs/gl_ES.UTF-8/html/FAQ.html

@@ -96,7 +96,7 @@
       </p>
 
       <p>
-        14 de Maio de 2024      </p>
+         4 de Xuño de 2024      </p>
     </center>
 
     <table border="2"
@@ -678,6 +678,23 @@
           Para desactivar o ficheiro de bloqueo, engada o argumento «<code>--nolockfile</code>» á liña de ordes de Tux Paint ou «<code>nolockfile=yes</code>» ao ficheiro de configuración.        </p>
       </dd>
 
+      <dt>
+        Tux Paint launches very slowly      </dt>
+
+      <dd>
+        <p>
+          The first time Tux Paint is launched (for a particular user), it may take a minute or more to respond. The font system used by Tux Paint (FontConfig, via Pango) is creating a 'cache' of information about the fonts on your system. Subsequent launches of Tux Paint should be fast.        </p>
+
+        <p>
+          While the font cache is generated behind the scenes, Tux Paint should remain interactive (showing an animated 'please wait' animation) as this process runs.        </p>
+
+        <p>
+          If this delay persists or reoccurs, it could be that the cache is being deleted &mdash; for example, in an environment  (such as a school computer lab) where a system is returned into a default state when a user finishes using the program. Some versions of Tux Paint ship with a file, <nobr>"<code style='background: #EEE;'>fonts.conf</code>"</nobr> (<a href="https://fontconfig.pages.freedesktop.org/fontconfig/fontconfig-user.html">documented at freedesktop.org</a>), which can be modified to have FontConfig store the file elsewhere, e.g.:          <blockquote>
+            <code>&lt;cachedir&gt;C:\Documents and Settings\All Users\Application Data\fontconfig\cache&lt;/cachedir&gt;</code>
+          </blockquote>
+        </p>
+      </dd>
+
       <dt>
         Non podo saír de Tux Paint      </dt>
 

docs/is_IS.UTF-8/FAQ.txt

@@ -5,7 +5,7 @@
         Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                 maí 14, 2024
+                                 júní 4, 2024
 
 +------------------------------+
 |      Table of Contents       |
@@ -504,6 +504,29 @@ Tux Paint won't run
 
 
 
+Tux Paint launches very slowly
+
+    The first time Tux Paint is launched (for a particular user), it may take a
+    minute or more to respond. The font system used by Tux Paint (FontConfig,
+    via Pango) is creating a 'cache' of information about the fonts on your
+    system. Subsequent launches of Tux Paint should be fast.
+
+    While the font cache is generated behind the scenes, Tux Paint should
+    remain interactive (showing an animated 'please wait' animation) as this
+    process runs.
+
+    If this delay persists or reoccurs, it could be that the cache is being
+    deleted — for example, in an environment (such as a school computer lab)
+    where a system is returned into a default state when a user finishes using
+    the program. Some versions of Tux Paint ship with a file, "fonts.conf" (
+    documented at freedesktop.org), which can be modified to have FontConfig
+    store the file elsewhere, e.g.:
+
+        <cachedir>C:\Documents and Settings\All Users\Application Data\
+        fontconfig\cache</cachedir>
+
+
+
 I can't quit Tux Paint
 
     The "no quit" option is set. This disables the "Quit" button in Tux Paint's

docs/is_IS.UTF-8/html/FAQ.html

@@ -96,7 +96,7 @@
       </p>
 
       <p>
-        maí 14, 2024      </p>
+        júní  4, 2024      </p>
     </center>
 
     <table border="2"
@@ -678,6 +678,23 @@
           To disable the lockfile, add the "<code>--nolockfile</code>" argument to Tux Paint's command-line, or "<code>nolockfile=yes</code>" to the configuration file.        </p>
       </dd>
 
+      <dt>
+        Tux Paint launches very slowly      </dt>
+
+      <dd>
+        <p>
+          The first time Tux Paint is launched (for a particular user), it may take a minute or more to respond. The font system used by Tux Paint (FontConfig, via Pango) is creating a 'cache' of information about the fonts on your system. Subsequent launches of Tux Paint should be fast.        </p>
+
+        <p>
+          While the font cache is generated behind the scenes, Tux Paint should remain interactive (showing an animated 'please wait' animation) as this process runs.        </p>
+
+        <p>
+          If this delay persists or reoccurs, it could be that the cache is being deleted &mdash; for example, in an environment  (such as a school computer lab) where a system is returned into a default state when a user finishes using the program. Some versions of Tux Paint ship with a file, <nobr>"<code style='background: #EEE;'>fonts.conf</code>"</nobr> (<a href="https://fontconfig.pages.freedesktop.org/fontconfig/fontconfig-user.html">documented at freedesktop.org</a>), which can be modified to have FontConfig store the file elsewhere, e.g.:          <blockquote>
+            <code>&lt;cachedir&gt;C:\Documents and Settings\All Users\Application Data\fontconfig\cache&lt;/cachedir&gt;</code>
+          </blockquote>
+        </p>
+      </dd>
+
       <dt>
         I can't quit Tux Paint      </dt>
 

docs/ja_JP.UTF-8/FAQ.txt

@@ -5,7 +5,7 @@
        Copyright © 2002-2024 by various contributors; AUTHORS.txt 参照.
                              https://tuxpaint.org/
 
-                                 2024年5月14日
+                                 2024年6月 4日
 
 +------------------------------+
 |             目次             |
@@ -504,6 +504,29 @@ Tux Paint won't run
 
 
 
+Tux Paint launches very slowly
+
+    The first time Tux Paint is launched (for a particular user), it may take a
+    minute or more to respond. The font system used by Tux Paint (FontConfig,
+    via Pango) is creating a 'cache' of information about the fonts on your
+    system. Subsequent launches of Tux Paint should be fast.
+
+    While the font cache is generated behind the scenes, Tux Paint should
+    remain interactive (showing an animated 'please wait' animation) as this
+    process runs.
+
+    If this delay persists or reoccurs, it could be that the cache is being
+    deleted — for example, in an environment (such as a school computer lab)
+    where a system is returned into a default state when a user finishes using
+    the program. Some versions of Tux Paint ship with a file, "fonts.conf" (
+    documented at freedesktop.org), which can be modified to have FontConfig
+    store the file elsewhere, e.g.:
+
+        <cachedir>C:\Documents and Settings\All Users\Application Data\
+        fontconfig\cache</cachedir>
+
+
+
 I can't quit Tux Paint
 
     The "no quit" option is set. This disables the "Quit" button in Tux Paint's

docs/ja_JP.UTF-8/html/FAQ.html

@@ -96,7 +96,7 @@
       </p>
 
       <p>
-        2024年5月14日      </p>
+        2024年6月 4日      </p>
     </center>
 
     <table border="2"
@@ -678,6 +678,23 @@
           To disable the lockfile, add the "<code>--nolockfile</code>" argument to Tux Paint's command-line, or "<code>nolockfile=yes</code>" to the configuration file.        </p>
       </dd>
 
+      <dt>
+        Tux Paint launches very slowly      </dt>
+
+      <dd>
+        <p>
+          The first time Tux Paint is launched (for a particular user), it may take a minute or more to respond. The font system used by Tux Paint (FontConfig, via Pango) is creating a 'cache' of information about the fonts on your system. Subsequent launches of Tux Paint should be fast.        </p>
+
+        <p>
+          While the font cache is generated behind the scenes, Tux Paint should remain interactive (showing an animated 'please wait' animation) as this process runs.        </p>
+
+        <p>
+          If this delay persists or reoccurs, it could be that the cache is being deleted &mdash; for example, in an environment  (such as a school computer lab) where a system is returned into a default state when a user finishes using the program. Some versions of Tux Paint ship with a file, <nobr>"<code style='background: #EEE;'>fonts.conf</code>"</nobr> (<a href="https://fontconfig.pages.freedesktop.org/fontconfig/fontconfig-user.html">documented at freedesktop.org</a>), which can be modified to have FontConfig store the file elsewhere, e.g.:          <blockquote>
+            <code>&lt;cachedir&gt;C:\Documents and Settings\All Users\Application Data\fontconfig\cache&lt;/cachedir&gt;</code>
+          </blockquote>
+        </p>
+      </dd>
+
       <dt>
         I can't quit Tux Paint      </dt>
 

docs/sq_AL.UTF-8/FAQ.txt

@@ -5,7 +5,7 @@
  Të drejta kopjimi © 2002-2024 nga kontribues të ndryshëm; shihni AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                  14 maj 2024
+                                4 qershor 2024
 
 +-------------------------------------------+
 |             Pasqyrë e Lëndës              |
@@ -525,6 +525,29 @@ Tux Paint-i nuk xhiron
 
 
 
+Tux Paint launches very slowly
+
+    The first time Tux Paint is launched (for a particular user), it may take a
+    minute or more to respond. The font system used by Tux Paint (FontConfig,
+    via Pango) is creating a 'cache' of information about the fonts on your
+    system. Subsequent launches of Tux Paint should be fast.
+
+    While the font cache is generated behind the scenes, Tux Paint should
+    remain interactive (showing an animated 'please wait' animation) as this
+    process runs.
+
+    If this delay persists or reoccurs, it could be that the cache is being
+    deleted — for example, in an environment (such as a school computer lab)
+    where a system is returned into a default state when a user finishes using
+    the program. Some versions of Tux Paint ship with a file, "fonts.conf" (
+    documented at freedesktop.org), which can be modified to have FontConfig
+    store the file elsewhere, e.g.:
+
+        <cachedir>C:\Documents and Settings\All Users\Application Data\
+        fontconfig\cache</cachedir>
+
+
+
 S’mbyll dot Tux Paint-in
 
     The "no quit" option is set. This disables the "Quit" button in Tux Paint's

docs/sq_AL.UTF-8/html/FAQ.html

@@ -96,7 +96,7 @@
       </p>
 
       <p>
-        14 maj 2024      </p>
+         4 qershor 2024      </p>
     </center>
 
     <table border="2"
@@ -678,6 +678,23 @@
           To disable the lockfile, add the "<code>--nolockfile</code>" argument to Tux Paint's command-line, or "<code>nolockfile=yes</code>" to the configuration file.        </p>
       </dd>
 
+      <dt>
+        Tux Paint launches very slowly      </dt>
+
+      <dd>
+        <p>
+          The first time Tux Paint is launched (for a particular user), it may take a minute or more to respond. The font system used by Tux Paint (FontConfig, via Pango) is creating a 'cache' of information about the fonts on your system. Subsequent launches of Tux Paint should be fast.        </p>
+
+        <p>
+          While the font cache is generated behind the scenes, Tux Paint should remain interactive (showing an animated 'please wait' animation) as this process runs.        </p>
+
+        <p>
+          If this delay persists or reoccurs, it could be that the cache is being deleted &mdash; for example, in an environment  (such as a school computer lab) where a system is returned into a default state when a user finishes using the program. Some versions of Tux Paint ship with a file, <nobr>"<code style='background: #EEE;'>fonts.conf</code>"</nobr> (<a href="https://fontconfig.pages.freedesktop.org/fontconfig/fontconfig-user.html">documented at freedesktop.org</a>), which can be modified to have FontConfig store the file elsewhere, e.g.:          <blockquote>
+            <code>&lt;cachedir&gt;C:\Documents and Settings\All Users\Application Data\fontconfig\cache&lt;/cachedir&gt;</code>
+          </blockquote>
+        </p>
+      </dd>
+
       <dt>
         S’mbyll dot Tux Paint-in      </dt>