update-fonts-alias

Section: Maintenance Commands (8)
Updated: 10 November 1999
Index
Return to Main Contents

NAME

update-fonts-alias - compile fonts.alias files

SYNOPSIS

update-fonts-alias directory ...

DESCRIPTION

update-fonts-alias assembles a fonts.alias file in an X font directory using one or more alias files found in a subdirectory of /etc/X11/fonts/. It is typically invoked only from the post-installation and post-removal scripts of a package containing fonts (that provide aliases for their names) for the X Window System, but may be invoked at any time to reconstruct fonts.alias 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-alias will assemble /usr/lib/X11/fonts/directory/fonts.alias from the files found in /etc/X11/fonts/directory/package.alias.

This enables multiple packages to provide aliases for fonts in the same directory. No font package actually provides the fonts.alias file in the X font directory itself, so there is no danger of overwriting one package's aliases with those of another.

For instance, the two packages "xfonts-base" and "xfonts-cjk" may both install fonts into the directory /usr/lib/X11/fonts/misc. They each place their fonts.alias files in /etc/X11/fonts/misc/xfonts-base.alias and /etc/X11/fonts/misc/xfonts-cjk.alias (respectively). update-fonts-alias concatenates these two files (as well as any others that match /etc/X11/fonts/misc/*.alias) into /usr/lib/X11/fonts/misc/fonts.alias.

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

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

DIAGNOSTICS

update-fonts-alias 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-alias, please see /usr/share/doc/debian/bug-reporting.txt, the bug(1) command, or the reportbug(1) command.

AUTHOR

update-fonts-alias 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: 00:06:35 GMT, July 27, 2024