update-fonts-dir

Section: Maintenance Commands (8)
Updated: 16 Mar 2001
Index
Return to Main Contents

NAME

update-fonts-dir - compile fonts.dir files

SYNOPSIS

update-fonts-dir directory ...

DESCRIPTION

update-fonts-dir creates a fonts.dir file in an X font directory by invoking mkfontdir(1) with the appropriate arguments. It is typically invoked only from the post-installation and post-removal scripts of a package containing fonts for the X Window System, but may be invoked at any time to reconstruct fonts.dir files. For each directory, which is either an absolute path to an X font directory or (preferably) simply the last component of its path (such as "75dpi" or "misc"), update-fonts-dir will generate /usr/lib/X11/fonts/directory/fonts.dir from the fonts.scale and font files found within it.

This enables multiple packages to provide names for fonts in the same directory. No font package actually provides the fonts.dir file in the X font directory itself, so there is no danger of overwriting one package's font names with those of another; For instance, the two packages "xfonts-base" (real) and "xfonts-nifty" (hypothetical) may both install fonts into the directory /usr/lib/X11/fonts/misc, and update-fonts-dir will ensure that the fonts.dir file in that directory contains information about the font files provided by both packages.

The format for fonts.dir files is given in the mkfontdir(1) manual page.

An example of how to use update-fonts-dir in package maintainer scripts is provided in the Debian Policy Manual.

DIAGNOSTICS

update-fonts-dir exits with status 1 if its arguments are absent or invalid.

BUGS

See <http://bugs.debian.org/xbase-clients>. If you wish to report a bug in update-fonts-dir, please see /usr/share/doc/debian/bug-reporting.txt, the bug(1) command, or the reportbug(1) command.

AUTHOR

update-fonts-dir is written and copyrighted by Branden Robinson. It is licensed under the GNU GPL, version 2.

This document was created by man2html, using the manual pages.
Time: 12:58:35 GMT, April 19, 2024