bldfamily(1) — USER COMMANDS
NAME
bldfamily − build font family description
SYNOPSIS
bldfamily [ −d dirname ] [ −f n ] [ −v ]
DESCRIPTION
bldfamily scans the directory dirname for X11/NeWS font files (files with extensions .fb, .f3b, and .fm) and constructs a font family file for each group of font files with the same family name. bldfamily also creates a file named Families.list that contains a list of all the font families in the directory and writes to the standard output a record of all font family files created. If dirname is not specified, it defaults to the value of the environment variable $FONTDIR if defined, to ‘.’ otherwise. Each family file that is built is given the family name followed by the suffix .ff.
A font family is a set of font files that are grouped together to provide a single POSTSCRIPT font. In the POSTSCRIPT language, each font has a name, such as Times-Roman, and can be rendered in many different sizes. An X11/NeWS font file is an instance of a POSTSCRIPT font at a particular size. Font family files contain the information necessary for X11/NeWS to pick the right bitmap font.
bldfamily also parses Type 3 POSTSCRIPT font files provided they contain a line of the form "%%BeginResource: font <name of font>". Entries for these fonts are also written into Families.list.
The directory is also searched for the files Synonyms.list and Compat.list and, if they are present, bldfamily loads their contents into Families.list. These files provide aliases for commonly used font names.
OPTIONS
−d dirnameSpecifies the directory to scan and put the .ff file into.
−f nSets the maximum length of an output filename (excluding extension) to n. When writing X11/NeWS format files, X11/NeWS normally constructs the output filename from the name of the font and its scaling factors. Some systems cannot cope with long file names, so this option can be used to squeeze the name heuristically. The default value is 32.
−vTurns on verbose description of bldfamily operation. This option can be used to determine which X11/NeWS font files are included in each font family file.
EXAMPLE
example% bldfamily -d /usr/newfonts
In this example, bldfamily scans /usr/newfonts and builds a font family file called /usr/newfonts/Boston.ff.
DIAGNOSTICS
bldfamily generates the error message (Encoding: Unknown) with vfonts. The vfont format has no notion of encoding and this message may be ignored. bldfamily generates the warnings "sort: can’t open ./Synonyms.list" and "cat: ./Compat.list: No such file or directory" if these optional files do not exist.
SEE ALSO
TRADEMARK
POSTSCRIPT is a registered trademark of Adobe Systems Inc.
{:heading=>"bldfamily\|(\|1\|)\0\0\(em\0\0\∗(]D"} — Last change: 30 June 1991 — Last change: 30 June 1991