hpftodit creates a font file for use with a Hewlett-Packard LaserJet~4–series (or newer) printer with
groff -Tlj4, using data from an HP tagged font metric (TFM) file.
tfm_file is the name of the TFM file for the font; Intellifont and TrueType TFM files are supported, but symbol set TFM files are not.
map_file is a file giving the groff names for characters in the font; this file should consist of a sequence of lines of the form:
where m is a decimal integer giving the MSL number of the character, u is a hexadecimal integer giving the Unicode value of the character, and c1, c2, ... are the groff names of the character. The values can be separated by any whitespace; the Unicode value must use uppercase digits A–F, and must be without a leading or Unicode values corresponding to composite glyphs are decomposed; e.g., becomes The name for a glyph without a groff name may be given as if the glyph corresponds to a Unicode value, or as an unnamed glyph If the given Unicode value is in the Private Use Area (0xE000–0xF8FF), the glyph is included as an unnamed glyph. Refer to groff_diff(1) for additional information about unnamed glyphs and how to access them.
Blank lines and lines beginning with are ignored. A following one or more groff names begins a comment. Because is a valid groff name, it must appear first in a list of groff names if a comment is included, e.g.,
or
rather than
which will treat the first as the beginning of the comment.
font is the name of the groff font file. The groff font file is written to font; if font is specified as the output is written to the standard output.
The -s option should be given if the font is special (a font is special if troff should search it whenever a character is not found in the current font). If the font is special, it should be listed in the fonts command in the DESC file; if it is not special, there is no need to list it, since troff can automatically mount it when it's first used.
If the -i option is used, hpftodit automatically will generate an italic correction, a left italic correction and a subscript correction for each character (the significance of these parameters is explained in groff_font(5)).