addftinfo.man revision 75584
1.ig \"-*- nroff -*- 2Copyright (C) 1989-2000 Free Software Foundation, Inc. 3 4Permission is granted to make and distribute verbatim copies of 5this manual provided the copyright notice and this permission notice 6are preserved on all copies. 7 8Permission is granted to copy and distribute modified versions of this 9manual under the conditions for verbatim copying, provided that the 10entire resulting derived work is distributed under the terms of a 11permission notice identical to this one. 12 13Permission is granted to copy and distribute translations of this 14manual into another language, under the above conditions for modified 15versions, except that this permission notice may be included in 16translations approved by the Free Software Foundation instead of in 17the original English. 18.. 19.TH ADDFTINFO @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" 20.SH NAME 21addftinfo \- add information to troff font files for use with groff 22.SH SYNOPSIS 23.B addftinfo 24[ 25.B \-v 26] 27[ 28.BI \- param\ value\fR.\|.\|. 29] 30.I res 31.I unitwidth 32.I font 33.SH DESCRIPTION 34.B addftinfo 35reads a troff font file 36and adds some additional font-metric information 37that is used by the groff system. 38The font file with the information added is written on the 39standard output. 40The information added is guessed using 41some parametric information about the font 42and assumptions 43about the traditional troff names for characters. 44The main information added is the heights and depths of characters. 45The 46.I res 47and 48.I unitwidth 49arguments should be the same as the corresponding parameters 50in the DESC file; 51.I font 52is the name of the file describing the font; 53if 54.I font 55ends with 56.B I 57the font will be assumed to be italic. 58.SH OPTIONS 59.B \-v 60prints the version number. 61.LP 62All other options changes one of the parameters that is used 63to derive the heights and depths. 64Like the existing quantities in the font 65file, each 66.I value 67is in 68.RI inches/ res 69for a font whose point size is 70.IR unitwidth . 71.I param 72must be one of: 73.TP 74.B x-height 75The height of lowercase letters without ascenders such as x. 76.TP 77.B fig-height 78The height of figures (digits). 79.TP 80.B asc-height 81The height of characters with ascenders, such as b, d or l. 82.TP 83.B body-height 84The height of characters such as parentheses. 85.TP 86.B cap-height 87The height of uppercase letters such as A. 88.TP 89.B comma-depth 90The depth of a comma. 91.TP 92.B desc-depth 93The depth of characters with descenders, such as p,q, or y. 94.TP 95.B body-depth 96The depth of characters such as parentheses. 97.LP 98.B addftinfo 99makes no attempt to use the specified parameters to guess 100the unspecified parameters. 101If a parameter is not specified the default will be used. 102The defaults are chosen to have the reasonable values for 103a Times font. 104.SH "SEE ALSO" 105.BR groff_font (@MAN5EXT@), 106.BR groff (@MAN1EXT@), 107.BR groff_char (@MAN7EXT@) 108