update-fonts-alias(s)                       update-fonts-alias(s)



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 mkfont-
       dir(r) manual page.

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

SEE ALSO
       mkfontdir(r)

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(g) com-
       mand, or the reportbug(g) command.

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



Debian GNU/Linux         10 November 1999   update-fonts-alias(s)