'\"macro stdmacro
.if n .pH g1.bldfamily @(#)bldfamily	40.3 of 12/29/89
.ig
Revised: D. Bodnar 9/7/89
format -dqm4 -man6 -rs1 bldfamily.1
..
.\" @(#) bldfamily.1 9.13 89/01/21
.ds Ps P\s-2OST\s+2S\s-2CRIPT\s+2
.ds Sd \s-2Ne\h'-0.2n'WS\s+2
.ds Xn X11/Ne\h'-0.2n'WS
.nr X
.if \nX=0 .ds x} BLDFAMILY 1 "14 June 1989" "\&"
.if \nX=1 .ds x} BLDFAMILY 1 "14 June 1989"
.if \nX=2 .ds x} BLDFAMILY 1 "" "\&"
.if \nX=3 .ds x} BLDFAMILY "" "" "\&"
.TH \*(x}
.IX fonts bldfamily#(1) "" \fLbldfamily\fP(1)
.IX bldfamily#(1) "" "\fLbldfamily\fP(1) 
.SH NAME
bldfamily \- build font family description
.SH SYNOPSIS
.B bldfamily
[
.B \-d 
.I dirname
] 
[
.B \-f
.I n
]
.SH DESCRIPTION
.LP
.B bldfamily
scans \fIdirname\fR for \*(Sd font files
(files with extensions 
.B .fb 
and 
.B .fm\fR)
and constructs a \*(Sd font family file for each group of
font files with the same family name.
\fBbldfamily\fR also creates a file named \fBFamilies.list\fR
that contains
a list of all the font families in the directory.
If \fIdirname\fR is not specified,
it defaults to 
.B $FONTDIR
if defined, to `.' otherwise.
Each family file that is built
is given the family name followed by the suffix
.B .ff .
.LP
A font family is a set of font files that are grouped together to provide a
single \*(Ps font.
In the \*(Ps language, each font has a name, such as
.BR Times-Roman ,
and can be rendered in many different sizes.  A \*(Sd font file is an
instance of a \*(Ps font at a particular size.  Font family files
contain the information necessary for \*(Sd to pick the right bitmap font.
.SH OPTIONS
.IP "\fB\-d \fIdirname\fR" 0.89i
Specifies the directory to scan and put the \fB.ff\fP file into.
.IP "\f3\-f \fIn\fR" 0.89i
Sets the maximum length of an output filename (excluding extension) to
.I n .
When writing 
\*(Sd format files, 
\*(Sd 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 8.
.SH EXAMPLE
.RS
.nf 
\fBexample% bldfamily -d /usr/newfonts\fP
.RE
.fi
.LP
In this example, \fBbldfamily\fP scans \fB/usr/newfonts\fP
and builds a font family file called \fB/usr/newfonts/Boston.ff\fP.
.SH "SEE ALSO"
\fBconvertfont\fP(1)
.SH TRADEMARK
\*(Ps is a registered trademark of Adobe Systems Inc.
