.\" @(#) bldfamily.1 9.7 88/01/19
.TH BLDFAMILY 1 "2 December 1987"
.IX font bldfamily#(1) "" \fLbldfamily\fP(1)
.IX bldfamily#(1) "" "\fLbldfamily\fP(1) \(em build font family description"
.SH NAME
bldfamily \- build font family description
.SH SYNOPSIS
.B bldfamily
[
.BI \-d dirname
] 
[
.BI \-o outname
]
[
.B \-v
] 
.I names
.SH DESCRIPTION
.LP
.I bldfamily
scans a sets of NeWS font files and produces a NeWS font family file.
A font family is a set of font files that are grouped together to provide a
single \*(Ps font.  In the \*(Ps, a font has a name, like Times-Roman,
and can be rendered in many different sizes.  A NeWS font file is an
instance of a \*(Ps font at a particular size.  Font family files
contain the information necessary for NeWS to pick the right bitmap font.
.LP
.I bldfamily
scans directory
.I dirname
for files with extension ".fb" or ".fm"
and where the leading non-digit characters of the filename
match one of the
.I names .
The family file that is built will be written to
.IB dirname / outname .ff.
.LP
If \fIoutname\fR isn't specified, it defaults to the first of the
.I names .
If \fIdirname\fR isn't specified,
it defaults to "$FONDIR" if defined, "." otherwise.
If \fInames\fP isn't specified
\fIbldfamily\fP 
scans \fIdirname\fP for all font files and builds
all the possible family files.
.SH OPTIONS
.IP "\fB\-d\fIdirname\fR" 1i
Specifies the directory to scan and put the \fB.ffam\fP file into.
.IP "\fB\-o\fIoutname\fR" 1i
Specifies the output font name
.IP "\fB\-v\fR" 1i
Verbose \- gives a more detailed description of what is going on.
.SH EXAMPLE
.RS
.nf
paper% \fBdumpfont -d /usr/newfonts -n Boston boston*.vfont\fP
paper% \fBbldfamily -d/usr/newfonts Boston\fP
.RE
.fi
.LP
The first command calls \fIdumpfont\fP
and converts all the vfont files whose
names match "boston*.vfont" into NeWS format.
It puts them into \fI/usr/newfonts\fP
and changes their font name to Boston (it would have defaulted to boston).
The second command calls \fIbldfamily\fP
and scans \fI/usr/newfonts\fP
for "Boston*.fb" and builds a font family file for them, which will be
called \fI/usr/newfonts/Boston.ff\fP.
.SH "SEE ALSO"
dumpfont(1)
.SH DIAGNOSTICS
.TP 15n
\fIfilename\fP isn't a font file
.I bldfamily
has found a file that matches
one of the names and has an appropriate extension,
but it isn't a valid font
file.  You should probably ignore this message.
.\" XXX .SH BUGS
.\" XXX .LP
.\" XXX The options and directory defaulting should be consistent with
.\" XXX .I dumpfont .
.\" XXX .I bldfont
.\" XXX is clumsy to invoke.
.SH TRADEMARK
\*(Px is a registered trademark of Adobe Systems Inc.