XPROOF(1) X Version 11(U of Wisconsin) XPROOF(1)
NAME
xproof - preview typesetter-independent troff using X Windows
SYNOPSIS
xproof -V
xproof [-toolkitoption ...] [-option ...] [file]
DESCRIPTION
The first form prints a message indicating the version of xproof and
exits. The second form takes as input the output of device-independent
troff (ditroff) and shows how it will look, using the X window package.
The file may be created using ``ditroff -t troff-source''. The first
page of the document is shown in a window with a menu bar a the top. If
the window is not large enough to show the whole page, scroll bars will
appear on the left side and/or top, allowing you to move the window over
the page. The menu bar lists the name of the file and has buttons back,
forward, quit, Go to page ..., refresh, magnify, and shrink. Clicking
the left mouse button in the back or forward button moves you to the
previous or next page of the document, respectively. A button shown in a
gray tone is temporarily disabled (for example the back button when you
are viewing the first page). Clicking quit terminates Xproof. Clicking
the left, center, or right mouse button inside the proof window has the
same effect as the back, forward, or quit button, respectively.
The magnify and shrink buttons multiply or divide the current scale
factor by 1.2, respectively. (See the description of the scale option
below).
The refresh button refreshes the current page. In addition, the file is
reopened if it has changed.
The Go to page ... button causes a menu to pop up, allowing you to go
directly to any page of the document. The page numbers listed are the
page numbers assigned by troff; if you used the .np or .bp request with
an arguement, there may be more than one page with the same number.
If xproof is invoked with no file argument, it reads from standard input.
In this case the Go to page ... and refresh buttons are not available,
and the back button is diabled.
Note: Some widow managers grab mouse buttons for their own use. If the
mouse buttons don't seem to be working, try holding down SHIFT or CTRL
while using the mouse.
Commands can also be entered from the keyboard instead of the mouse. A
command consists of an optional count followed by a command letter. A
count is either an unsigned decimal number or the symbol `$' (meaning
infinity). Commands are not echoed.
The r (refresh) command refreshes the current page. A synonym is ^L .
10/89 Page 1
XPROOF(1) X Version 11(U of Wisconsin) XPROOF(1)
The f (forward) commmand advances count pages (default one). Synonyms
are d (down), n (next), and +.
The b (back) command moves back count pages (default one). Synonyms are
u (up), p (previous), and -.
If no count is specified, G goes to the last page of the document, the g
goes to the first page, and RETURN advances one page (like f). With an
explicit count, all three commands search for a page whose page number
matches count. Several pages can have the same number; the search is
forward from the current page, with wraparound from the last page to the
first.
The q (quit) or x (eXit) command terminates xproof.
With the exeception of the g and G commands, case is not significant.
OPTIONS
Xproof accepts all of the standard X Toolkit command line options. The
most useful options are probably -geometry and -rv (reverse video). For
example, ``-geom -0+0'' will immediately place the xproof window at the
upper-right corner of your screen without prompting you for a size and
location. In addition, xproof accepts the option -scale n, where n is a
positive integer, to set the scale factor resource. The default scale
factor is 10, which causes the document to appear approximately actual
size on a 75 dot-per-inch display. A scale factor of n enlarges the
display by a factor of n/10. For example -scale 12 will make it 20%
larger.
Note: Both the sizes and spacing of characters are scaled, but only a
limited set of point sizes are available (currently 8, 10, 12, 14, 18,
and 24 points). If a required font is not available, xproof will choose
the closest avialable size. Thus, specifying -scale 16 will make all
dimensions 60% larger, but the individual characters will only be 40%
larger, if they were originally specified as 10-point type.
XDEFAULTS
This program uses the Proof widget. That means that defaults can be
specified in your .Xdefaults file under ``xproof'' or ``Proof''.
Examples include
xproof.geometry: 400x600+100+100,
Proof*reverseVideo: on,
and
Proof*scale: 14.''.
AUTHOR
Marvin Solomon
COPYRIGHT
Copyright 1988, 1989 by Marvin Solomon.
Permission to use, copy, modify, and distribute this software and its
Page 2 10/89
XPROOF(1) X Version 11(U of Wisconsin) XPROOF(1)
documentation for any purpose and without fee is hereby granted, provided
that the above copyright notice appear in all copies and that both that
copyright notice and this permission notice appear in supporting
documentation, and that the name of Marvin Solomon not be used in
advertising or publicity pertaining to distribution of the software
without specific, written prior permission. Marvin Solomon makes no
representations about the suitability of this software for any purpose.
It is provided ``as is'' without express or implied warranty.
SEE ALSO
ditroff(1), troff(1)
BUGS
Undoutedly many. Some known ones are:
The fonts are ugly and there are not enough point sizes or faces. The
widths of the characters may not correspond to what your target (hard
copy) device expects, although each character is individually placed in
the right location on the page, giving text an especially uneven look.
Lots more features would be handy. One that comes to mind is a way of
specifying which page to show first. It would also be nice to be able to
move around in a file even if it is supplied as standard input.
The pop-up menu for Go to page ... is dificult to use when there are
lots of pages.
On some servers (for example the qdss server), xproof will be
excruciatingly slow unless it is run with the +usepixmap option. If this
option is used, xproof will be moderately slow, and if input is coming
from a pipe, the window will not be correctly refreshed after it is
raised, resized, or scrolled.
10/89 Page 3