Add options -p and -l to grodvi.

* src/devices/grodvi/dvi.cc: Include paper.h.
(landscape_flag, user_paper_length, user_paper_width): New global
variables.
(dvi_printer::begin_page): Emit `papersize' special.
Set color after initialization of `cur_h' and `cur_v'.
(main): Add options `-l' and `-p'.
* font/devdvi/Makefile.sub (DESC): Set `papersize'.
* src/devices/grodvi/grodvi.man, NEWS: Updated.

* src/devices/grops/psrm.cc (valid_input_table): Fixed.

* src/devices/grops/grops.man: Move documentation of .PSPIC to...
* man/groff_tmac.man: This man page.
* man/groff_font.man: Declare `paperwidth' and `paperlength' as
deprecated.

* tmac/X.tmac: Don't load pspic.tmac.

1 files changed, 60 insertions, 1 deletions

diff --git a/man/groff_tmac.man b/man/groff_tmac.man
index d7748dc7..c1d8006a 100644
--- a/man/groff_tmac.man
+++ b/man/groff_tmac.man
@@ -1,4 +1,3 @@
-.
 .TH GROFF_TMAC @MAN5EXT@ "@MDATE@" "Groff Version @VERSION@"
 .SH NAME
 groff_tmac \- macro files in the roff typesetting system
@@ -451,6 +450,66 @@ orientation:
 .
 .
 .TP
+.B pspic
+A single macro is provided in this file,
+.BR PSPIC ,
+to include a PostScript graphic in a document.
+.
+It makes only sense for output devices which support inclusion of PS
+images:
+.BR \-Tps ,
+.BR \-Tdvi ,
+and
+.BR \-Thtml ;
+the file is then loaded automatically.
+.
+Syntax:
+.RS
+.IP
+\&\fB.PSPIC\fP [\fB\-L\fP|\fB-R\fP|\fB\-I\fP \fIn\fP]\ \fI\|file\fP [\fIwidth\fP [\fIheight\fP]]
+.RE
+.
+.IP
+.I file
+is the name of the file containing the illustration;
+.I width
+and
+.I height
+give the desired width and height of the graphic.
+.
+The
+.I width
+and
+.I height
+arguments may have scaling indicators attached;
+the default scaling indicator is\~\c
+.BR i .
+.
+This macro will scale the graphic uniformly
+in the x and y\~directions so that it is no more than
+.I width
+wide
+and
+.I height
+high.
+.
+By default, the graphic will be horizontally centered.
+.
+The
+.BI \-L
+and
+.BI \-R
+options cause the graphic to be left-aligned and right-aligned,
+respectively.
+.
+The
+.B \-I
+option causes the graphic to be indented by\~\c
+.I n
+(default scaling indicator is\~\c
+.BR m ).
+.
+.TP
 .B tty-char
 Overrides the definition of standard troff characters and some groff
 characters for tty devices.