defoma-font(1) - phpMan

defoma-font(1) defoma-font(1)

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 Font-
Name, 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.

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