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 "
Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. C:\WINDOWS\FONTS".
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. /usr/share/feh/fonts/usr/share/fonts...
+
+
+ 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.
etc/fonts/fonts.conf" file included with Tux Paint. FONTCONFIG_PATH" environment variable, if set. /boot/system/settings/fonts/fonts.confFONTCONFIG_PATH" environment variable, if set. /etc/fonts/fonts.conf". XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf". $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.
xdgXDG_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. relativedefault, cwd, or no "prefix" attribute specified Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. C:\WINDOWS\FONTS".
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. /usr/share/feh/fonts/usr/share/fonts...
+
+
+ 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.
etc/fonts/fonts.conf" file included with Tux Paint. FONTCONFIG_PATH" environment variable, if set. /boot/system/settings/fonts/fonts.confFONTCONFIG_PATH" environment variable, if set. /etc/fonts/fonts.conf". XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf". $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.
xdgXDG_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. relativedefault, cwd, or no "prefix" attribute specified Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. C:\WINDOWS\FONTS".
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. /usr/share/feh/fonts/usr/share/fonts...
+
+
+ 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.
etc/fonts/fonts.conf" file included with Tux Paint. FONTCONFIG_PATH" environment variable, if set. /boot/system/settings/fonts/fonts.confFONTCONFIG_PATH" environment variable, if set. /etc/fonts/fonts.conf". XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf". $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.
xdgXDG_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. relativedefault, cwd, or no "prefix" attribute specified Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. C:\WINDOWS\FONTS".
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. /usr/share/feh/fonts/usr/share/fonts...
+
+
+ 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.
etc/fonts/fonts.conf" file included with Tux Paint. FONTCONFIG_PATH" environment variable, if set. /boot/system/settings/fonts/fonts.confFONTCONFIG_PATH" environment variable, if set. /etc/fonts/fonts.conf". XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf". $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.
xdgXDG_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. relativedefault, cwd, or no "prefix" attribute specified Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. C:\WINDOWS\FONTS".
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. /usr/share/feh/fonts/usr/share/fonts...
+
+
+ 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.
etc/fonts/fonts.conf" file included with Tux Paint. FONTCONFIG_PATH" environment variable, if set. /boot/system/settings/fonts/fonts.confFONTCONFIG_PATH" environment variable, if set. /etc/fonts/fonts.conf". XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf". $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.
xdgXDG_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. relativedefault, cwd, or no "prefix" attribute specified Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. C:\WINDOWS\FONTS".
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. /usr/share/feh/fonts/usr/share/fonts...
+
+
+ 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.
etc/fonts/fonts.conf" file included with Tux Paint. FONTCONFIG_PATH" environment variable, if set. /boot/system/settings/fonts/fonts.confFONTCONFIG_PATH" environment variable, if set. /etc/fonts/fonts.conf". XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf". $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.
xdgXDG_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. relativedefault, cwd, or no "prefix" attribute specified Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. C:\WINDOWS\FONTS".
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. /usr/share/feh/fonts/usr/share/fonts...
+
+
+ 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.
etc/fonts/fonts.conf" file included with Tux Paint. FONTCONFIG_PATH" environment variable, if set. /boot/system/settings/fonts/fonts.confFONTCONFIG_PATH" environment variable, if set. /etc/fonts/fonts.conf". XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf". $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.
xdgXDG_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. relativedefault, cwd, or no "prefix" attribute specified Fonts" option of the "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" Windows Registry key. C:\WINDOWS\FONTS".
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. /usr/share/feh/fonts/usr/share/fonts...
+
+
+ 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.
etc/fonts/fonts.conf" file included with Tux Paint. FONTCONFIG_PATH" environment variable, if set. /boot/system/settings/fonts/fonts.confFONTCONFIG_PATH" environment variable, if set. /etc/fonts/fonts.conf". XDG_CONFIG_HOME" environment variable, if set. There, it looks for the file "fontconfig/fonts.conf". $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.
xdgXDG_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. relativedefault, cwd, or no "prefix" attribute specified