summaryrefslogtreecommitdiff
path: root/fonts/utilities/mff-29/testfont.1
blob: d9e85284306afdd526196ea4dc0438a10fcfac76 (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
155
156
157
158
159
160
161
162
163
164
165
166
167
168
.TH TESTFONT 1 "pdc Tue. 28 May 1991" "mff 2.8" "CONTRIBUTED PROGRAMS"
.SH NAME
testfont \- a wrapper around testfont.tex, for testing and proofing TeX fonts
.SH SYNOPSIS
.ie n \{\
.	ds Te Te
.	ds gf GFtoPK
.	ds mf METAFONT\}
.el \{\
.	ds Te T\v|0.25m|\h|-0.1m|E\v|-0.25m|
.	ds gf \s-1GF\s0to\s-1PK\s0
.	ds mf \s-1METAFONT\s0\}
.na
.B testfont
[
.B \-m
.I magstep
|
.B \-s
.I scale
|
.B \-v
|
.B +msv
|
[
.B \-c
]
.I \*(TeX code
|
.I fontname
].\|.\|.
.SH DESCRIPTION
.I testfont
is a simple shellscript for trying out new \*(TeX fonts.  It
gives a slightly more convenient user-interface to 
.I testfont.tex.
The fonts named by the
.I font
arguments each have the 
.I \*(TeX code
applied to them.
.LP
Because 
\*(TeX
cannot be driven easily from the standard
input,
a file 
.I tmp.tex
is created as follows:
.RS
.if n .sp
.if t .sp 0.5v
.B \e\^let\|\e\^noinit! 
.B \e\^input testfont
.br
.BI \e\^def\|\e\^fontname{ fontname1 }
.B \e\^startfont
.I \*(TeX code
.br
\&.\|.\|.
.br
.BI \e\^def\|\e\^fontname{ fontnameN }
.B \e\^startfont
.I \*(TeX code
.br
.B \e\^bye
.if n .sp
.if t .sp 0.5v
.RE
\*(TeX is run on this file and if the environment variable
.SM DISPLAY
is set then the 
.SM DVI
previewer
.IR xdvi (1)
is invoked on 
.IR tmp.dvi .
.SH OPTIONS
.TP
.BI \-c " \*(TeX code"
This sets the \*(TeX code to be used to try out the fonts.  (The default
is 
.BR \e\^names ).
The \*(TeX code should usually be quoted to protect it from the shell.
For example:
.B testfont \-c \(fm\|\e\^table\|\e\^punct\(fm 
.BR cmr12 .
Words starting with a backslash are assumed to be additional \*(TeX
code and are appended to the code line.  
.RB ( \-c
.I code 
discards the accumulated text and starts afresh).
.TP
.B +c
Sets the \*(TeX code to be 
.BR \e\^names .
.TP
.B \-h
.PD 0v
.TP
.B \-?
.PD
Prints a help message.
.TP
.BI \-m " number"
Subsequent 
fonts will all be scaled by magstep
.I number 
(that is, 1.2 raised to the
.IR number th
power).
.TP
.BI \-s " number"
Subsequent fonts will be scaled by 
.I number
divided by 1000.
.TP
.B +m
.PD 0v
.TP
.B +s
.PD
Subsequent fonts will be loaded unscaled (that is, at magnification
1.0).
.TP
.B \-v
The temporary \*(TeX file is printed to standard output before \*(TeX is
invoked.  Cancelled by a subsequent 
.BR +v ).
.SH FILES
.TP
.B testfont.tex
A file of
\*(TeX macros for testing fonts with (one is usually supplied with
\*(TeX and is listed in Appendix H of the 
.IR \*(mfbook );
a given font might have a different 
.I testfont.tex
file which will be found by \*(TeX instead of the default one if
.I testfont
is run in that directory.
.TP
.B tmp.tex
A temporary file of \*(TeX code.
.TP
.B tmp.dvi
The DeVice Independent file which \*(TeX creates.
.TP
.B tmp.log
Log file created by \*(TeX. 
.SH AUTHOR
Damian Cugley
<pdc@prg.ox.ac.uk>.
See
.IR mff (1)
for information about reporting bugs.
.SH "SEE ALSO"
mf(1), mff(1), tex(1), xdvi(1)
.LP
Donald E. Knuth, 
.I The \*(mfbook
(Appendix H, Section 4 `Font samples').  Addison-Wesley, 1986.  ISBN
0\-201\-13444\-6.
.LP
Donald E. Knuth, 
.I The \*(TeXbook.
Addison-Wesley, 1984.  ISBN 0\-201\-13448\-9.