.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.