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

@ -5,7 +5,7 @@
Copyright © 2021-2025 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
May 2, 2025
June 8, 2025
-------------------------------------------------------------------------------
@ -41,6 +41,8 @@ indirectly by the libraries that it utilizes.
"$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 ←
@ -81,6 +83,7 @@ The following are a few of the environment variables supported by Simple
DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics,
playing sounds, and receiving mouse, keyboard, and joystick input — and which
may be useful to users of Tux Paint.
→ SDL_VIDEO_ALLOW_SCREENSAVER ←
Specifies whether Tux Paint should allow a screensaver to run. Can be set
@ -99,3 +102,26 @@ may be useful to users of Tux Paint.
### 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.