/contrib/groff/src/utils/tfmtodit/tfmtodit.man

https://bitbucket.org/freebsd/freebsd-head/ · Unknown · 197 lines · 194 code · 3 blank · 0 comment · 0 complexity · 63577f6768dd5e5539ed5b0b9433b693 MD5 · raw file

  1. .ig
  2. Copyright (C) 1989-2000, 2001, 2002 Free Software Foundation, Inc.
  3. Permission is granted to make and distribute verbatim copies of
  4. this manual provided the copyright notice and this permission notice
  5. are preserved on all copies.
  6. Permission is granted to copy and distribute modified versions of this
  7. manual under the conditions for verbatim copying, provided that the
  8. entire resulting derived work is distributed under the terms of a
  9. permission notice identical to this one.
  10. Permission is granted to copy and distribute translations of this
  11. manual into another language, under the above conditions for modified
  12. versions, except that this permission notice may be included in
  13. translations approved by the Free Software Foundation instead of in
  14. the original English.
  15. ..
  16. .ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
  17. .el .ds tx TeX
  18. .\" Like TP, but if specified indent is more than half
  19. .\" the current line-length - indent, use the default indent.
  20. .de Tp
  21. .ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
  22. .el .TP "\\$1"
  23. ..
  24. .TH TFMTODIT @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
  25. .SH NAME
  26. tfmtodit \- create font files for use with groff \-Tdvi
  27. .SH SYNOPSIS
  28. .nr a \n(.j
  29. .ad l
  30. .nr i \n(.i
  31. .in +\w'\fBtfmtodit 'u
  32. .ti \niu
  33. .B tfmtodit
  34. .de OP
  35. .ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
  36. .el .RB "[\ " "\\$1" "\ ]"
  37. ..
  38. .OP \-sv
  39. .OP \-g gf_file
  40. .OP \-k skewchar
  41. .I tfm_file
  42. .I map_file
  43. .I font
  44. .br
  45. .ad \na
  46. .PP
  47. It is possible to have whitespace between a command line option and its
  48. parameter.
  49. .SH DESCRIPTION
  50. .B tfmtodit
  51. creates a font file for use with
  52. .B
  53. groff \-Tdvi\fR.
  54. .I tfm_file
  55. is the name of the \*(tx font metric file for the font.
  56. .I map_file
  57. is a file giving the groff names for characters in the font;
  58. this file should consist of a sequence of lines of the form:
  59. .IP
  60. .I
  61. n c1 c2 \fR.\|.\|.
  62. .LP
  63. where
  64. .I n
  65. is a decimal integer giving the position of the character in the font,
  66. and
  67. .IR c1 ,
  68. .IR c2 ,.\|.\|.
  69. are the groff names of the character.
  70. If a character has no groff names but exists in the tfm file,
  71. then it will be put in the groff font file as an unnamed character.
  72. .I font
  73. is the name of the groff font file.
  74. The groff font file is written to
  75. .IR font .
  76. .LP
  77. The
  78. .B \-s
  79. option should be given if the font is special
  80. (a font is
  81. .I special
  82. if
  83. .B troff
  84. should search it whenever
  85. a character is not found in the current font.)
  86. If the font is special,
  87. it should be listed in the
  88. .B fonts
  89. command in the DESC file;
  90. if it is not special, there is no need to list it, since
  91. .B troff
  92. can automatically mount it when it's first used.
  93. .LP
  94. To do a good job of math typesetting, groff requires
  95. font metric information not present in the tfm file.
  96. The reason for this is that \*(tx has separate math italic fonts
  97. whereas groff uses normal italic fonts for math.
  98. The additional information required by groff is given by the
  99. two arguments to the
  100. .B math_fit
  101. macro in the Metafont programs for the Computer Modern fonts.
  102. In a text font (a font for which
  103. .B math_fitting
  104. is false), Metafont normally ignores these two arguments.
  105. Metafont can be made to put this information in the gf file
  106. by loading the following definition after
  107. .B cmbase
  108. when creating
  109. .BR cm.base :
  110. .IP
  111. .nf
  112. .ft B
  113. def ignore_math_fit(expr left_adjustment,right_adjustment) =
  114. special "adjustment";
  115. numspecial left_adjustment*16/designsize;
  116. numspecial right_adjustment*16/designsize;
  117. enddef;
  118. .fi
  119. .ft R
  120. .LP
  121. For the EC font family, load the following definition after
  122. .B exbase
  123. (it is probably easiest to patch
  124. .B exbase.mf
  125. locally):
  126. .IP
  127. .nf
  128. .ft B
  129. def ignore_math_fit(expr left_adjustment,right_adjustment) =
  130. ori_special "adjustment";
  131. ori_numspecial left_adjustment*16/designsize;
  132. ori_numspecial right_adjustment*16/designsize;
  133. enddef;
  134. .fi
  135. .ft R
  136. .LP
  137. The gf file created using this modified
  138. .B cm.base
  139. or
  140. .B exbase
  141. should be specified with the
  142. .B \-g
  143. option.
  144. The
  145. .B \-g
  146. option should not be given for a font for which
  147. .B math_fitting
  148. is true.
  149. .SH OPTIONS
  150. .TP
  151. .B \-v
  152. Print the version number.
  153. .TP
  154. .B \-s
  155. The font is special.
  156. The effect of this option is to add the
  157. .B special
  158. command to the font file.
  159. .TP
  160. .BI \-k n
  161. The skewchar of this font is at position
  162. .IR n .
  163. .I n
  164. should be an integer;
  165. it may be given in decimal,
  166. or with a leading
  167. .B 0
  168. in octal,
  169. or with a leading
  170. .B 0x
  171. in hexadecimal.
  172. The effect of this option is to ignore any kerns whose second component
  173. is the specified character.
  174. .TP
  175. .BI \-g gf_file
  176. .I gf_file
  177. is a gf file produced by Metafont containing special and numspecial
  178. commands giving additional font metric information.
  179. .SH FILES
  180. .Tp \w'\fB@FONTDIR@/devdvi/DESC'u+2n
  181. .B @FONTDIR@/devdvi/DESC
  182. Device description file.
  183. .TP
  184. .BI @FONTDIR@/devdvi/ F
  185. Font description file for font
  186. .IR F .
  187. .SH "SEE ALSO"
  188. .BR groff (@MAN1EXT@),
  189. .BR grodvi (@MAN1EXT@),
  190. .BR groff_font (@MAN5EXT@)
  191. .
  192. .\" Local Variables:
  193. .\" mode: nroff
  194. .\" End: