DPV

Section: User Commands (1)
Index Return to Main Contents
 

NAME

dpv - ditroff output previewer  

SYNOPSIS

dpv [ -d ] [ +page ] file  

DESCRIPTION

Dpv is a previewer for ditroff(1) output. There must be exactly one file argument, specifying a file produced by ditroff. The -d option turns some debugging output on (if compiled in). The +page option selects the initial page to display (default 1).  

MENUS

There are two menus. The Control menu contains commands to move around in the file, and a Quit command to leave the program. The Print menu contains commands to spool the file to various printers queues. Some checks are made that the file is compatible with the printer.  

KEYBOARD CONTROL

The following characters typed at the keyboard are interpreted as commands. A number N followed by a Carriage Return moves to page N. Carriage Return without preceding number moves one page forward. `.' with preceding number is equivalent to Carriage Return; without preceding number it redraws the current page. `N' moves to the next page, `P' moves to the previous page. A number N followed by `N' or `P' moves N pages forward or backward. Up arrow and backspace are equivalent to `P'; `+', down arrow and space are equivalent to `N'. `-' is a toggle: it jumps to the previous page that was shown. `^' or `F' moves to the first page; `$' or `L' to the last. `G' without preceding number also moves to the last page; with a preceding number N it moves to page N. `Q' quits from the program. Lower case letters are equivalent to their upper case counterparts.  

DIAGNOSTICS

Complaints about missing files, unknown fonts and what have you are written to stderr.  

FILES

funnytab, /usr/local/lib/funnytab, /userfs3/amoeba/lib/funnytab - funny character translation table search path  

SEE ALSO

ditroff(1)  

AUTHOR

Guido van Rossum  

BUGS

May crash on malformed input (not generated by ditroff).
Arcs and splines are replaced by straight lines (because I don't have the necessary mathematics at hand), so output from pic(1) or other graphics preprocessors may be unrecognizable.
Doesn't know all funny characters. Unknown characters are silently suppressed.
Doesn't know all fonts, or all sizes. Unknown fonts and sizes are replaced by known ones.
The current X11 version uses Adobe bitmap fonts which don't match very well with the width tables for the Harris.
Character and line spacing are scaled, but it believes that it should use characters in the point sizes specified in the input. This may cause the output to look a bit cramped.
It assumes page numbers always start at 1; it doesn't know about the true page numbers (even though these are present in the ditroff output).
There should be an argument to specify an alternate funny character translation table file.
The font translation table should be read from a file as well.
If it can't find the funny character translation table file, it should fall back on a reasonable default.
The Print menu is very CWI-specific; it, too should be customizable instead of being wired in.
Errors in the input are handled ungracefully.
STDWIN prints a warning to stderr for every font change if a font in the translation table doesn't exist (e.g., if you are using the X11 Release 3 version of dpv with a Release 2 server, or vice versa; or if you have botched your font directory or font path). needless to say this can be annoying.


 

Index

NAME
SYNOPSIS
DESCRIPTION
MENUS
KEYBOARD CONTROL
DIAGNOSTICS
FILES
SEE ALSO
AUTHOR
BUGS

This document was created by man2html, using the manual pages.
Time: 09:07:02 GMT, February 14, 2025