Package: fontconfig-config Version: 2.8.0-2.1 I noticed that the package fontconfig-config creates the directory /usr/local/share/fonts (in postinst) but none of the documentation in /usr/share/doc or the manual pages mention it.
A friend told me that this caused confusion on an IRC channel where someone asked how to install non-packaged fonts locally in Debian and was told to create a new directory in /usr/local. (So it appears that there is an actual need for this bit of documentation.) After grepping /etc/fonts, I found that /etc/fonts/fonts.conf specifies the directories /usr/local/share/fonts and ~/.fonts in addition to system directories. These are not mentioned in the manual page fonts-conf(5) (I guess because they are potentially distribution-specific). Would it be possible to document the paths somewhere in the package, for example in a README.Debian or one of the manual pages? For instance, something along the lines of: Installing non-packaged fonts in Debian --------------------------------------- The Debian packaging specifies (in /etc/fonts/fonts.conf) two directories for locally installed fonts: /usr/local/share/fonts and ~/.fonts in a user's home directory. To locally install fonts that have not been packaged in Debian, simply copy them to either of these directories: /usr/local/share/fonts to make them available to all users or ~/.xfonts for a single user. They should be available automatically; if not, you can try running the program fc-cache to refresh the font cache. (Please feel free to use and modify any of the preceding text if you want.) GNOME seems to have some brief documentation available in the Web in the "GNOME Desktop System Administration Guide" (I do not know if this has been packaged for Debian). There, http://library.gnome.org/admin/system-admin-guide/stable/fontconfig-3.html.en ("To Add a Font for an Individual User") seems correct for Debian, but http://library.gnome.org/admin/system-admin-guide/stable/fontconfig-2.html.en ("To Add a Font for All Users") does not mention /usr/local/share/fonts, presumably because it tries to be distribution-independent. (And of course a non-GNOME user would have a hard time finding this documentation, while ~/.fonts of course also affects KDE and, e.g., xterm's -fa option and Emacs's fontconfig support.) -- -=- Rjs -=- r...@cs.hut.fi, riku.saikko...@hut.fi -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
