Page 1

User Commands

Page 2

Introduction

This section introduces and describes user commands.

AUTHORS

Look at the header of the manual page for the author(s) and copyright conditions. Note that these can be different from page to page.

addftinfo reads a troff font file and adds some additional font-metric information that is used by the groff system. The font file with the information added is written on the standard output. The information added is guessed using some parametric information about the font and assumptions about the traditional troff names for characters. The main information added is the heights and depths of characters. The res and unitwidth arguments should be the same as the corresponding parameters in the DESC file; font is the name of the file describing the font; if font ends with I, the font will be assumed to be italic.

OPTIONS

Each of the f options changes one of the parameters that is used to derive the heights and depths. Like the existing quantities in the font file, each value is in inches/res for a font whose point size is unitwidth. param must be one of the following:

x-height	The height of lowercase letters without ascenders such as x
fig-height	The height of figures (digits)
asc-height	The height of characters with ascenders, such as b, d, or l
body-height	The height of characters such as parentheses
cap-height	The height of uppercase letters such as A
comma-depth	The depth of a comma
desc-depth	The depth of characters with descenders, such as p, q, or y
body-depth	The depth of characters such as parentheses

addftinfo makes no attempt to use the specified parameters to guess the unspecified parameters. If a parameter is not specified, the default will be used. The defaults are chosen to have the reasonable values for a Times font.

SEE ALSO

font(5) groff_font(5), groff(1), groff_char(7)

Groff Version 1.09, 6 August 1992

afmtodit

afmtodit—Create font files for use with groff _Tps

SYNOPSIS

afmtodit [ _ns ][_ddesc_file ][_eenc_file ][_in ][_an ] afm_file map_file font

Page 3

DESCRIPTION

afmtodit creates a font file for use with groff and grops. afmtodit is written in Perl; you must have Perl version 3 installed in order to run afmtodit. afm_file is the AFM (Adobe Font Metric) file for the font. map_file is a file that says which groff character names map onto each PostScript character name; this file should contain a sequence of lines of the form:

ps_char groff_char

where ps_char is the PostScript name of the character and groff_char is the groff name of the character (as used in the groff font file.) The same ps_char can occur multiple times in the file; each groff_char must occur, at most, once. font is the groff name of the font. If a PostScript character is in the encoding to be used for the font but is not mentioned in map_file, then afmtodit will put it in the groff font file as an unnamed character, which can be accessed by the \N escape sequence in troff. The groff_font file will be output to a file called font.

If there is a downloadable font file for the font, it may be listed in the file /usr/lib/groff/font/devps/download; see grops(1).

If the _i option is used, afmtodit will automatically 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)); these parameters may be specified for individual characters by adding to the afm_file lines of the form:

italicCorrectionps         charn
leftItalicCorrectionps         charn
subscriptCorrectionps         charn

where ps_char is the PostScript name of the character, and n is the desired value of the corresponding parameter in thousandths of an em. These parameters are normally needed only for italic (or oblique) fonts.

OPTIONS

_n	Don't output a ligatures command for this font. Use this with constant-width fonts.
_s	The font is special. The effect of this option is to add the special command to the font file.
_ddesc_file	The device description file is desc_file rather than the default DESC.
_eenc_file	The PostScript font should be reencoded to use the encoding described in enc_file. The format of enc_file is described in grops(1).
_an	Use n as the slant parameter in the font file; this is used by groff in the positioning of accents. By default, afmtodit uses the negative of the ItalicAngle specified in the afm_file; with true italic fonts, it is sometimes desirable to use a slant that is less than this. If you find that characters from an italic font have accents placed too far to the right over them, then use the _a option to give the font a smaller slant.
_in	Generate an italic correction for each character so that the character's width plus the character's italic correction is equal to n thousandths of an em plus the amount by which the right edge of the character's bounding is to the right of the character's origin. If this would result in a negative italic correction, use a zero italic correction instead.
	Also generate a subscript correction equal to the product of the tangent of the slant of the font and four-fifths of the x-height of the font. If this would result in a subscript correction greater than the italic correction, use a subscript correction equal to the italic correction instead.
	Also generate a left italic correction for each character equal to n thousandths of an em plus the amount by which the left edge of the character's bounding box is to the left of the character's origin. The left italic correction may be negative.
	This option is normally needed only with italic (or oblique) fonts. The font files distributed with groff were created using an option of _i50 for italic fonts.

FILES

/usr/lib/groff/font/devps/DESC	Device description file
/usr/lib/groff/font/devps/F	Font description file for font F
/usr/lib/groff/font/devps/download	List of downloadable fonts

Previous | Table of Contents | Next

Part I:

User Commands

Introduction

addftinfo

afmtodit