← Back to branch summary

~reviczky/luatex/luatex-svn

« back to all changes in this revision

Viewing changes to source/texk/web2c/man/gftodvi.man

  • Committer: Adam Reviczky
  • Date: 2015-03-29 18:56:26 UTC
  • Revision ID: adam.reviczky@kclalumni.net-20150329185626-7j7tmwyfpa69lqwo
Revision 5213

Show diffs side-by-side

added added

removed removed

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