commit 3cb3f72a5c629284bbde8ecc1ac68419941866fe
parent 9cbd72fa1b4ed7c8aae28a787a6d8ee63e7b5d82
Author: Kyle Milz <krwmilz@gmail.com>
Date: Sat, 21 Aug 2021 04:08:35 +0000
remove postscript manual verbiage
Diffstat:
M | xdvi-man.sed | | | 371 | ------------------------------------------------------------------------------- |
1 file changed, 0 insertions(+), 371 deletions(-)
diff --git a/xdvi-man.sed b/xdvi-man.sed
@@ -75,23 +75,6 @@ xdvi \- DVI Previewer for the X Window System
[\fB\-keep\fP] [\fB\-copy\fP] [\fB\-thorough\fP]
[\fB\-wheelunit\fP \fIpixels\fP]
[\fB\-noscan\fP]
-#ifps
-[\fB\-nopostscript\fP]
-[\fB\-allowshell\fP]
-#endif
-#ifdps
-[\fB\-nodps\fP]
-#endif
-#ifnews
-[\fB\-nonews\fP]
-#endif
-#ifghost
-[\fB\-noghostscript\fP]
-[\fB\-nogssafer\fP]
-[\fB\-gsalpha\fP]
-[\fB\-interpreter\fP \fIpath\fP]
-[\fB\-gspalette\fP \fIpalette\fP]
-#endif
#iftool
[\fB\-dvipspath\fP \fIpath\fP]
#endif
@@ -139,20 +122,6 @@ In addition to using keystrokes to move within the file,
provides buttons on the right side of the window, which are synonymous
with various sequences of keystrokes.
#endif
-#ifps
-.PP
-.B xdvi
-can show PostScript<tm> specials by any of three methods.
-It will try first to use Display PostScript<tm>, then NeWS, then it
-will try to use Ghostscript to render the images. All of these options
-depend on additional software to work properly; moreover, some of them
-may not be compiled into this copy of
-.BR xdvi .
-.PP
-For performance reasons,
-.B xdvi
-does not render PostScript specials in the magnifying glass.
-#endif
.SH OPTIONS
In addition to specifying the
.I dvi
@@ -173,23 +142,6 @@ Specifies the first page to show. If
.B +
is given without a number, the last page is assumed; the first page is
the default.
-#ifps
-.TP
-.B \-allowshell
-.RB ( .allowShell )
-This option enables the shell escape in PostScript specials.
-(For security reasons, shell escapes are disabled by default.)
-This option should be rarely used; in particular it should not be used just
-to uncompress files: that function is done automatically if the file name
-ends in
-.BR .Z ,
-.BR .gz ,
-or
-.BR .bz2 .
-Shell escapes are always turned off if the
-.B \-safer
-option is used.
-#endif
.TP
.BI \-altfont " font"
.RB ( .altFont )
@@ -332,36 +284,6 @@ keystroke.
.BI \-geometry " geometry"
.RB ( *geometry )
Specifies the initial geometry of the window.
-#ifghost
-.TP
-.BI \-gspalette " palette"
-.RB ( .palette )
-Specifies the palette to be used when using Ghostscript for rendering
-PostScript specials. Possible values are
-.BR Color ,
-.BR Greyscale ,
-and
-.BR Monochrome .
-The default is
-.BR Color .
-.TP
-.B \-gsalpha
-.RB ( .gsAlpha )
-Causes
-.B Ghostscript
-to be called with the
-.B x11alpha
-driver instead of the
-.B x11
-driver. The
-.B x11alpha
-driver enables anti-aliasing in PostScript figures, for a nicer appearance.
-It is available on newer versions of
-.BR Ghostscript .
-This option can also be toggled with the
-.RB ` V '
-keystroke.
-#endif
.TP
.BI \-hl " color"
.RB ( .highlight )
@@ -429,15 +351,6 @@ option. See also
.BR \-noinstall ,
and the GREYSCALING AND COLORMAPS section.
#endif
-#ifghost
-.TP
-.BI \-interpreter " filename"
-.RB ( .interpreter )
-Use
-.I filename
-as the Ghostscript interpreter. By default it uses
-.BR @GS_PATH@ .
-#endif
.TP
.B \-keep
.RB ( .keepPosition )
@@ -534,21 +447,6 @@ corresponds to
to
.BR color:on .)
#endif
-#ifdps
-.TP
-.B \-nodps
-.RB ( .dps )
-Inhibits the use of Display PostScript<tm> for displaying PostScript<tm>
-specials. Other forms of PostScript emulation, if installed, will be used
-instead.
-(For this option, the logic of the corresponding resource is reversed:
-.B \-nodps
-corresponds to
-.BR dps:off ;
-.B +nodps
-to
-.BR dps:on .)
-#endif
.TP
.B \-nofork
.RB ( .fork )
@@ -591,19 +489,6 @@ corresponds to
to
.BR freetypeFonts:on .)
#endif
-#ifghost
-.TP
-.B \-noghostscript
-.RB ( .ghostscript )
-Inhibits the use of Ghostscript for displaying PostScript<tm> specials.
-(For this option, the logic of the corresponding resource is reversed:
-.B \-noghostscript
-corresponds to
-.BR ghostscript:off ;
-.B +noghostscript
-to
-.BR ghostscript:on .)
-#endif
#ifgrey
.TP
.B \-nogrey
@@ -620,40 +505,6 @@ See also the
.RB ` G '
keystroke.
#endif
-#ifghost
-.TP
-.B \-nogssafer
-.RB ( .gsSafer )
-Normally, if Ghostscript is used to render PostScript specials, the Ghostscript
-interpreter is run with the option
-.BR \-dSAFER .
-The
-.B \-nogssafer
-option runs Ghostscript without
-.BR \-dSAFER .
-The
-.B \-dSAFER
-option in Ghostscript disables PostScript operators such as
-.BR deletefile ,
-to prevent possibly malicious PostScript programs from having any effect.
-It also prevents access to files whose paths reference the parent directory
-of the current directory (i.e., files whose paths contain the characters
-.RB `` ../ '');
-this is a feature of Ghostscript that cannot be overridden. If the
-.B \-safer
-option is specified, then this option has no effect; in that case Ghostscript
-is always run with
-.BR \-dSAFER .
-(For the
-.B \-nogssafer
-option, the logic of the corresponding resource is reversed:
-.B \-nogssafer
-corresponds to
-.BR gsSafer:off ;
-.B +nogssafer
-to
-.BR gsSafer:on .)
-#endif
#ifgrey
.TP
.B \-noinstall
@@ -683,20 +534,6 @@ corresponds to
to
.BR makePK:on .)
#endif
-#ifnews
-.TP
-.B \-nonews
-.RB ( .news )
-Inhibits the use of NeWS<tm> for displaying PostScript<tm> specials.
-Ghostscript, if enabled by the installation, will be used instead.
-(For this option, the logic of the corresponding resource is reversed:
-.B \-nonews
-corresponds to
-.BR news:off ;
-.B +news
-to
-.BR news:on .)
-#endif
#ifps
.TP
.B \-nopostscript
@@ -724,10 +561,6 @@ file, in order to process any
.B papersize
specials; this is especially important at startup since the paper size may be
needed to determine the window size.
-#ifps
-If PostScript<tm> is in use, then prescanning is also necessary in order to
-properly process header files.
-#fi
#ifcolor
In addition, prescanning is needed to correctly determine the background color
of a page.
@@ -854,21 +687,6 @@ This option turns on all available security options; it is designed for use when
is called by a browser that obtains a
.I dvi
or \*(Te\& file from another site.
-#ifps
-In the present case, this option selects
-#endif
-#ifghost
-.B +nogssafer
-and
-#endif
-#ifps
-.BR +allowshell .
-#endif
-#ifnops
-In the present case, this option is accepted but has no effect, since
-.B xdvi
-has been compiled without support for PostScript specials.
-#endif
#ifbuttons
.TP
.BI \-shrinkbutton "n shrink"
@@ -1198,34 +1016,6 @@ See also the
.B \-nocolor
option.
#endif
-#ifps
-.TP
-.B v
-#tool.RB [ set-ps() ]
-This key toggles the rendering of PostScript<tm> specials. If rendering
-is turned off, then bounding boxes are displayed when available.
-In addition the key sequences
-.RB ` 0v '
-and
-.RB ` 1v '
-clear and set this flag, respectively. See also the
-.B \-nopostscript
-option.
-#endif
-#ifghost
-.TP
-.B V
-#tool.RB [ set-gs-alpha() ]
-This key toggles the anti-aliasing of PostScript<tm> specials when
-.B Ghostscript
-is used as renderer. In addition the key sequences
-.RB ` 0V '
-and
-.RB ` 1V '
-clear and set this flag, respectively. See also the
-.B \-gsalpha
-option.
-#endif
.SH MOUSE ACTIONS
If the shrink factor is set to any number other than one, then clicking
any mouse button will pop up a ``magnifying glass'' which shows the unshrunk
@@ -2143,42 +1933,6 @@ signs, since
.B xdvi
interprets this as a special character, but other applications do not.
#endif
-#ifps
-.TP
-.SB XDVIPICTS
-Determines the path(s) searched for PostScript figure files.
-See the section on FILE SEARCHING for more details.
-.TP
-.SB TEXPICTS
-Determines the path(s) searched for PostScript figure files if
-.SB XDVIPICTS
-is not set.
-.TP
-.SB TEXINPUTS
-Determines the path(s) searched for PostScript figure files if neither
-.SB TEXPICTS
-nor
-.SB XDVIPICTS
-is set. Also determines the path(s) searched for source files if
-.SB XDVISOURCES
-is not set.
-.TP
-.SB XDVIHEADERS
-Determines the path(s) searched for PostScript header files.
-See the section on FILE SEARCHING for more details.
-.TP
-.SB TEXPSHEADERS
-Determines the path(s) searched for PostScript header files if
-.SB XDVIHEADERS
-is not set.
-.TP
-.SB PSHEADERS
-Determines the path(s) searched for PostScript header files if neither
-.SB XDVIHEADERS
-nor
-.SB TEXPSHEADERS
-is set.
-#endif
.TP
.SB XDVISOURCES
Determines the path(s) searched for source files when invoking the
@@ -2294,12 +2048,6 @@ or
.I pk
font file. See the section on CREATING FONT FILES for more details.
#endif
-#ifps
-.TP
-.SB TMPDIR
-The directory to use for storing temporary files created when uncompressing
-PostScript files.
-#endif
#ifextraappdef
.TP
.SB XDVIINPUTS
@@ -2871,84 +2619,6 @@ and the
.B Kpathsea
library.
#endif
-#ifps
-.SH SEARCHING FOR POSTSCRIPT FILES
-PostScript figure files and header files are searched for using a modification
-of the procedure used for font files.
-First, if the file name does not begin with a slash, then
-.B xdvi
-will look in the directory containing the
-.I dvi
-file. If it is not found there, then the
-.SB XDVIPICTS
-and
-.SB XDVIHEADERS
-environment variables determine the search strategy for PostScript
-figure files and header files, respectively. This is the same procedure as
-for font files, except that:
-(1)
-.RB `` %f ''
-and
-.RB `` %F ''
-refer to the file name, not the font name;
-(2)
-.RB `` %d '',
-.RB `` %b '',
-.RB `` %p '',
-and
-.RB `` %m ''
-are not substituted;
-(3)
-.RB `` %s ''
-is replaced by
-.RB `` {%qdvips//,%qtex//} ''
-for figure files or
-.RB `` %qdvips// ''
-for header files;
-(4) if no
-.RB `` %f ''
-appears in a specifier, then
-.RB `` /%f ''
-is added at the end; and finally
-(5) if the file name begins with a slash, then
-.RB `` %f ''
-replaces all the specifiers.
-Customarily,
-.SB XDVIPICTS
-will be the same as the \*(Te\& input directory.
-.PP
-There is an additional exception to the above strategy.
-If the file name begins with a backtick
-.RB ( ` ),
-then the remaining characters in the file name give a shell command (often
-.BR zcat )
-which is executed; its standard output is then sent to be interpreted as
-PostScript. Note that there is some potential for security problems here;
-see the
-.B \-allowshell
-command-line option. It is better to use compressed files directly (see below).
-.PP
-If a file name is given (as opposed to a shell command),
-if that file name ends in
-.RB `` .Z '',
-.RB `` .gz '',
-or
-.RB `` .bz2 '',
-and if the initial bytes of the file indicate that it was compressed with
-.BR compress (1),
-.BR gzip (1),
-or
-.BR bzip2 (1),
-respectively, then the file is first uncompressed with
-.BR "uncompress \-c" ,
-.BR "gunzip \-c" ,
-or
-.BR "bunzip2 \-c" ,
-respectively. This is preferred over using a backtick to call the command
-directly, since you do not have to specify
-.B \-allowshell
-and since it allows for path searching.
-#endif
#ifextraappdef
.SH X RESOURCES
It is often desirable to set X Window System resources from a file within the
@@ -3019,14 +2689,6 @@ But, see the caution below.
.SB VFFONTS
Search specifiers for virtual fonts.
#endif
-#ifconfigps
-.TP
-.SB TEXPICTS
-Search specifiers for PostScript figure files.
-.TP
-.SB PSHEADERS
-Search specifiers for PostScript header files.
-#endif
#ifconfig
.PP
The configuration file may also define other variables; these (as well as
@@ -3172,33 +2834,6 @@ or
etc., with extra colons at the end so that the values from configuration
files lower in the chain are also used.
#endif
-#ifps
-.SH LIMITATIONS
-.B xdvi
-accepts many but not all types of PostScript specials accepted by
-.BR dvips .
-For example, it accepts most specials generated by
-.B epsf
-and
-.BR psfig .
-It does not, however, support
-.B bop\-hook
-or
-.BR eop\-hook ,
-nor does it allow PostScript commands to affect the rendering of things that
-are not PostScript (for example, the ``NEAT'' and rotated ``A'' examples in the
-.B dvips
-manual, and the
-.B PSfrag
-package). These restrictions are due to the design of
-.BR xdvi ;
-in all likelihood they will always remain.
-.PP
-La\*(Te\&2e rotation specials are not currently supported.
-.PP
-.B MetaPost
-files containing included text are not supported.
-#endif
.SH FILES
.PD 0
#ifconfig
@@ -3208,12 +2843,6 @@ files containing included text are not supported.
.TP 40
@DEFAULT_FONT_PATH@ Font pixel files.
@DEFAULT_VF_PATH@ Virtual font files.
-#ifps
-.TP
-@DEFAULT_FIG_PATH@ Directories containing PostScript figures.
-.TP
-@DEFAULT_HEADER_PATH@ Directories containing PostScript header files.
-#endif
#ifft
.TP
@DEFAULT_DVIPS_CF_PATH@ Directories containing dvips configuration files.