summaryrefslogtreecommitdiff
path: root/dviware/umddvi/man
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /dviware/umddvi/man
Initial commit
Diffstat (limited to 'dviware/umddvi/man')
-rw-r--r--dviware/umddvi/man/dvidmd.1186
-rw-r--r--dviware/umddvi/man/dvipr.196
-rw-r--r--dviware/umddvi/man/dviselect.1110
-rw-r--r--dviware/umddvi/man/iptex.1126
4 files changed, 518 insertions, 0 deletions
diff --git a/dviware/umddvi/man/dvidmd.1 b/dviware/umddvi/man/dvidmd.1
new file mode 100644
index 0000000000..df5f293801
--- /dev/null
+++ b/dviware/umddvi/man/dvidmd.1
@@ -0,0 +1,186 @@
+.TH DVIDMD 1
+.SH NAME
+dvidmd \- DVI previewer for DMD 5620 display
+.SH SYNOPSIS
+.B
+dvidmd [-x] [-m mag] [-R res] [-d drift] [-X xoffset] [-Y yoffset] [file]
+.SH DESCRIPTION
+.I dvidmd
+is used to display DVI files on the 5620 DMD terminal.
+DVI files are generated by programs such as TeX and LaTeX.
+.PP
+Like all DMD applications,
+.I dvidmd
+is really two separate programs, one of which runs in the host
+and the other which runs in the terminal. For
+.I dvidmd ,
+the host program's main job is to interpret DVI commands and
+read files that contain font information. The slave's main job
+is to handle display operations such as copying character
+rasters to the correct positions on the screen.
+.PP
+When the host program is started, it will check if the slave
+program is already running in that terminal window. If the slave
+program is not running, it will automatically be downloaded into
+that window by the host program. While the download is in progress,
+a coffee-cup cursor will appear in that window.
+.LP
+.B "Host Program Options"
+.PP
+The host program supports a variety of options:
+.TP 10
+-x
+Cause the
+.I dvidmd
+slave program to exit
+once the host program has finished. By default the slave program
+switches to terminal emulation mode (see below).
+.TP 10
+-m mag
+Explicitly magnify the image by the specified amount. A typically
+value might be 1.2, corresponding to \emagstep1 in TeX.
+.TP 10
+-R \fIres\fP
+Specify the assumed output resolution of the DMD display. This
+value defaults to 118 dots per inch. Although this is not the
+actual resolution of the DMD 5620, it is a standard
+resolution that font files are distributed for in the TeX
+distribution. Other reasonable device resolutions (disk space
+permitting) are 200 and 300 dots per inch, which in effect
+magnify the image a corresponding amount.
+.TP 10
+-d \fIdrift\fP
+A spacing parameter used in setting type on the display. The
+default value is generally fine.
+.TP 10
+-X \fIxoffset\fP
+Specify the horizontal offset in tenths of an inch.
+.TP 10
+-Y \fIyoffset\fP
+Specify the vertical offset in tenths of an inch.
+.LP
+If no
+.I file
+argument is specified then the host program exits, but only after
+loading the slave program if necessary.
+.LP
+.B "Slave Emulation Modes"
+.PP
+The slave program can be in one of two modes: typesetter emulation
+mode and terminal emulation mode. Typesetter emulation mode
+is used by the
+.I dvidmd
+host program to display DVI files; it allows arbitrary glyphs to
+be displayed anywhere on the screen.
+.PP
+Terminal emulation mode
+can be used by arbitrary programs to interact with the user;
+this mode uses the default terminal font for its display.
+However, only a few escape sequences are interpreted by
+the terminal emulator, so it can only be used by programs
+that work properly on ``dumb'' terminals. In particular,
+a screen editor such as
+.IR vi (1)
+will not work properly in terminal emulation mode; use another
+window for these more sophisticated programs.
+.PP
+Note that glyphs downloaded by the
+.I dvidmd
+host program in typesetter mode are saved by the slave program in
+terminal memory. Therefore, future runs of
+.I dvidmd
+(in the same window) run much faster since they need not reload the
+(rather large) raster data.
+.LP
+.B "Page Commands"
+.PP
+When the slave program is in typesetter emulation mode, it will display
+data until it receives an end of page command. At this point it will
+change the cursor to a "CMD" prompt and wait for input from the user.
+If the user holds down mouse button 3, a menu will appear with various
+choices:
+.TP 10
+\fBredraw\fP
+Redraw the current screen, resetting the origin to the upper left hand
+corner of the page.
+.TP 10
+\fBnext\fP
+Display the next screen-full of data.
+If the bottom of the page is currently being displayed,
+the next page of data is requested from the host program.
+.TP 10
+\fBprev\fP
+Display the previous screen-full of data.
+If the top of the page is currently being displayed,
+the previous page of data is requested from the host program.
+.TP 10
+\fBquit\fP
+Cause the slave program to leave the typesetter emulation mode and enter
+the terminal emulation mode. Choose this option if you plan to run
+.I dvidmd
+again.
+.TP 10
+\fPexit\fP
+Causes the slave program to exit. The default DMD 5620 terminal emulator
+is reloaded into the window. All glyphs downloaded into the terminal
+are freed.
+.LP
+Alternatively, you can invoke the above paging commands by typing
+the first letter of the command name. So, for example, type `p'
+for previous, `n' for next, and `q' for quit. In addition, the
+following character commands are also available:
+.TP 10
+\fB+\fP or \fB<RET>\fP
+Request the next page of data from the host program, resetting the
+origin to the upper left hand corner of the page.
+.TP 10
+\fB-\fP
+Request the previous page of data from the host program, resetting the
+origin to the upper left hand corner of the page.
+.TP 10
+\fB<SPACE>\fP
+Another way of typing the next command.
+.TP 10
+\fB^L\fP
+Another way of typing the redraw command.
+.LP
+.B "Scrolling Commands"
+.PP
+At the end of page, the user can scroll the display by moving the mouse
+cursor into the scrolling area. The scrolling area is along the left
+and bottom edges of the screen, and its edges are marked by small segments
+in the corners of the display. When the mouse is positioned in the scrolling
+area, the mouse cursor will change into a cross-hair shape.
+.PP
+For vertical scrolling, position the mouse in the left scroll bar (between
+the two horizontal marks at the top and bottom of the screen).
+Clicking button 1 in the left scroll bar will
+bring the line at the current mouse position to the top of the window,
+while clicking button 3 will bring the line at the top of the
+screen down to the current mouse position. Thus these two buttons
+function as inverses of each other.
+.PP
+For horizontal scrolling, position the mouse in the bottom scroll bar,
+and then use button 1 to bring the current mouse position
+to the left edge of the screen. As expected, button 3 performs the
+inverse operation: it brings the left edge of the screen to the current
+mouse position.
+.PP
+If the mouse is positioned in the scroll ``box'' in the lower left corner
+of the screen, clicking button 1 will advance to the next screen,
+clicking button 2 will redraw the screen, and clicking button 3 will go
+back to the previous screen.
+.SH "SEE ALSO
+tex(1), tpic(1)
+.SH FILES
+/usr/local/bin/dvidmd.j \- layers slave program
+.br
+/usr/local/bin/dvidmd.m \- host slave program
+.SH BUGS
+The scrolling interface needs some work and is too slow.
+.br
+The terminal emulation mode needs to support more escape sequences.
+.br
+More graphics commands should be interpreted. Right now only the
+.IR tpic (1)
+primitives are supported.
diff --git a/dviware/umddvi/man/dvipr.1 b/dviware/umddvi/man/dvipr.1
new file mode 100644
index 0000000000..4d1acc7767
--- /dev/null
+++ b/dviware/umddvi/man/dvipr.1
@@ -0,0 +1,96 @@
+.TH DVIPR 1
+.SH NAME
+dvipr \- print dvi version 2 files, produced by TeX82, to the Versatec
+.SH SYNOPSIS
+.B dvipr
+[
+.B \-q
+] [
+.B \-v
+] [
+.B \-c
+] [
+.B \-m
+.I number
+] [
+.B \-h
+] [
+.B \-s
+] [
+.B \-d
+.I number
+]
+.I .dvi file name
+.SH DESCRIPTION
+.I dvipr
+prints .dvi files produced by
+.IR TeX (1)
+on the Versatec. The basic process involves two passes. In the first
+pass, the .dvi file is converted into a list of characters.
+The second pass takes this list and prints it onto the Versatec. When
+the
+.B \-q
+option (for quiescent) is invoked, intermediate output is not spooled
+to the Versatec; instead, it is written to the standard output. The
+.B \-v
+option (for Versatec) is used to print this intermediate output.
+The
+.B \-c
+option indicates you want to have your output centered on the page.
+Otherwise, a default left margin is used. The
+.B \-m
+.I number
+option is used to change the device magnification (which is in addition to
+any magnification defined in the TeX source file).
+.I number
+should be replaced by an integer which is 1000 times the magnification
+you want.
+for example,
+.B \-m 1315
+would produce output magnified to 131.5% of true size. Using device
+magnification is most useful when you are trying to produce a output for
+publication. (Many photocopiers will reduce output to 77% of size. When you
+reduce output printed at 131.5% to 77%, you
+get close to the true size.) The default is
+no magnification (1000). Note, however, that a site will only
+support particular magnifications. If you get error messages indicating that
+fonts are missing when using this option, you probably have picked an
+unsupported magnification.
+.PP
+The
+.B \-h
+flag, when
+supplied, causes printing to be done vertically on the page.
+This is only useful if you plan to use a reducing copier.
+.PP
+Normally the first pass prints the page numbers from the .dvi file. The
+.B \-s
+flag suppresses these.
+.PP
+The default
+.I maxdrift
+parameter is 2 pixels (1/100th of an inch); the
+.B \-d
+option may be used to alter this. The
+.I maxdrift
+parameter determines just how much font spacing is allowed to
+influence character positioning. The value 2 allows a small amount of
+variation within words without allowing any letters to become too far
+out of position; this had been happening in rare cases before the
+.I maxdrift
+code was added.
+.SH FILES
+/usr/local/dvipr
+.br
+/usr/local/verser1 first pass
+.br
+/usr/local/verser2 second pass
+.SH SEE ALSO
+dviselect(1), iptex(1), tex(1)
+.SH AUTHOR
+The original version was written by Janet Incerpi of Brown University.
+Richard Furuta and Carl Binding of the University of Washington
+modified the programs for DVI version 2 files. Chris Torek of
+the University of Maryland rewrote
+both passes in order to make them run at reasonable speeds.
+.SH BUGS
diff --git a/dviware/umddvi/man/dviselect.1 b/dviware/umddvi/man/dviselect.1
new file mode 100644
index 0000000000..79d9df926a
--- /dev/null
+++ b/dviware/umddvi/man/dviselect.1
@@ -0,0 +1,110 @@
+.TH DVISELECT 1
+.SH NAME
+dviselect \- extract pages from DVI files
+.SH SYNOPSIS
+.B dviselect
+[
+.B \-s
+] [
+.B \-i
+.I infile
+] [
+.B \-o
+.I outfile
+]
+.I "list of pages"
+[
+.I infile
+[
+.I outfile
+] ]
+.SH DESCRIPTION
+.I Dviselect
+selects pages from a DVI file produced by TeX, creating a new DVI
+file usable by any of TeX's conversion program (e.g., iptex), or even
+by dviselect itself.
+.PP
+A
+.I range
+is a string of the form
+.I first:last
+where both
+.I first
+and
+.I last
+are optional numeric strings, with negative numbers indicated by
+a leading underscore character ``_''. If both
+.I first
+and
+.I last
+are omitted, the colon may also be omitted, or may be replaced
+with an asterisk ``*''. A
+.I page range
+is a list of ranges separated by periods. A
+.I "list of pages"
+is described by a set of page ranges separated by commas and/or white space.
+.PP
+.I Dviselect
+actually looks at the ten
+.I count
+variables that TeX writes; the first of these (\ecount0) is the
+page number, with \ecount1 through \ecount9 having varied uses
+depending on which macro packages are in use. (Typically \ecount1
+is a chapter or section number.) A page is included in
+.IR dviselect 's
+output if all its \ecount values are within any one of the ranges
+listed on the command line. For example, the command
+``dviselect *.1,35:''
+might select everything in chapter 1, as well as pages 35 and up.
+``dviselect 10:30'' would select pages 10 through 30 (inclusive).
+``:43'' means everything up to and including page 43 (including
+negative-numbered pages).
+If a Table of Contents has negative page numbers, ``:_1'' will select it.
+``*.4 .........1'' might
+mean everything in every chapter 4 and an index, presuming \ecount9
+was set to 1 in the index. (``*'' must be quoted from the shell;
+the null string is more convenient to use, if harder to read.)
+.PP
+Instead of \ecount values,
+.I dviselect
+can also select by ``absolute page number'', where the first page
+is page 1, the second page 2, and so forth. Absolute page numbers
+are indicated by a leading equal sign ``=''. Ranges of absolute
+pages are also allowed: ``dviselect =3:7'' will extract the third
+through seventh pages. Dot separators are not legal in absolute
+ranges, and there are no negative absolute page numbers.
+.PP
+More precisely, an asterisk or a null string implies no limit;
+an equal sign means absolute pages rather than \ecounts;
+a leading colon means everything up to and including the given page; a
+trailing colon means everything from the given page on; and
+a period indicates that the next \ecount should be examined.
+If fewer than 10 ranges are specified, the remaining \ecounts
+are left unrestricted (that is, ``1:5'' and ``1:5.*'' are equivalent).
+A single number \fIn\fP is treated as if it were the range \fIn:n\fP.
+An arbitrary number of page selectors may be given, separated by commas
+or whitespace; a page is selected if any of the selectors matches
+its \ecounts or absolute page number.
+.PP
+Dviselect normally prints the page numbers of the pages selected; the
+.I \-s
+option suppresses this.
+.SH AUTHOR
+Chris Torek, University of Maryland
+.SH "SEE ALSO"
+dvipr(1), iptex(1), tex(1), \fIThe TeXbook\fP
+.SH BUGS
+A leading ``-'' ought to be allowed for negative numbers, but it
+is currently used as a synonym for ``:'', for backwards compatibility.
+.PP
+Section or subsection selection will sometimes fail, for the DVI
+file lists only the \ecount values that were active when the page
+ended. Clever macro packages can alleviate this by making use of
+other ``free'' \ecount registers. Chapters normally begin on new
+pages, and do not suffer from this particular problem.
+.PP
+.I Dviselect
+does not adjust the parameters in the postamble; however, since these
+values are normally used only to size certain structures in the output
+conversion programs, and the parameters never need to be adjusted upward,
+this has not proven to be a problem.
diff --git a/dviware/umddvi/man/iptex.1 b/dviware/umddvi/man/iptex.1
new file mode 100644
index 0000000000..5af0c74d31
--- /dev/null
+++ b/dviware/umddvi/man/iptex.1
@@ -0,0 +1,126 @@
+.TH IPTEX 1
+.SH NAME
+iptex \- print DVI files on the Imagen
+.SH SYNOPSIS
+.B iptex
+[
+.B \-c
+] [
+.B \-d
+.I maxdrift
+] [
+.B \-l
+] [
+.B \-m
+.I magnification
+] [
+.B \-p
+] [
+.B \-r
+.I resolution
+] [
+.B \-s
+] [
+.B \-X
+.I x-offset
+] [
+.B \-Y
+.I y-offset
+]
+.I filename
+.SH DESCRIPTION
+.I Iptex
+takes a DVI file produced by TeX and converts it to a format suitable
+for the Imagen series printers.
+.I filename
+should be the name of a
+.B .dvi
+file, or ``\-'' for standard input (useful for reading the output
+of the
+.I dviselect
+program). By default,
+.I iptex
+produces output for
+a 300 dpi printer (the 8/300) but this may be overridden with the
+.I \-r
+flag:
+.B "\-r 240"
+produces output suitable for the Imprint-10 (a.k.a. the 10/240).
+.PP
+To get landscape mode (rather than portrait mode) output, use the
+.B \-l
+flag. However, this has not been extensively tested.
+.PP
+The
+.I \-m
+flag applies a global magnification to the output. If you have slides
+that are to be reduced, you can fiddle with the output size using \-m.
+(By the way, \-r is really \-m in disguise.)
+.PP
+Normally, iptex will print the page number of each page (actually
+the value in \\count0) as it runs, to demonstrate its blinding speed.
+If this is not desired, use the
+.I \-s
+option to suppress unnecessary verbiage. (And yes, it really
+.I is
+supposed to count down from the last page.)
+.PP
+.I Iptex
+is actually a shell script that invokes the conversion program and
+feeds its output to Imagen's
+.I ipr
+command. Normally this is done by creating a file in $TMPDIR
+(default /tmp), so that missing fonts can be caught before ipr
+runs away with the output. However, if desired, you can force
+the output to be piped directly to ipr with the
+.I \-c
+flag.
+.PP
+The
+.I maxdrift
+parameter controls
+.BR iptex 's
+behaviour under certain obscure conditions. Because it is so rarely
+needed, and because 2 is such a wonderful default, I am not going to
+tell you exactly what it really does. (Besides, I have not yet
+figured out how to describe it.)
+.PP
+There are three options that are normally only useful to people installing
+.I iptex
+which are quickly summarized here:
+.B \-p
+prevents page reversal (useful with the Ricoh engine);
+.B \-X
+and
+.B \-Y
+set an offset to apply to every page (useful with the LBP-10, for
+example, where output starts a few tenths of an inch away from the upper
+left hand corner of the page). The offsets are in tenths of an inch
+and may be negative. Default offsets should be set in the
+.I iptex
+shell script; they will be overridden by explicit
+.B \-X
+and
+.B \-Y
+arguments.
+.SH DIAGNOSTICS
+Most of these should be self explanatory. The message ``unable to
+copy input to temp file'' should only occur when reading standard
+input, and indicates that the temporary file required when reading
+pipes is too large for wherever it is being stored. The environment
+variable ``TMPDIR'' defines which file system is used for this
+temporary file; the default is /tmp. Either put the intermediate DVI
+file in a real disk file, or set TMPDIR, in such cases.
+.SH AUTHOR
+Chris Torek, University of Maryland
+.br
+Mike Urban (TRW) added the \-p, \-X, and \-Y options.
+.SH FILES
+imagen1 - conversion program
+.br
+ipr - Imagen spooler
+.SH "SEE ALSO"
+dvipr(1), dviselect(1), tex(1)
+.SH BUGS
+.I Still
+needs to handle more ``\especial''s.