ENVVARS docs update (re: FontConfig vars)

This commit is contained in:
Bill Kendrick 2025-06-08 09:55:36 -07:00
parent cab4394173
commit 46fb261e84
16 changed files with 495 additions and 31 deletions

View file

@ -1,11 +1,11 @@
Tux Paint
versión 0.9.35
versión 0.9.36
Documentación de variábeis de contorno
Copyright © 2021-2025 by varios colaboradores; see AUTHORS.txt.
https://tuxpaint.org/
2 de Maio de 2025
8 de Xuño de 2025
-------------------------------------------------------------------------------
@ -42,6 +42,8 @@ indirectamente polas bibliotecas que emprega.
"$HOME/.config/". If the configuration cannot be found, Tux Paint simply
exports drawings and GIFs to "$HOME".
Tux Paint also uses this to find FontConfig configuration files; see below.
→ XDG_DATA_HOME ←
@ -83,6 +85,7 @@ A seguir amósanse algunhas das variábeis de contorno compatíbeis con Simple
DirectMedia Layer (libSDL) — que Tux Paint utiliza para amosar gráficos,
reproducir sons e recibir entrada do rato, teclado e joystick — e que poden ser
útiles para os usuarios de Tux Paint.
→ SDL_VIDEO_ALLOW_SCREENSAVER ←
Especifica se Tux Paint debería permitir a execución dun protector de
@ -102,3 +105,26 @@ reproducir sons e recibir entrada do rato, teclado e joystick — e que poden se
### Font-related environment variables ###
Tux Paint uses FontConfig (via Pango, in turn via SDL_Pango) to find fonts that
may be used by the "Text" and "Label" tools.
→ FONTCONFIG_PATH ←
Specifies where FontConfig should look for a "fonts.conf" configuration
file which Tux Paint examines for any "<dir>" tags, which it then uses to
search for fonts that could be used by the tools.
# Note: On Apple macOS, this is forced to be the "Resources/etc" folder,
inside the Tux Paint application itself.
# Note: On Apple iOS, this is forced to be the "etc" folder, inside the
Tux Paint application itself.
→ XDG_CONFIG_HOME ←
On Linux and other platforms where the X Desktop Group standards are used,
the location of the user's configuration files. It is used to find a
user-specific "fonts.conf" configuration file.

View file

@ -96,7 +96,7 @@
</p>
<p>
2 de Maio de 2025 </p>
8 de Xuño de 2025 </p>
</center>
<hr>
@ -132,6 +132,9 @@
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. Specifically, where to find "<code>user-dirs.dirs</code>", where the "<code>XDG_PICTURES_DIR</code>" might be defined. It is used for exporting drawings and animated GIFs. Generally it's set to something like "<code>$HOME/Pictures/</code>". If not specified, Tux Paint checks in the directory "<code>$HOME/.config/</code>". If the configuration cannot be found, Tux Paint simply exports drawings and GIFs to "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
@ -180,7 +183,8 @@
Variábeisbles de contorno relacionadas co que se amosa </h2>
<p>
A seguir amósanse algunhas das variábeis de contorno compatíbeis con Simple DirectMedia Layer (libSDL) &mdash; que Tux Paint utiliza para amosar gráficos, reproducir sons e recibir entrada do rato, teclado e joystick &mdash; e que poden ser útiles para os usuarios de Tux Paint.
A seguir amósanse algunhas das variábeis de contorno compatíbeis con Simple DirectMedia Layer (libSDL) &mdash; que Tux Paint utiliza para amosar gráficos, reproducir sons e recibir entrada do rato, teclado e joystick &mdash; e que poden ser útiles para os usuarios de Tux Paint. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
@ -199,6 +203,34 @@
</dl>
<h2>
Font-related environment variables </h2>
<p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
</body>
</html>