sourCEntral - mobile manpages

pdf

defoma

NAME

defoma − Debian Font Manager, a framework for automatic font configuration.

SYNOPSIS

defoma-font [options] command args..
defoma-app
[options] command args..
defoma-subst
[options] command args..

DESCRIPTION

Defoma stands for Debian Font Manager. It provides a framework for automatic font configuration. This manpage introduces general Defoma concepts, please refer the manpage of defoma-font, defoma-app, or defoma-subst for the detailed information of each command.

Fonts are used by numerous applications, but generally need to be configured separately for each application. Defoma solves this problem by calling configuration scripts to update the font configuration of applications whenever a font is installed or removed.

A Defoma-configuration script is a perl library that each application should install as application-name.defoma under /usr/share/defoma/scripts and which configures a font for that application. The following is an example of a script named foo.defoma.

@ACCEPT_CATEGORIES = qw(type1 truetype);

package foo;

sub type1 {
my $com = shift;
...
}

sub truetype {
my $com = shift;
...
}

1;

This example represents an application foo that wants to configure truetype and type1 category fonts. A function by the same name as the relevant category is called by Defoma with a command as the first argument, and then additional arguments depending on the command. The following is a list of commands.

* register
* unregister
* do-install-real do-install-alias do-install-subst
* do-remove-real do-remove-alias do-remove-subst
* init
* term
* purge

do-install-* and do-remove-* commands are only called from Id cache. init and term are called at the start and end (respectively) of the entire process.

Id cache is another feature of Defoma. A common problem during automatic configuration is name space conflicts. Usually applications access fonts through logical font names (like XLFDs and PostScript font names) rather than the fonts themselves (as font filenames). Logical font names, called identifiers in Defoma, can easily conflict especially when font aliases are permitted. Through the Id cache mechanism, only one font is actually installed for each identifier even if it is provided by several fonts.

Id Substitution is an additional feature of Id cache. It selects a font to provide an id specified by a rulefile. The rulefile describes rules giving required ids and their hints. A rule is used to have more similar-looking fonts with the same characters substitute for a required id. This feature can also be used for the purpose of grouping fonts into different categories.

A category represents a type of font. Generally fonts that belong to the same category are configured the same way.

Hints represent essential font information and typeface information about the font. They consist of some HintTypes and their values. They can be specified from the command line options of defoma-font, or through a hintfile.

Hintfile describes one or more fonts and their hints in a single file. It is supposed to be put under /etc/defoma/hints as a conffile, so that users can modify the hints.
Below is an example hintfile. defoma-hints is a tool to help generating hints as well as the hintfile, so you do not have to create one from scratch.

category type1
begin /usr/share/fonts/type1/foo.pfa
FontName = Helvetica
Charset = ISO8859-1
Family = Helvetica
Weight = Medium
Shape = Upright NoSerif
GeneralFamily = SansSerif
X-FontName = -urw-helvetica-medium-r-noraml--0-0-0-0-p-iso8859-1
end
begin /usr/share/fonts/type1/foob.pfa
FontName = Helvetica-Bold
Charset = ISO8859-1
Family = Helvetica
Weight = Bold
Shape = Upright NoSerif
GeneralFamily = SansSerif
X-FontName = -urw-helvetica-bold-r-noraml--0-0-0-0-p-iso8859-1
end

SEE ALSO

defoma-font(1). defoma-app(1). defoma-subst(1). defoma-hints(1). defoma-psfont-installer(1). defoma-reconfigure(1). Defoma::Font(3pm). Defoma::Id(3pm). Defoma::Subst(3pm). Defoma::Common(3pm). /usr/share/doc/defoma-doc/developers.html/index.html
/usr/share/doc/defoma-doc/defoma-script.html/index.html

pdf