diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /dviware/umddvi/man |
Initial commit
Diffstat (limited to 'dviware/umddvi/man')
-rw-r--r-- | dviware/umddvi/man/dvidmd.1 | 186 | ||||
-rw-r--r-- | dviware/umddvi/man/dvipr.1 | 96 | ||||
-rw-r--r-- | dviware/umddvi/man/dviselect.1 | 110 | ||||
-rw-r--r-- | dviware/umddvi/man/iptex.1 | 126 |
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. |