defoma-font

Section: User Commands (1)
Updated: March 4, 2001
Index
Return to Main Contents

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 informaiton 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

This document was created by man2html, using the manual pages.
Time: 03:13:36 GMT, April 18, 2024