summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/xdvi.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/xdvi.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/xdvi.1152
1 files changed, 106 insertions, 46 deletions
diff --git a/Master/texmf-dist/doc/man/man1/xdvi.1 b/Master/texmf-dist/doc/man/man1/xdvi.1
index 32933b9d63f..c20564df155 100644
--- a/Master/texmf-dist/doc/man/man1/xdvi.1
+++ b/Master/texmf-dist/doc/man/man1/xdvi.1
@@ -1,4 +1,4 @@
-.\" Copyright (c) 1990-2004 Paul Vojta and others
+.\" Copyright (c) 1990-2013 Paul Vojta and others
.\"
.\" This is Paul's license, included here only for reference, it does not apply
.\" to all parts of the k version.
@@ -52,7 +52,7 @@
.de SB
\&\fB\s-1\&\\$1 \\$2\s0\fR
..
-.TH XDVI 1 "2012-04-01" "Xdvik 22.85"
+.TH XDVI 1 "2013-04-04" "Xdvik 22.86"
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH NAME
@@ -118,7 +118,7 @@ xdvi \- DVI Previewer for the X Window System
[\fB\-nomatchinverted\fP]
[\fB\-noomega\fP]
[\fB\-noscan\fP]
-[\fB\-not1lib\fP]
+[\fB\-notype1fonts\fP]
[\fB\-notempfile\fP]
[\fB\-offsets\fP \fIdimen\fP]
[\fB\-p\fP \fIpixels\fP]
@@ -172,7 +172,7 @@ In addition to that, it supports the following features:
hyperlinks in DVI files (section HYPERLINKS),
.TP
-
-direct rendering of Postscript<tm> Type1 fonts (section T1LIB),
+direct rendering of PostScript<tm> Type 1 fonts (section TYPE 1 FONTS),
.TP
-
source specials in the DVI file (section SOURCE SPECIALS),
@@ -366,13 +366,13 @@ The individual numbers and strings have the following meanings:
512 paths Kpathsea path definitions
1024 expand Kpathsea path expansion
2048 search Kpathsea searching
- 4032 kpathsea All Kpathsea options
+ 4032 kpathsea All Kpathsea options
4096 htex Hypertex specials
- 8192 src Source specials
+ 8192 src Source specials
16384 client Client/server mode (see -unique
and -sourceposition options)
- 32768 t1 Type1 font library messages
- 65536 t1_verbose Verbose Type1 library messages
+ 32768 ft FreeType library messages (Type 1 fonts)
+ 65536 ft_verbose Verbose FreeType library messages (currently unused)
131072 gui GUI elements
.sp 1n
.fi
@@ -411,7 +411,7 @@ as the
program to use when printing. The default for this is
.BR dvips .
The program or script should read the DVI file from standard input,
-and write the Postscript file to standard output.
+and write the PostScript file to standard output.
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.TP
.BI \-editor " editor"
@@ -1121,20 +1121,21 @@ to
.BR prescan:on .)
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.TP
-.BI \-not1lib
-.RB ( .t1lib )
-This will disable the use of T1Lib to display PostScript<tm> fonts.
+.BI \-notype1fonts
+.RB ( .type1 )
+This will disable the use of the FreeType library to display PostScript<tm>
+Type 1 fonts.
Use this option as a workaround when you encounter problems with the
-display of T1Lib (but please don't forget to send a bug report in
+display of Type 1 fonts (but please don't forget to send a bug report in
this case, to the URL mentioned in the section AUTHORS below).
.br
(Note:
-.B \-not1lib
+.B \-notype1fonts
corresponds to
-.BR t1lib:off ;
-.B +not1lib
+.BR type1:off ;
+.B +notype1fonts
to
-.BR t1lib:on .)
+.BR type1:on .)
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.TP
.B \-notempfile
@@ -1320,8 +1321,8 @@ keystroke and the corresponding numerical prefix arguments 0, 1 and 2.
.RB ( .ps2pdfPath )
Use
.I path
-as a conversion program from Postscript to PDF. The program or script
-should accept two command-line arguments: The Postscript file as first
+as a conversion program from PostScript to PDF. The program or script
+should accept two command-line arguments: The PostScript file as first
argument, and the PDF output file as second argument.
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.TP
@@ -2179,7 +2180,7 @@ values; except for `px', they all correspond to \*(Te\&'s units:
.I sp
(scaled points, the unit used internally by \*(Te\&)
.I bp
-(big points or `Postscript points'),
+(big points or `PostScript points'),
.I cc
(cicero points),
.I dd
@@ -3094,17 +3095,17 @@ DVI file. You can save in one of the following formats:
.RS 2
.TP 2
-
-Postscript (uses
+PostScript (uses
.B dvips
-to convert the DVI file to a Postscript file, just like when printing
-to a Postscript file).
+to convert the DVI file to a PostScript file, just like when printing
+to a PostScript file).
.TP
-
PDF (first uses
.B dvips
-to convert the DVI file to a Postscript file, then uses
+to convert the DVI file to a PostScript file, then uses
.B ps2pdf
-to convert the Postscript file to PDF).
+to convert the PostScript file to PDF).
.TP
-
Plain text in ISO-8859-1 or UTF-8 encoding. The latter will preserve more
@@ -3116,7 +3117,7 @@ charset, it is replaced by `\e' followed by the hexadecimal character code.
If a character is not recognized at all, it is replaced by `?'.
.RE
.PP
-The programs for Postscript and PDF conversion can be customized via
+The programs for PostScript and PDF conversion can be customized via
the command line options or X resources
.BR -dvipspath / .dvipsPath
and
@@ -3484,7 +3485,7 @@ command-line option.
.B NOTE:
You should never use this option when viewing documents that you
didn't compile yourself. The backtick specials are not needed for
-uncompressing gzipped Postscript files, since
+uncompressing gzipped PostScript files, since
.B xdvi
can do that on the fly if the filename ends with
.I .eps.gz
@@ -3496,38 +3497,48 @@ approach, since the default file searching rules will apply to such
filenames too.
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH T1LIB
-Using T1Lib, a library written by Rainer Menzner
-(see ftp://sunsite.unc.edu/pub/Linux/libs/graphics/),
+.SH TYPE 1 FONTS
+Using FreeType (version 2),
.B xdvi
-can render Postscript<tm> Type1 fonts directly, without the
+can render PostScript<tm> Type 1 fonts directly, without the
route via \*(Te\& pixel (pk)
fonts. The advantage of this is that only one size of each font needs
to be stored on disk.
Unless the
-.B -not1lib
+.B -notype1fonts
option is used,
.B xdvi
-will try to render every font using T1Lib. Only as a fallback it will
+will try to render every font using FreeType. Only as a fallback will it
invoke an external program (like
.BR mktexpk ,
which in turn may invoke utilities like
.B ps2pk
or
.BR gsftopk )
-to generate a pixel font from the Type1 source. The direct rendering
+to generate a pixel font from the Type 1 source. The direct rendering
of the
.B Computer Modern
-fonts should work out-of-the box, whereas other Type1 fonts such as
-the 35 `standard' Postscript<tm> fonts resident in printers may need
-to be made accessible for use with xdvi, unless your system
+fonts should work out-of-the box, whereas other Type 1 fonts such as
+the 35 `standard' PostScript<tm> fonts resident in printers may need
+to be made accessible for use with
+.BR xdvi ,
+unless your system
administrator or TeX distribution has already done so (which is the case
-e.g. for current teTeX systems). The
+e.g. for current TeX Live systems). For the 35 PostScript<tm> resident
+fonts,
+.B xdvik
+will search using the
+.B Fontmap
+provided with
+.BR Ghostscript ,
+if necessary. Also, the
.B xdvik
distribution comes with a utility called
.B t1mapper
to make these fonts available for xdvi;
-see the manual page for t1mapper(1) for usage details.
+see the manual page for t1mapper(1) for usage details. This program is
+likely to be dropped in the future, however, since it is probably not
+needed anymore.
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH SPECIALS (GENERALLY)
@@ -3935,6 +3946,48 @@ for more details on the
.B BROWSER
environment variable.
.RE
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.TP
+.SB GS_LIB
+A colon-separated list of directories to search for
+.B Fontmap
+files, etc., as used for Ghostscript. It has the same meaning as it does
+when running Ghostscript. In
+.BR xdvik ,
+it is used when searching for font files when the map file does not give a
+file name for the font (this should be quite rare). The command
+.B gs \-h
+will list the default value that Ghostscript uses. See also the
+.SB XDVI_GS_LIB
+environment variable (below).
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.TP
+.SB XDVI_GS_LIB
+This has the same effect as
+.SB GS_LIB
+but affects only
+.BR xdvi .
+Use this when you want to use a different value for
+.SB GS_LIB
+when running
+.BR xdvi ,
+but use either the compiled-in default value or some other value when running
+Ghostscript. If both
+.SB GS_LIB
+and
+.SB XDVI_GS_LIB
+are set, then
+.B xdvi
+uses
+.SB XDVI_GS_LIB.
+To use the default value compiled in to
+.B xdvi
+while still retaining the ability to set
+.SB GS_LIB
+for use with Ghostscript, you can set
+.SB XDVI_GS_LIB
+to the empty string.
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.TP
.SB TMPDIR
The directory to use for storing temporary files created when uncompressing
@@ -4028,13 +4081,20 @@ option is used or the
.B noInitFile
X resource is set.
.TP
-.SB xdvi.cfg
-A configuration file for the T1 font setup which needs to be supplied
-in the directory determined by the
-.B XDVIINPUTS
-environment variable. Please see the file
-.B http://xdvi.sourceforge.net/README.t1fonts
-if that file is missing.
+.SB config.xdvi
+An optional configuration file for the Type 1 font setup, which specifies
+.BR dvips \-style
+map files specific to
+.BR xdvik .
+If used, it should be present in the directory determined by the
+.B TEXCONFIG
+environment variable. Its format is similar to configuration files for
+.BR dvips ,
+except that it is only scanned for the names of map files
+.RB ( p
+and
+.B p+
+directives).
.SH SEE ALSO
.BR X (1),
.BR dvips (1),