commit c531ed8d9dc451241bf1569e8555bfaca2b70e11
parent 043cd9dd4dcc2208c2d618c7cb2d7ecbc29bd4b7
Author: Kyle Milz <krwmilz@gmail.com>
Date: Tue, 7 Sep 2021 18:55:48 +0000
remove features from manual
Diffstat:
| M | xdvi-man.sed | | | 496 | +------------------------------------------------------------------------------ |
1 file changed, 2 insertions(+), 494 deletions(-)
diff --git a/xdvi-man.sed b/xdvi-man.sed
@@ -62,9 +62,7 @@ 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]
-#iftool
[\fB\-dvipspath\fP \fIpath\fP]
-#endif
[\fB\-debug\fP \fIbitmask\fP] [\fB\-version\fP]
.I dvi_file
.hy
@@ -92,7 +90,6 @@ window while \*(Te\& is running should be avoided. This feature allows you
to preview many versions of the same file while running
.B xdvi
only once.
-#iftool
.PP
If
.B xdvi
@@ -101,7 +98,6 @@ is run without the
argument, then it pops up a window asking for a
.I dvi
file.
-#endif
.SH OPTIONS
In addition to specifying the
.I dvi
@@ -199,7 +195,6 @@ Specifies the host and screen to be used for displaying the
.I dvi
file. By default this is obtained from the environment variable
.SB DISPLAY.
-#iftool
.TP
.BI \-dvipspath " path"
.RB ( .dvipsPath )
@@ -209,7 +204,6 @@ as the
.B dvips
program to use when printing. By default it uses
.BR dvips .
-#endif
.TP
.BI \-editor " editor"
.RB ( .editor )
@@ -541,7 +535,7 @@ and
.BI \-p " pixels"
.RB ( .pixelsPerInch )
Defines the size of the fonts to use, in pixels per inch. The
-default value is @BDPI@. This option is provided only for backwards
+default value is 600. This option is provided only for backwards
compatibility; the preferred way of setting the font size is by setting the
Metafont mode at the same time; see the
.B \-mfmode
@@ -600,7 +594,7 @@ instead of vice versa.
.TP
.BI \-s " shrink"
.RB ( .shrinkFactor )
-Defines the initial shrink factor. The default value is @SHRINK@. If
+Defines the initial shrink factor. The default value is 3. If
.I shrink
is given as 0, then the initial shrink factor is computed so that the
page fits within the window (as if the `s' keystroke were given without
@@ -724,16 +718,6 @@ Also, the ``Home'', ``Prior'', ``Next'', and arrow cursor keys are synonyms for
and
.RB ` d '
keys, respectively.
-#iftool
-.PP
-The key assignments given here are those that
-.B xdvi
-assigns by default. They can be changed--see CUSTOMIZATION, below.
-The names appearing in brackets at the beginning of each of the following
-keystroke definitions is the name assigned to the action associated with
-that key, for use when customizing. Users who do not customize their
-keystrokes may ignore these labels.
-#
.TP
.B q
#tool.RB [ quit() ]
@@ -820,13 +804,6 @@ not move the image at all. For details on how the margins are used, see
the
.B \-margins
option.
-#iftool
-.TP
-.IB Control\- O
-.RB [ open-dvi-file() ]
-Pop up a window asking for a new
-.I dvi
-file.
.TP
.IB Control\- P
.RB [ print() ]
@@ -852,7 +829,6 @@ and
select and deselect, respectively, the option of keeping the window open after
.B dvips
finishes.
-#endif
.TP
.B s
#tool.RB [ set-shrink-factor() ]
@@ -967,7 +943,6 @@ take one parameter, giving the distance to scroll
the image. If the parameter contains a decimal point, the distance is given
in wheel units; otherwise, pixels. Not all wheel mice support horizontal
scrolling.
-#iftool
.SH UNBOUND ACTIONS
The following actions have not been assigned any keystroke, but are available
if customization is used.
@@ -1121,8 +1096,6 @@ where
.I n
is a positive integer without leading zeroes. Also, some limitations apply
to the action field.
-#
-#iftool
.SH CUSTOMIZATION EXAMPLES
.PP
Some users prefer that the window scroll smoothly when they hold down the
@@ -1171,7 +1144,6 @@ will cause the key
to quit
.BR xdvi .
This method also works with the other translation resources.
-#
.SH SPECIALS (GENERALLY)
Any of the specials used by
.B xdvi
@@ -1182,185 +1154,6 @@ Doing so does not change the behavior of the special under
but it causes other
.I dvi
viewers to ignore the special.
-.SH SOURCE SPECIALS
-With properly prepared
-.I dvi
-files,
-.B xdvi
-is capable of calling up an editor at the point in the file corresponding to
-any given point in the typeset output
-.RB (`` "reverse search" '').
-It can also be invoked so as to move to the place in the
-.I dvi
-file corresponding to a given line (and, optionally, column) in a given source
-file
-.RB (`` "forward search" '').
-Both of these capabilities require that the version of \*(Te\& used to
-produce the
-.I dvi
-file be compiled to support ``source specials,'' and that the
-.B \-src\-specials
-argument be used on the command line when running \*(Te\&.
-(Or, some special-purpose macro packages will also suffice for the above
-capabilities. In fact, column number information is not provided by any
-version of \*(Te\&; it must be provided by a macro package. This is because
-column information would make the
-.I dvi
-file too large; only special-purpose applications would benefit from it.)
-.P
-.B Reverse Search.
-Reverse search is done by moving the mouse to the desired position on the
-page displayed by
-.BR xdvi ,
-and pressing Button 1 while holding the Control button down.
-.P
-Each time this feature is used, a new copy of the editor is invoked.
-(The editor command can be a program such as
-.BR emacsclient ,
-however, which passes the information on to a running instance of an editor
-if possible.) The editor is specified by the
-.B \-editor
-command-line option, the
-.B .editor
-resource, or the
-.SB XEDITOR,
-.SB VISUAL,
-or
-.SB EDITOR
-environment variables; the first of these to specify a value determines the
-editor to call. If none of these are set, then the Unix editor
-.B vi
-is used. The value is a string called as a shell command, in which
-occurrences of the designator
-.RB `` %f ''
-are replaced by the file name, occurrences of
-.RB `` %l ''
-are replaced by the line number within the file, and (if supported)
-occurrences of
-.RB `` %c ''
-are replaced by the column number within the line. If no designator
-.RB `` %f ''
-occurs in the string, then
-.RB `` "+%l %f" ''
-is appended to the end of the string. If the string was found as the value
-of the
-.SB VISUAL
-or
-.SB EDITOR
-environment variables, then
-.RB `` "xterm -e "''
-is prepended to the string; if the editor is specified by other means, then
-it must be in the form of a shell command to pop up an X window with an
-editor in it.
-.P
-For debugging purposes, Ctrl-Button 2 will draw boxes around the first glyph
-or rule in a file occurring on source lines identified by source specials.
-In addition, Ctrl-Button 3 will draw similar boxes around all glyphs and rules
-in the file. These boxes are drawn in the color specified by the highlight
-color (the
-.B \-hl
-command-line option or the
-.B .highColor
-resource). In addition to glyphs and rules, certain PostScript specials also
-may be boxed (those providing a bounding box).
-.P
-The file to be edited is searched for first in the directory containing the
-.I dvi
-file, then in the path specified by the
-.SB XDVISOURCES
-or
-.SB TEXINPUTS
-environment variables.
-.P
-.B Forward search.
-Forward search is invoked on the command line (typically by a text editor),
-by specifying the
-.B \-sourceposition
-argument.
-.B xdvi
-The main dvi file
-.I dvi_file
-is specified as usual. ``Forward search'' means that xdvi will try to open
-the page in
-.I dvi_file
-corresponding to the given line number (and, optionally, column number)
-of the .tex source file
-.IR filename ,
-and highlight the place found by drawing a rectangle in the
-.I highlight
-color (see the
-.B \-hl
-option) around the corresponding text.
-.P
-In addition, the
-.B \-sourceposition
-option causes
-.B xdvi
-to run in client mode. ``Client mode'' means that if there is already
-another instance of
-.B xdvi
-running on this X display and displaying the same
-.IR dvi_file ,
-a new instance started with the
-.B -sourceposition
-option will only notify that running instance to perform the forward
-search, and exit after that. If no such instance of
-.B xdvi
-is found, then
-.B xdvi
-will start up a new instance in the background. Either way, when running
-in client mode,
-.B xdvi
-will always return immediately. This is set up so that other programs
-such as text editors may invoke
-.B xdvi
-in ``client mode'' to jump to a specific
-place in the
-.I dvi
-file corresponding to the current cursor position in the .tex file,
-and the user can continue editing without having to close the
-.B xdvi
-window first. (Note, however, that if the
-.B \-nofork
-argument is given on the command line, or the corresponding resource is
-set, then operation in client mode is a bit different in that
-.B xdvi
-will not run itself in the background if there is no instance already running.)
-.P
-The argument for
-.I filename
-should match the file name used for the source specials in the
-.I dvi
-file. The space before the
-.I filename
-is optional; it is only needed to avoid ambiguity if
-.I filename
-starts with a digit or a colon. Note that the argument needs to be enclosed
-in quotes if a space is used, to prevent the shell from
-misinterpreting the space as argument separator.
-.P
-Source specials in the
-.I dvi
-file must have one of the following formats:
-.RS 5
-.nf
-.sp 1n
- \fBsrc:\fP\fIline\fP[ ]\fIfilename\fP
- \fBsrc:\fP\fIline\fP\fB:\fP\fIcol\fP[ ]\fIfilename\fP
- \fBsrc:\fP\fIline\fP
- \fBsrc:\fP\fIline\fP\fB:\fP\fIcol\fP
- \fBsrc::\fP\fIcol\fP
-.sp 1n
-.fi
-.RE
-.PP
-If
-.I filename
-or
-.I line
-are omitted, the most recent values are used. The first source special on
-each page must be in one of the first two forms, so that defaults are not
-inherited across pages.
.SH PAPERSIZE SPECIALS
.B xdvi
accepts specials to set the paper size for the document. These specials
@@ -1618,18 +1411,6 @@ file.
.TP
.SB DISPLAY
Specifies which graphics display terminal to use.
-#ifconfig
-.TP
-.SB TEXMFCNF
-Indicates a (colon-separated) list of directories to search for files named
-.BR texmf.cnf ,
-which are to be interpreted as configuration files. An extra colon anywhere
-in the list incorporates the compiled-in default value at that point.
-See the section CONFIGURATION FILES for more details on configuration files,
-how
-.B xdvi
-searches for them, and what they should contain.
-#endif
.TP
.SB TEXMF
Indicates the top directory of \*(Te\& Directory Structure (TDS) trees to use
@@ -1738,11 +1519,6 @@ signs, since
interprets this as a special character, but other applications do not.
#endif
.TP
-.SB XDVISOURCES
-Determines the path(s) searched for source files when invoking the
-``source specials'' feature of
-.BR xdvi .
-.TP
.SB XDVIT1FONTS
Determines the path(s) searched for PostScript Type 1 fonts.
See the section on FILE SEARCHING for more details.
@@ -1809,35 +1585,6 @@ See the Ghostscript documentation for more details.
Determines the path(s) searched for Ghostscript-style Fontmap files if
.SB XDVI_GS_LIB
is not set.
-.TP
-.SB XEDITOR
-Determines the command to be executed to pop up the editor, if neither the
-.B \-editor
-command-line option nor the
-.B .editor
-resource are specified. See the section on SOURCE SPECIALS for details on
-the format.
-.TP
-.SB VISUAL
-Determines an editor to be popped up in an
-.B xterm
-window if neither
-.BR \-editor ,
-.BR .editor ,
-nor
-.SB XEDITOR
-is given.
-.TP
-.SB EDITOR
-Determines an editor to be popped up in an
-.B xterm
-window if neither
-.BR \-editor ,
-.BR .editor ,
-.SB XEDITOR,
-nor
-.SB VISUAL
-is given.
#ifmakepk
.TP
.SB XDVIMAKEPK
@@ -1850,13 +1597,6 @@ or
.I pk
font file. See the section on CREATING FONT FILES for more details.
#endif
-#ifextraappdef
-.TP
-.SB XDVIINPUTS
-Colon-separated list of paths to search for an extra
-.I app-defaults
-file.
-#endif
.SH FILE SEARCHING
In order to accommodate the wide variety of ways in which fonts are stored
on various sites,
@@ -1877,10 +1617,6 @@ is not set) contains a list of specifiers, separated by colons. An extra
colon anywhere in that list causes the compiled-in default value to be
substituted at that point. Or, if no such environment variable is used,
the compiled-in default is also used instead.
-#ifconfig
-(However, see the section on CONFIGURATION FILES to see how they change the
-situation concerning defaults.)
-#endif
.PP
In each specifier, the following substitutions are first made:
.TP
@@ -2064,7 +1800,6 @@ If the username does not exist, then the string is left unchanged.
When
.B xdvi
searches for a font, the first thing it does is to look for a
-#ifft
PostScript Type 1 font (unless Type 1 fonts have been turned off by the
.B \-nofreetypefonts
command-line argument or
@@ -2108,21 +1843,12 @@ If an entry for the font is not found in one of the dvips map files, then
it is assumed not to be available in Type 1 format, and
.B xdvi
will then search for a
-#endif
.I pk
or
.I gf
file, at the size required for the
.I dvi
file, using the strategy mentioned in the above subheading.
-#ifdosnames
-If that fails, it will try again, but for specifiers lacking a string
-.RB `` %f '',
-it will add the string
-.RB `` /dpi%d/%f.%p ''
-at the end (instead of
-.RB `` /%f.%d%p '').
-#endif
It will also try a slightly different size, in case of rounding errors.
.PP
If no such bitmap file is found, it then searches for a virtual font.
@@ -2419,226 +2145,8 @@ and the
.B Kpathsea
library.
#endif
-#ifextraappdef
-.SH X RESOURCES
-It is often desirable to set X Window System resources from a file within the
-.B texmf
-tree instead of within the X Window System directory hierarchy.
-For this reason,
-.B xdvi
-searches for a file named
-.RB `` XDvi ''
-in the main directory of all
-.B texmf
-trees, or in its subdirectories
-.B xdvi
-or
-.BR web2c .
-The search path for this file can be overridden by using the
-.SB XDVIINPUTS
-environment variable.
-#endif
-#ifconfig
-.SH CONFIGURATION FILES
-.B xdvi
-allows for any number of configuration files; these provide additional levels
-of defaults for file paths. For example, when searching for font pixel files,
-the hierarchy of defaults is as follows:
-.TP
-First
-The value of the
-.SB XDVIFONTS,
-.SB PKFONTS,
-.SB TEXPKS,
-or
-.SB TEXFONTS
-environment variable (if any).
-.TP
- .
-The value of
-.SB PKFONTS
-given in the first config file searched.
-.TP
- .
- ...
-.TP
- .
-The value of
-.SB PKFONTS
-given in the last config file searched.
-.TP
-Last
-The compiled-in default value.
-.PP
-The first of these in the list that is given is used; if an extra colon is
-present in that string, then the next in the list is used. Additional extra
-colons are ignored; if no extra colon is present, then the remainder of the
-list is ignored. Note that, unlike the situation with environment variables,
-only one name may be used in the config file. Additionally, if a config file
-defines a variable such as
-.SB PKFONTS
-more than once, only the first value is used.
-.PP
-Other special config file variables are:
-.TP 12
-.SB TEXMF
-Directories to substitute for
-.BR %t .
-But, see the caution below.
-.TP
-.SB VFFONTS
-Search specifiers for virtual fonts.
-#endif
-#ifconfig
-.PP
-The configuration file may also define other variables; these (as well as
-.SB PKFONTS
-and the other variables listed above) will be substituted whenever they are
-referred to, using either the syntax
-.BI $ variable\fR,\fP
-in which
-.I variable
-consists of the longest string consisting of letters, digits, and underscores
-following the dollar sign, or the syntax
-.BI ${ variable }\fR,\fP
-which is interpreted without matching the braces. These substitutions occur
-before brace expansions, which in turn occur before tilde expansions.
-Substitutions of this sort are global: only the first definition of a
-variable is used, even if there are multiple configuration files.
-This holds also when variables such as
-.SB PKFONTS
-are substituted via
-.B $PKFONTS
-instead of the hierarchy of defaults mentioned earlier.
-Also, an environment variable will override a corresponding configuration
-file variable. Undefined variables are replaced with the empty string.
-.PP
-.B Note:
-Some configuration files define a variable
-.SB TEXMF
-and access it via
-.BR $TEXMF .
-When using such files with
-.BR xdvi ,
-it may be necessary to avoid using
-.B %t
-and
-.B $S
-if the definition is incompatible with how that special symbol is used by
-.BR xdvi .
-For example,
-.B xdvi
-does not support brace expansion within
-.SB TEXMF
-when it is used in the context of
-.BR %t ,
-so if a configuration file defines
-.SB TEXMF
-as a string involving braces, then
-.B $TEXMF/%s
-should be used instead of
-.BR %S .
-#endif
-#ifselfauto
-.PP
-When starting up,
-.B xdvi
-will determine where its executable file is located, and will define three
-special configuration file variables based on that information.
-It defines
-.SB SELFAUTOLOC
-to be the directory containing the binary,
-.SB SELFAUTODIR
-to be the parent of that directory, and
-.SB SELFAUTOPARENT
-to be the parent of that directory. For example, if
-.B xdvi
-is in the executable file
-.BR /usr/local/tex/texmf/bin/sunos4/xdvi ,
-then the value of
-.SB SELFAUTOLOC
-will be
-.BR /usr/local/tex/texmf/bin/sunos4 ,
-.SB SELFAUTODIR
-will be
-.BR /usr/local/tex/texmf/bin ,
-and
-.SB SELFAUTOPARENT
-will be
-.BR /usr/local/tex/texmf .
-These three variables are special: they cannot be defined in a configuration
-file or in the environment.
-#endif
-#ifconfig
-.PP
-The syntax of configuration files is as follows. Blank lines, and lines
-in which the first non-white character is
-.B #
-or
-.BR % ,
-are assumed to be comment lines, and are ignored.
-All other lines must be of the form
-.IB variable = value\fR,\fP
-in which
-.I variable
-is either a variable name or a qualified variable name (discussed below), and
-.I value
-is the value to be assigned to the variable. A qualified variable name
-is a variable name, followed by a period and a string.
-A definition using a qualified variable name will be ignored, unless
-the string matches either of (a) the argument of the
-.B \-name
-command-line argument (or the filename part of the path of the executable
-file for
-.B xdvi
-(usually ``xdvi''), if no
-.B \-name
-option was used); or (b) the string ``XDvi'' (the
-.I class
-of
-.BR xdvi ).
-Since only the first definition of a variable will have any effect, an
-unqualified definition should be placed after all qualified definitions
-of that same variable.
-.PP
-There may be several configuration files. They are located as follows.
-Initially, an environment variable
-.SB TEXMFCNF
-is used; it should contain a colon-separated list of directories.
-All of those directories will be searched for files named
-.BR texmf.cnf ,
-and those files will all be read. Those files may also define variables
-.SB TEXMFCNF;
-if so, then those variables are taken to be colon-separated lists of
-directories. This defines the data structure of a tree; this tree is
-read in the obvious depth-first order. Duplicate directories are skipped
-in order to avoid infinite loops. Finally, an extra colon anywhere in any
-of these lists causes the compiled-in default to be substituted at that
-point. In addition, if
-.SB TEXMFCNF
-is not defined in the environment, then the search starts with the compiled-in
-default (it is expected that this will usually be the case).
-.PP
-If there are more than one
-.B texmf
-tree, then it is expected that each of them will have its own configuration
-file; the easiest way to combine them is to link them together in a chain
-(a vertical tree). The last file in the chain can be set up as if it were
-the only configuration file, and all others could contain a definition of
-.SB TEXMFCNF
-pointing to the directory of the next configuration file in the chain,
-and definitions for
-.SB TEXMF
-or
-.SB PKFONTS,
-etc., with extra colons at the end so that the values from configuration
-files lower in the chain are also used.
-#endif
.SH FILES
.PD 0
-#ifconfig
-@DEFAULT_CONFIG_PATH@ Directories to be searched for configuration files.
-#endif
@DEFAULT_TEXMF_PATH@ \*(Te\& Directory Structure (TDS) directories.
.TP 40
@DEFAULT_FONT_PATH@ Font pixel files.
