update-fonts-dir(r)                           update-fonts-dir(r)



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(r)  with  the  appropriate
       arguments.   It  is  typically invoked only from the post-
       installation and post-removal scripts of  a  package  con-
       taining  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 infor-
       mation about the font files provided by both packages.

       The format for fonts.dir files is  given  in  the  mkfont-
       dir(r) manual page.

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

SEE ALSO
       mkfontdir(r)

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

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



Debian GNU/Linux           16 Mar 2001        update-fonts-dir(r)