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. +

    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. +

    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. +

    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. +

    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. +

    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. +

    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. +

    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. +