summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/gftodvi.1
blob: 6471ec079a29acf551c792f1901931319fbd967f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
.TH GFTODVI 1 "4 March 2021" "Web2C 2024"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP
.el .ds OX TeX
.\"=====================================================================
.SH NAME
gftodvi \- make proof sheets from generic font files
.SH SYNOPSIS
.B gftodvi
.RB [ \-overflow-label-offset=\fI\,real\/\fP ]
.RB [ \-verbose ]
.I gf_file_name
.\"=====================================================================
.SH DESCRIPTION
This manual page is not meant to be exhaustive. The complete
documentation for this version of \*(TX can be found in the info file
or manual
.IR "Web2C: A TeX implementation" .
.PP
The
.B gftodvi
program converts a generic font
.RI ( gf )
file output by, for example,
.BR mf (1),
to a device independent (DVI) file (that can then be typeset using the same
software that has already been written for \*(TX). The characters in the
.I gf
file will appear one per page, with labels, titles, and annotations
as specified in Appendix H (Hardcopy Proofs) of
.IR "The \*(MFbook" .
.PP
.B gftodvi
uses other fonts in addition to the main
.I gf
file.
A `gray' font is used to typeset the
pixels that actually make up the character. (We wouldn't
want all the pixels to be simply black, since then labels,
key points, and other information would be lost.)  A `title' font
is used for the information at the top of the page. A `label' font
is used for the labels on key points of the figure. A `slant'
font is used to typeset diagonal lines, which
otherwise have to be simulated using horizontal and vertical rules.
The default gray, title, and label fonts are
.IR gray ,
.IR cmr8 ,
and
.IR cmtt10 ,
respectively; there is no default slant font.
.PP
To change the default fonts, you can give
.B special
commands in your
\*(MF source file, or you can change the fonts online. An online dialog
ensues if you end the
.I gf_file_name
with a `/'. For example,
.br
.ti +2
gftodvi cmr10.300gf/
.br
.ti +2
Special font substitution: grayfont black
.br
.ti +2
OK; any more? grayfontarea /home/art/don/
.br
.ti +2
OK; any more? slantfont /home/fonts/slantimagen6
.br
.ti +2
OK; any more? <RET>
.br
will use
.I /home/art/don/black
as the `gray' font and
.I /home/fonts/slantimagen6
as the `slant' font (this name indicates
a font for lines with slope 1/6 at the resolution of an Imagen printer).
.PP
The
.I gf_file_name
on the command line must be complete. Because
the resolution is part of the extension, it would not make
sense to append a default extension as is done with \*(TX or
DVI-reading software. The output file name uses the same
root as the
.I gf
file, with the
.B .dvi
extension added. For example, the input file
.I cmr10.2602gf
would become
.IR cmr10.dvi .
.\"=====================================================================
.SH OPTIONS
The argument to
.B \-overflow-label-offset
specifies the distance from the right edge of the character
bounding box at which the overflow equations (if any) are typeset.
The value is given in \*(TX points. The default is a little over two
inches.
.PP
Without the
.B \-verbose
option,
.B gftodvi
operates silently. With it, a banner and progress report are printed on
.IR stdout .
.\"=====================================================================
.SH ENVIRONMENT
.B gftodvi
looks for
.I gf_file_name
using the
environment variable GFFONTS. If that is not set, it uses the variable
TEXFONTS. If that is not set, it uses the system default.
.PP
See
.BR tex (1)
for the details of the searching.
.\"=====================================================================
.SH FILES
.TP
.I {gray.tfm,.\|.\|.}
The default fonts.
.TP
.I {gray.mf,.\|.\|.}
The \*(MF sources.
.\"=====================================================================
.SH "SEE ALSO"
.BR tex (1),
.BR mf (1).
.br
Donald E.\& Knuth,
.I "The \*(MFbook"
(Volume C of
.IR "Computers and Typesetting" ),
Addison-Wesley, 1986, ISBN 0-201-13445-4.
.br
Donald E.\& Knuth et al.,
.IR \*(MFware .
.\"=====================================================================
.SH AUTHORS
Donald E.\& Knuth wrote and still maintains the program. It was
published as part of the
.I \*(MFware
technical report. Paul Richards originally ported it to Unix. 
Bug reports should go to tex-k@tug.org (https://lists.tug.org/tex-k).