From 7f01203ffa5cba45f54cfb33ab61b31838e1aada Mon Sep 17 00:00:00 2001 From: Bill Kendrick Date: Sun, 8 Jun 2025 11:02:09 -0700 Subject: [PATCH] Sync EXTENDING re: FontConfig --- docs/en/EXTENDING.txt | 43 +++++++++++++++++++- docs/en/html/EXTENDING.html | 59 ++++++++++++++++++++++++++-- docs/es_ES.UTF-8/html/EXTENDING.html | 59 ++++++++++++++++++++++++++-- docs/fr_FR.UTF-8/html/EXTENDING.html | 59 ++++++++++++++++++++++++++-- docs/gl_ES.UTF-8/html/EXTENDING.html | 59 ++++++++++++++++++++++++++-- docs/is_IS.UTF-8/html/EXTENDING.html | 59 ++++++++++++++++++++++++++-- docs/ja_JP.UTF-8/html/EXTENDING.html | 59 ++++++++++++++++++++++++++-- docs/sq_AL.UTF-8/html/EXTENDING.html | 59 ++++++++++++++++++++++++++-- docs/sv_SE.UTF-8/html/EXTENDING.html | 59 ++++++++++++++++++++++++++-- 9 files changed, 489 insertions(+), 26 deletions(-) diff --git a/docs/en/EXTENDING.txt b/docs/en/EXTENDING.txt index c72ade182..f2fab1c12 100644 --- a/docs/en/EXTENDING.txt +++ b/docs/en/EXTENDING.txt @@ -620,7 +620,7 @@ option is set). The locations vary, depending on operating system. + B_USER_FONTS_DIRECTORY + B_USER_NONPACKAGED_FONTS_DIRECTORY - * Linux + * Linux/etc. + /usr/share/feh/fonts + /usr/share/fonts + /usr/X11R6/lib/X11/fonts @@ -633,7 +633,46 @@ option is set). The locations vary, depending on operating system. ### FontConfig ### -... +Tux Paint utilizes FontConfig to find additional system-wide and user-specific +fonts that the 'Text' and 'Label' tools might be able to use (unless the +"--nosysfonts" option is set). It does this by looking for FontConfig +configuration files ("fonts.conf") in various locations. + + * Windows + + The "etc/fonts/fonts.conf" file included with Tux Paint. + * macOS + + The path specified by the "FONTCONFIG_PATH" environment variable, if + set. + * Haiku + + /boot/system/settings/fonts/fonts.conf + * Linux/etc. + + The path specified by the "FONTCONFIG_PATH" environment variable, if + set. + + If the above fails, then "/etc/fonts/fonts.conf". + + The path specified by the "XDG_CONFIG_HOME" environment variable, if + set. There, it looks for the file "fontconfig/fonts.conf". + + If the above fails, then "$HOME/.config/fontconfig/fonts.conf". + +Each FontConfig configuration file ("fonts.conf") is examined for "" tags +that specify directory (folder) paths where fonts might be found, and Tux Paint +scans them and loads the fonts. If a "prefix" attribute is included in the tag, +Tux Paint prefixes the path accordingly. + +→ xdg ← + The directory path specified is considered to be relative to the user's + local data path, specified by the "XDG_DATA_HOME" environment variable. If + not set, then ".local/share" under the path specified by the "HOME" + environment variable will be used, if it exists. + +→ relative ← + The directory path specified is considered to be relative to the + configuration file itself. + +→ default, cwd, or no "prefix" attribute specified ← + The directory path specified is considered to be relative to the current + working directory (where Tux Paint is running), unless a root path is + included at the start (e.g., "/", "C:\\", etc.) + 'Starters' diff --git a/docs/en/html/EXTENDING.html b/docs/en/html/EXTENDING.html index 5cbe2ec44..5c38e7b4e 100644 --- a/docs/en/html/EXTENDING.html +++ b/docs/en/html/EXTENDING.html @@ -710,7 +710,7 @@
  • The location specified by the "Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key.
  • - If the above fails, then "C:\WINDOWS\FONTS".
    • + If the above fails, then "C:\WINDOWS\FONTS".
  • The location specified by the "Local AppData" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. The path "\Microsoft\Windows\Fonts" is appended to that location.
    • @@ -743,7 +743,7 @@

  • - Linux + Linux/etc.
    • /usr/share/feh/fonts
    • /usr/share/fonts
      • @@ -768,7 +768,60 @@ -

      ...

      +

      + + Tux Paint utilizes FontConfig to find additional system-wide and user-specific fonts that the 'Text' and 'Label' tools might be able to use (unless the "--nosysfonts" option is set). It does this by looking for FontConfig configuration files ("fonts.conf") in various locations.

      + +
        +
      • + Windows +
          +
        • + The "etc/fonts/fonts.conf" file included with Tux Paint.
          • +
        +
        • +
      • + macOS +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        +
        • +
      • + Haiku +
          +
        • /boot/system/settings/fonts/fonts.conf
          • +
        +
        • +
      • + Linux/etc. +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        • + If the above fails, then "/etc/fonts/fonts.conf".
          • +
        • + The path specified by the "XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf".
          • +
        • + If the above fails, then "$HOME/.config/fontconfig/fonts.conf".
          • +
        +
        • +
      + +

      + Each FontConfig configuration file ("fonts.conf") is examined for "<dir>" tags that specify directory (folder) paths where fonts might be found, and Tux Paint scans them and loads the fonts. If a "prefix" attribute is included in the tag, Tux Paint prefixes the path accordingly.

      +
      xdg
      +
      + The directory path specified is considered to be relative to the user's local data path, specified by the "XDG_DATA_HOME" environment variable. If not set, then ".local/share" under the path specified by the "HOME" environment variable will be used, if it exists.
      +
      relative
      +
      + The directory path specified is considered to be relative to the configuration file itself.
      +
      + default, cwd, or no "prefix" attribute specified
      +
      + The directory path specified is considered to be relative to the current working directory (where Tux Paint is running), unless a root path is included at the start (e.g., "/", "C:\\", etc.)
      +
    +

    diff --git a/docs/es_ES.UTF-8/html/EXTENDING.html b/docs/es_ES.UTF-8/html/EXTENDING.html index 066dc2648..da2b97f9d 100644 --- a/docs/es_ES.UTF-8/html/EXTENDING.html +++ b/docs/es_ES.UTF-8/html/EXTENDING.html @@ -710,7 +710,7 @@
  • The location specified by the "Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key.
  • - If the above fails, then "C:\WINDOWS\FONTS".
    • + If the above fails, then "C:\WINDOWS\FONTS".
  • The location specified by the "Local AppData" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. The path "\Microsoft\Windows\Fonts" is appended to that location.
    • @@ -743,7 +743,7 @@

  • - Linux + Linux/etc.
    • /usr/share/feh/fonts
    • /usr/share/fonts
      • @@ -768,7 +768,60 @@ -

      ...

      +

      + + Tux Paint utilizes FontConfig to find additional system-wide and user-specific fonts that the 'Text' and 'Label' tools might be able to use (unless the "--nosysfonts" option is set). It does this by looking for FontConfig configuration files ("fonts.conf") in various locations.

      + +
        +
      • + Windows +
          +
        • + The "etc/fonts/fonts.conf" file included with Tux Paint.
          • +
        +
        • +
      • + macOS +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        +
        • +
      • + Haiku +
          +
        • /boot/system/settings/fonts/fonts.conf
          • +
        +
        • +
      • + Linux/etc. +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        • + If the above fails, then "/etc/fonts/fonts.conf".
          • +
        • + The path specified by the "XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf".
          • +
        • + If the above fails, then "$HOME/.config/fontconfig/fonts.conf".
          • +
        +
        • +
      + +

      + Each FontConfig configuration file ("fonts.conf") is examined for "<dir>" tags that specify directory (folder) paths where fonts might be found, and Tux Paint scans them and loads the fonts. If a "prefix" attribute is included in the tag, Tux Paint prefixes the path accordingly.

      +
      xdg
      +
      + The directory path specified is considered to be relative to the user's local data path, specified by the "XDG_DATA_HOME" environment variable. If not set, then ".local/share" under the path specified by the "HOME" environment variable will be used, if it exists.
      +
      relative
      +
      + The directory path specified is considered to be relative to the configuration file itself.
      +
      + default, cwd, or no "prefix" attribute specified
      +
      + The directory path specified is considered to be relative to the current working directory (where Tux Paint is running), unless a root path is included at the start (e.g., "/", "C:\\", etc.)
      +
    +

    diff --git a/docs/fr_FR.UTF-8/html/EXTENDING.html b/docs/fr_FR.UTF-8/html/EXTENDING.html index b501e9553..af451f4a4 100644 --- a/docs/fr_FR.UTF-8/html/EXTENDING.html +++ b/docs/fr_FR.UTF-8/html/EXTENDING.html @@ -710,7 +710,7 @@
  • The location specified by the "Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key.
  • - If the above fails, then "C:\WINDOWS\FONTS".
    • + If the above fails, then "C:\WINDOWS\FONTS".
  • The location specified by the "Local AppData" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. The path "\Microsoft\Windows\Fonts" is appended to that location.
    • @@ -743,7 +743,7 @@

  • - Linux + Linux/etc.
    • /usr/share/feh/fonts
    • /usr/share/fonts
      • @@ -768,7 +768,60 @@ -

      ...

      +

      + + Tux Paint utilizes FontConfig to find additional system-wide and user-specific fonts that the 'Text' and 'Label' tools might be able to use (unless the "--nosysfonts" option is set). It does this by looking for FontConfig configuration files ("fonts.conf") in various locations.

      + +
        +
      • + Windows +
          +
        • + The "etc/fonts/fonts.conf" file included with Tux Paint.
          • +
        +
        • +
      • + macOS +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        +
        • +
      • + Haiku +
          +
        • /boot/system/settings/fonts/fonts.conf
          • +
        +
        • +
      • + Linux/etc. +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        • + If the above fails, then "/etc/fonts/fonts.conf".
          • +
        • + The path specified by the "XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf".
          • +
        • + If the above fails, then "$HOME/.config/fontconfig/fonts.conf".
          • +
        +
        • +
      + +

      + Each FontConfig configuration file ("fonts.conf") is examined for "<dir>" tags that specify directory (folder) paths where fonts might be found, and Tux Paint scans them and loads the fonts. If a "prefix" attribute is included in the tag, Tux Paint prefixes the path accordingly.

      +
      xdg
      +
      + The directory path specified is considered to be relative to the user's local data path, specified by the "XDG_DATA_HOME" environment variable. If not set, then ".local/share" under the path specified by the "HOME" environment variable will be used, if it exists.
      +
      relative
      +
      + The directory path specified is considered to be relative to the configuration file itself.
      +
      + default, cwd, or no "prefix" attribute specified
      +
      + The directory path specified is considered to be relative to the current working directory (where Tux Paint is running), unless a root path is included at the start (e.g., "/", "C:\\", etc.)
      +
    +

    diff --git a/docs/gl_ES.UTF-8/html/EXTENDING.html b/docs/gl_ES.UTF-8/html/EXTENDING.html index b1e5ab8d8..3499a3c94 100644 --- a/docs/gl_ES.UTF-8/html/EXTENDING.html +++ b/docs/gl_ES.UTF-8/html/EXTENDING.html @@ -710,7 +710,7 @@
  • The location specified by the "Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key.
  • - If the above fails, then "C:\WINDOWS\FONTS".
    • + If the above fails, then "C:\WINDOWS\FONTS".
  • The location specified by the "Local AppData" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. The path "\Microsoft\Windows\Fonts" is appended to that location.
    • @@ -743,7 +743,7 @@

  • - Linux + Linux/etc.
    • /usr/share/feh/fonts
    • /usr/share/fonts
      • @@ -768,7 +768,60 @@ -

      ...

      +

      + + Tux Paint utilizes FontConfig to find additional system-wide and user-specific fonts that the 'Text' and 'Label' tools might be able to use (unless the "--nosysfonts" option is set). It does this by looking for FontConfig configuration files ("fonts.conf") in various locations.

      + +
        +
      • + Windows +
          +
        • + The "etc/fonts/fonts.conf" file included with Tux Paint.
          • +
        +
        • +
      • + macOS +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        +
        • +
      • + Haiku +
          +
        • /boot/system/settings/fonts/fonts.conf
          • +
        +
        • +
      • + Linux/etc. +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        • + If the above fails, then "/etc/fonts/fonts.conf".
          • +
        • + The path specified by the "XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf".
          • +
        • + If the above fails, then "$HOME/.config/fontconfig/fonts.conf".
          • +
        +
        • +
      + +

      + Each FontConfig configuration file ("fonts.conf") is examined for "<dir>" tags that specify directory (folder) paths where fonts might be found, and Tux Paint scans them and loads the fonts. If a "prefix" attribute is included in the tag, Tux Paint prefixes the path accordingly.

      +
      xdg
      +
      + The directory path specified is considered to be relative to the user's local data path, specified by the "XDG_DATA_HOME" environment variable. If not set, then ".local/share" under the path specified by the "HOME" environment variable will be used, if it exists.
      +
      relative
      +
      + The directory path specified is considered to be relative to the configuration file itself.
      +
      + default, cwd, or no "prefix" attribute specified
      +
      + The directory path specified is considered to be relative to the current working directory (where Tux Paint is running), unless a root path is included at the start (e.g., "/", "C:\\", etc.)
      +
    +

    diff --git a/docs/is_IS.UTF-8/html/EXTENDING.html b/docs/is_IS.UTF-8/html/EXTENDING.html index 63d8d5b7e..819fcd4c8 100644 --- a/docs/is_IS.UTF-8/html/EXTENDING.html +++ b/docs/is_IS.UTF-8/html/EXTENDING.html @@ -710,7 +710,7 @@
  • The location specified by the "Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key.
  • - If the above fails, then "C:\WINDOWS\FONTS".
    • + If the above fails, then "C:\WINDOWS\FONTS".
  • The location specified by the "Local AppData" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. The path "\Microsoft\Windows\Fonts" is appended to that location.
    • @@ -743,7 +743,7 @@

  • - Linux + Linux/etc.
    • /usr/share/feh/fonts
    • /usr/share/fonts
      • @@ -768,7 +768,60 @@ -

      ...

      +

      + + Tux Paint utilizes FontConfig to find additional system-wide and user-specific fonts that the 'Text' and 'Label' tools might be able to use (unless the "--nosysfonts" option is set). It does this by looking for FontConfig configuration files ("fonts.conf") in various locations.

      + +
        +
      • + Windows +
          +
        • + The "etc/fonts/fonts.conf" file included with Tux Paint.
          • +
        +
        • +
      • + macOS +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        +
        • +
      • + Haiku +
          +
        • /boot/system/settings/fonts/fonts.conf
          • +
        +
        • +
      • + Linux/etc. +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        • + If the above fails, then "/etc/fonts/fonts.conf".
          • +
        • + The path specified by the "XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf".
          • +
        • + If the above fails, then "$HOME/.config/fontconfig/fonts.conf".
          • +
        +
        • +
      + +

      + Each FontConfig configuration file ("fonts.conf") is examined for "<dir>" tags that specify directory (folder) paths where fonts might be found, and Tux Paint scans them and loads the fonts. If a "prefix" attribute is included in the tag, Tux Paint prefixes the path accordingly.

      +
      xdg
      +
      + The directory path specified is considered to be relative to the user's local data path, specified by the "XDG_DATA_HOME" environment variable. If not set, then ".local/share" under the path specified by the "HOME" environment variable will be used, if it exists.
      +
      relative
      +
      + The directory path specified is considered to be relative to the configuration file itself.
      +
      + default, cwd, or no "prefix" attribute specified
      +
      + The directory path specified is considered to be relative to the current working directory (where Tux Paint is running), unless a root path is included at the start (e.g., "/", "C:\\", etc.)
      +
    +

    diff --git a/docs/ja_JP.UTF-8/html/EXTENDING.html b/docs/ja_JP.UTF-8/html/EXTENDING.html index 3efe0e7d9..19e140e0e 100644 --- a/docs/ja_JP.UTF-8/html/EXTENDING.html +++ b/docs/ja_JP.UTF-8/html/EXTENDING.html @@ -710,7 +710,7 @@
  • The location specified by the "Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key.
  • - If the above fails, then "C:\WINDOWS\FONTS".
    • + If the above fails, then "C:\WINDOWS\FONTS".
  • The location specified by the "Local AppData" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. The path "\Microsoft\Windows\Fonts" is appended to that location.
    • @@ -743,7 +743,7 @@

  • - Linux + Linux/etc.
    • /usr/share/feh/fonts
    • /usr/share/fonts
      • @@ -768,7 +768,60 @@ -

      ...

      +

      + + Tux Paint utilizes FontConfig to find additional system-wide and user-specific fonts that the 'Text' and 'Label' tools might be able to use (unless the "--nosysfonts" option is set). It does this by looking for FontConfig configuration files ("fonts.conf") in various locations.

      + +
        +
      • + Windows +
          +
        • + The "etc/fonts/fonts.conf" file included with Tux Paint.
          • +
        +
        • +
      • + macOS +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        +
        • +
      • + Haiku +
          +
        • /boot/system/settings/fonts/fonts.conf
          • +
        +
        • +
      • + Linux/etc. +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        • + If the above fails, then "/etc/fonts/fonts.conf".
          • +
        • + The path specified by the "XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf".
          • +
        • + If the above fails, then "$HOME/.config/fontconfig/fonts.conf".
          • +
        +
        • +
      + +

      + Each FontConfig configuration file ("fonts.conf") is examined for "<dir>" tags that specify directory (folder) paths where fonts might be found, and Tux Paint scans them and loads the fonts. If a "prefix" attribute is included in the tag, Tux Paint prefixes the path accordingly.

      +
      xdg
      +
      + The directory path specified is considered to be relative to the user's local data path, specified by the "XDG_DATA_HOME" environment variable. If not set, then ".local/share" under the path specified by the "HOME" environment variable will be used, if it exists.
      +
      relative
      +
      + The directory path specified is considered to be relative to the configuration file itself.
      +
      + default, cwd, or no "prefix" attribute specified
      +
      + The directory path specified is considered to be relative to the current working directory (where Tux Paint is running), unless a root path is included at the start (e.g., "/", "C:\\", etc.)
      +
    +

    diff --git a/docs/sq_AL.UTF-8/html/EXTENDING.html b/docs/sq_AL.UTF-8/html/EXTENDING.html index 1eaf83c4a..ea886abd7 100644 --- a/docs/sq_AL.UTF-8/html/EXTENDING.html +++ b/docs/sq_AL.UTF-8/html/EXTENDING.html @@ -710,7 +710,7 @@
  • The location specified by the "Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key.
  • - If the above fails, then "C:\WINDOWS\FONTS".
    • + If the above fails, then "C:\WINDOWS\FONTS".
  • The location specified by the "Local AppData" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. The path "\Microsoft\Windows\Fonts" is appended to that location.
    • @@ -743,7 +743,7 @@

  • - Linux + Linux/etc.
    • /usr/share/feh/fonts
    • /usr/share/fonts
      • @@ -768,7 +768,60 @@ -

      ...

      +

      + + Tux Paint utilizes FontConfig to find additional system-wide and user-specific fonts that the 'Text' and 'Label' tools might be able to use (unless the "--nosysfonts" option is set). It does this by looking for FontConfig configuration files ("fonts.conf") in various locations.

      + +
        +
      • + Windows +
          +
        • + The "etc/fonts/fonts.conf" file included with Tux Paint.
          • +
        +
        • +
      • + macOS +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        +
        • +
      • + Haiku +
          +
        • /boot/system/settings/fonts/fonts.conf
          • +
        +
        • +
      • + Linux/etc. +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        • + If the above fails, then "/etc/fonts/fonts.conf".
          • +
        • + The path specified by the "XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf".
          • +
        • + If the above fails, then "$HOME/.config/fontconfig/fonts.conf".
          • +
        +
        • +
      + +

      + Each FontConfig configuration file ("fonts.conf") is examined for "<dir>" tags that specify directory (folder) paths where fonts might be found, and Tux Paint scans them and loads the fonts. If a "prefix" attribute is included in the tag, Tux Paint prefixes the path accordingly.

      +
      xdg
      +
      + The directory path specified is considered to be relative to the user's local data path, specified by the "XDG_DATA_HOME" environment variable. If not set, then ".local/share" under the path specified by the "HOME" environment variable will be used, if it exists.
      +
      relative
      +
      + The directory path specified is considered to be relative to the configuration file itself.
      +
      + default, cwd, or no "prefix" attribute specified
      +
      + The directory path specified is considered to be relative to the current working directory (where Tux Paint is running), unless a root path is included at the start (e.g., "/", "C:\\", etc.)
      +
    +

    diff --git a/docs/sv_SE.UTF-8/html/EXTENDING.html b/docs/sv_SE.UTF-8/html/EXTENDING.html index 858671ac9..9aee13efc 100644 --- a/docs/sv_SE.UTF-8/html/EXTENDING.html +++ b/docs/sv_SE.UTF-8/html/EXTENDING.html @@ -710,7 +710,7 @@
  • The location specified by the "Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key.
  • - If the above fails, then "C:\WINDOWS\FONTS".
    • + If the above fails, then "C:\WINDOWS\FONTS".
  • The location specified by the "Local AppData" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. The path "\Microsoft\Windows\Fonts" is appended to that location.
    • @@ -743,7 +743,7 @@

  • - Linux + Linux/etc.
    • /usr/share/feh/fonts
    • /usr/share/fonts
      • @@ -768,7 +768,60 @@ -

      ...

      +

      + + Tux Paint utilizes FontConfig to find additional system-wide and user-specific fonts that the 'Text' and 'Label' tools might be able to use (unless the "--nosysfonts" option is set). It does this by looking for FontConfig configuration files ("fonts.conf") in various locations.

      + +
        +
      • + Windows +
          +
        • + The "etc/fonts/fonts.conf" file included with Tux Paint.
          • +
        +
        • +
      • + macOS +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        +
        • +
      • + Haiku +
          +
        • /boot/system/settings/fonts/fonts.conf
          • +
        +
        • +
      • + Linux/etc. +
          +
        • + The path specified by the "FONTCONFIG_PATH" environment variable, if set.
          • +
        • + If the above fails, then "/etc/fonts/fonts.conf".
          • +
        • + The path specified by the "XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf".
          • +
        • + If the above fails, then "$HOME/.config/fontconfig/fonts.conf".
          • +
        +
        • +
      + +

      + Each FontConfig configuration file ("fonts.conf") is examined for "<dir>" tags that specify directory (folder) paths where fonts might be found, and Tux Paint scans them and loads the fonts. If a "prefix" attribute is included in the tag, Tux Paint prefixes the path accordingly.

      +
      xdg
      +
      + The directory path specified is considered to be relative to the user's local data path, specified by the "XDG_DATA_HOME" environment variable. If not set, then ".local/share" under the path specified by the "HOME" environment variable will be used, if it exists.
      +
      relative
      +
      + The directory path specified is considered to be relative to the configuration file itself.
      +
      + default, cwd, or no "prefix" attribute specified
      +
      + The directory path specified is considered to be relative to the current working directory (where Tux Paint is running), unless a root path is included at the start (e.g., "/", "C:\\", etc.)
      +
    +