diff options
Diffstat (limited to 'Mk/Uses')
| -rw-r--r-- | Mk/Uses/fonts.mk | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/Mk/Uses/fonts.mk b/Mk/Uses/fonts.mk index 6397d69192ac..5a67448b4b1b 100644 --- a/Mk/Uses/fonts.mk +++ b/Mk/Uses/fonts.mk @@ -10,6 +10,35 @@ # fcfontsdir Add @fcfontsdir ${FONTSDIR} to PLIST_FILES # none No special handling of ${FONTSDIR} in PLIST_FILES +# Ports should use USES=fonts with an argument only when necessary. +# By default, @fcfontsdir ${FONTSDIR} is added and it updates font +# information cache file of fontconfig library, and XLFD entries +# in fonts.dir and fonts.scale file, which are directly used by +# X server and xfs font server. +# +# Xorg supports TrueType and OpenType via either of the two font +# subsystems. @fcfontsdir is designed to update configuration files for +# both of them to register a font file. Specifically, fc-cache and +# mkfontdir utilities are used, respectively. +# +# Ports to install fonts with which mkfontdir or fc-cache do not work well +# should use :fc and/or :fontsdir argument. fc-cache and mkfontdir +# get information such as fontname, encoding, etc. from a font file. +# However, mkfontdir does not understand information in some scalable +# fonts. Typical examples are TrueType Collection format and +# CJK (Chinese, Japanese, and Korean) TrueType font. The former is +# a format which contains multiple fonts in a single file. +# While Xorg supports it, mkfontdir does not generate correct +# fonts.dir entries from a TTC font. CJK fonts often require +# modifiers in a XFLD entry to enable special feature which mkfontdir +# does not support, either. +# +# Note that ports which do not want mkfontdir need to use +# a separate FONTSDIR, not shared ones such as misc or TTF. +# This is because other ports using @fcfontsdir or @fontsdir +# update fonts.dir in these font directories upon installation +# and deinstallation. mkfontdir will overwrite manually-added entries. + .if !defined(_INCLUDE_USES_FONTS_MK) _INCLUDE_USES_FONTS_MK= yes |