.\" @(#)dumpfont.1 9.4 88/01/19 SMI; 
.TH DUMPFONT 1 "28 February 1987"
.IX font dumpfont#(1) "" \fLdumpfont\fP(1)
.IX dumpfont#(1) "" "\fLdumpfont\fP(1) \(em dump font in another format"
.SH NAME
dumpfont \- dump font out in some other format
.SH SYNOPSIS
.B dumpfont
[
.BR \-a | \-b | \-v | \-vf
] 
[
.B \-c
.I comment
] 
[
.B \-d
.I dirname
]
[
.B \-f
.I n
]
[
.B \-n
.I fontname
]
[
.B \-S
]
[
.B \-s
.I n
]
[
.B \-t
] 
[
.B \-tv
] 
[
.B \-ta
] 
.I filenames
.SH DESCRIPTION
.LP
.I dumpfont
reads in the set of named font files and dumps them out again according to
the specified options, effectively converting the files from one font
format to another.
.I dumpfont
is typically used to generate fonts for use with the NeWS window system.
.LP
There are five types of font files that
.I dumpfont
can read:
Sun standard vfont format,
Adobe ASCII bitmap format,
Adobe ASCII metric format,
NeWS font format,
and CMU (Andrew) format.
The format of the input font is determined automatically
by inspecting the file.
It can write fonts out in one of three formats:
Adobe ASCII, NeWS, and vfont.  The default output format is NeWS.
.SH OPTIONS
.IP "\fB\-a\fR" 1i
Selects Adobe ASCII output format.  This is the format that you should use
when transporting fonts from one machine architecture to another.  The
output file extension will be ".afont".

.IP "\fB\-b\fR" 1i
Selects NeWS output format (the default).  The output file extension will be
".font".  If the input file is an Adobe ASCII metrics file, the extension
will be ".metrics".

.IP "\fB\-v\fR" 1i
Selects vfont output format.  The output file extension will be ".vfont".

.IP "\fB\-vf\fR" 1i
Selects vfont output format.  The output file extension will be ".vfont".
Forces the characters to be fixed width.


.IP "\fB\-c \fIcomment\fR" 1i
Sets the
.I comment
field of the font.  The Adobe ASCII and NeWS font formats support an
internal comment that accompanies the font.  This is usually used to contain
copyright or history information.  It is normally propagated automatically.

.IP "\fB\-d \fIdirname\fR" 1i
Specifies the directory into which the font files will be written.  If the
FONTDIR environment variable is set, it is used as the default value.
Otherwise, if the NEWSHOME environment variable is set,
\fI$NEWSHOME/fonts\fP is used as the default value.
Otherwise "." is used.

.IP "\fB\-f \fIn\fR" 1i
Sets the maximum length of an output filename (excluding extension) to
.I n .
When writing NeWS format files, 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 heuristically squeeze
the name.

.IP "\fB\-n\fI name\fR" 1i
Forces the output font name to be
.I name .
It is important to not confuse the name of the font with the name of the file
that contains it.  Some font formats (Adobe ASCII and NeWS) contain the name
of the font internally.  So given a 10-point Times-Roman font,
its font name will be "Times-Roman",
but its file name might be \fITimRom10.font\fP.

.IP "\fB\-S\fR" 1i
Attempts to determine the size information of fonts by inspecting the
bitmaps and applying some heuristics.  This is useful when reading vfonts
(particularly those intended for printers like the Versatec) that are
missing or have incorrect size information.

.IP "\fB\-s \fIn\fR" 1i
Sets the point size of the font to
.I n .
Overrides any internal size specification

.IP "\fB\-t\fR" 1i
Prints a short description of the fonts on standard output; a reformatted
font file is not dumped.

.IP "\fB\-tv\fR" 1i
Prints a move verbose description of the fonts on standard output; a
reformatted font file is not dumped.

.IP "\fB\-ta\fR" 1i
Prints a long description of the fonts on standard output; a reformatted
font file is not dumped.  You'll get every scrap of information.
.SH "SEE ALSO"
bldfamily(1), vfont(5)

.SH DIAGNOSTICS
.TP 20n
Bad flag: -C
Unknown command like option
.TP 20n
Couldn't write ...
Error writing font file
.TP 20n
\fIf\fR: not a valid font.
Unknown input file format.
.SH BUGS
.LP
Should have been named
.I convertfont .