NAME
defoma-font - register/unregister font(s) to Debian Font Manager
SYNOPSIS
defoma-font [options] register category font hints...
defoma-font [options] unregister category font
defoma-font [options] reregister category font hints...
defoma-font [options] purge category font
defoma-font [options] register-all hintfile
defoma-font [options] unregister-all hintfile
defoma-font [options] reregister-all hintfile
defoma-font [options] purge-all hintfile
DESCRIPTION
defoma-font is a tool to register or unregister font(s) to Defoma,
Debian Font Manager. Defoma then calls Defoma-configuration-scripts
provided by applications to make the font(s) configured for the
applications which can make use of them. It is supposed to be called
from postinst and prerm scripts, but may be called from console for
not-packaged addon fonts.
There are two methods of registering/unregistering font(s): by
specifying one font with its hints, or through a hintfile , which
describes several fonts with their hints. Font packages may possibly
use the latter method, installing a hintfile under /etc/defoma/hints as
conffile. The latter method has ’-all’ added in the commands.
category specifies the category of a font like type1, truetype and so
on. font specifies the font itself and is either a full path to the
font, or a logical font name. hints specify the hints of the font,
which contain essential information of the font like FontName, Charset
and Encoding, appearance information of the font representing its face
like Weight, Shape, GeneralFamily and Width, and additional information
of the font like Alias and Priority.
COMMANDS
register
Register the specified font with the specified hints into the
specified category unless the font is already registered.
unregister
Unregister the specified font which must be already registered
in the specified category. If the font is marked as use or
exclude in an Id cache of a certain application, the marks are
left intact.
reregister
If the specified font is already registered, the registered
hints and the specified hints are compared. If these hints
differs, the font first gets unregistered and then newly
registered with the specified new hints. If the font is not
registered, following process is the same as register command.
purge This command is almost the same as unregister command, except
that this command removes the marks in an Id cache.
register-all
unregister-all
reregister-all
purge-all
These commands operate all the fonts written in the specified
hintfile.
OPTIONS
-t Exit with true value (0) even if error occurs.
-v Verbose output.
-d More verbose output.
-q Quiet output.
EXAMPLES
defoma-font -vt register type1 /usr/share/fonts/type1/foo.pfa \
--FontName Helvetica --Charset ISO8859-1 --Weight Medium \
--Shape Upright NoSerif --GeneralFamily SansSerif
defoma-font reregister-all /etc/defoma/hints/microsoft.hints
SEE ALSO
defoma(1).
March 4, 2001 defoma-font(1)