Debian Codegraph @

texmf-dist/doc/man/man1/dvispc.1

raw
1 .TH DVISPC 1
2 \"=====================================================================
3 .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
4 .if n .ds TX TeX
5 .\" LX definition must follow TX so LX can use TX
6 .if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
7 .if n .ds LX LaTeX
8 \"=====================================================================
9 .SH NAME
10 dvispc \- Modify a DVI file to be page-independent in specials
11 .SH SYNOPSIS
12 .B dvispc
13 [\fB\-c\fR] [\fB\-bvz\fR]
14 \fIinput_dvi_file\fR [\fIoutput_dvi_file\fR]
15 .PP
16 .B dvispc \-d
17 \fIinput_dvi_file\fR
18 .PP
19 .B dvispc \-s
20 [\fB\-p..\fR] \fIinput_dvi_file\fR [\fIoutput_text_file\fR]
21 .PP
22 .B dvispc \-a
23 [\fB\-ltv\fR] [\fB\-J..\fR] [\fB\-p..\fR] [\fB\-r..\fR]
24 \fIinput_dvi_file\fR [\fIoutput_text_file\fR]
25 .PP
26 .B dvispc \-x[..]
27 [\fB\-ltv\fR] [\fB\-r..\fR]
28 [\fIinput_text_file\fR] \fIoutput_dvi_file\fR
29 .SH DESCRIPTION
30 .B Dvispc
31 is a utility to modify/edit \*(TX DVI file with the following features:
32 .PP
33 Mode option \fB\-c\fR (default):
34 correct an input DVI to be page-independent in specials (default)
35 .PP
36 Mode option \fB\-d\fR:
37 dry run to check if an input DVI is page-independent in specials
38 .PP
39 Mode option \fB\-s\fR:
40 show all specials in the input DVI
41 .PP
42 Mode option \fB\-a\fR:
43 translate DVI into a Text (like \fBdv2dt\fR in dtl)
44 .PP
45 Mode option \fB\-x\fR:
46 translate Text into a DVI (like \fBdt2dv\fR in dtl)
47 .PP
48 (1) The \fImain\fR feature of
49 .B dvispc
50 is the first one, to make a page-independent DVI file.
51 .PP
52 A "pure" DVI file must be actually page-independent.
53 However in recent years, DVI files with lots of \\special's (color,
54 annotation etc.) are commonly used, and they are not always
55 page-independent. In such case, for example,
56 .B dviselect
57 or
58 .B dvidvi
59 fails to preserve \\special's (e.g. page color might be lost).
60 .PP
61 The program
62 .B dvispc
63 corrects such page-"dependent" DVI files to be page-independent,
64 which can be safely processed by
65 .B dviselect
66 or
67 .B dvidvi
68 and then properly converted to other formats such as PostScript and PDF.
69 .PP
70 (2) To know whether such a correction is needed or not,
71 .B dvispc \-d
72 will suffice.
73 .PP
74 (3) The mode \fB\-s\fR lists all specials found in the input DVI as-is,
75 with a preceding number which denotes the page where it appears.
76 For example,
77 .PP
78 .RS
79 [1]
80 .br
81 {color push Black}
82 .br
83 {color pop}
84 .br
85 {color push rgb 1 0 0}
86 .br
87 {color pop}
88 .br
89 [2]
90 .br
91 {color push Black}
92 .br
93 {color pop}
94 .RE
95 .LP
96 This feature is equivalent to a program
97 .B dvispecials
98 in TeX-Guy package
99 <http://www-masu.ist.osaka-u.ac.jp/%7Ekakugawa/TeX-Guy/>
100 and
101 .B dvii \-s
102 <https://ctan.org/pkg/dvii>.
103 .PP
104 (4) The mode \fB-a\fR and \fB-x\fR correspond to
105 .B dv2dt
106 and
107 .B dt2dv
108 in the dtl (= DVI Text Language) package respectively. By default
109 .B dvispc \-a
110 formats the output text in its own style, but DTL-compatible
111 format is available with
112 .B \-t
113 option. Also,
114 .B dvispc \-x
115 can accept DTL-compatible text input.
116 .SH SUPPORTED SPECIALS
117 Currently
118 .B dvispc
119 supports the followings:
120 .PP
121 dvips-compatible specials
122 color push, color pop, background
123 dvipdfm(x) specials
124 pdf:bcolor, pdf:ecolor, pdf:bgcolor, pdf:bann, pdf:eann
125 tpic specials:
126 pn
127 .PP
128 Other specials might be supported in the future if needed.
129 .SH SEE ALSO
130 dviselect(1), dvidvi(1), dvips(1), dvipdfmx(1)
131 .SH AUTHOR
132 The program
133 .B dvispc
134 is derived from the DVIOUT package (DVI previewer for Windows)
135 by Toshio OSHIMA ("SHIMA"), Yoshiki OTOBE, and Kazunori ASAYAMA.
136 Current version is maintained by Japanese \*(TX Development Community
137 <https://texjp.org>.
138 .br
139 For more information, please refer to
140 dvispc-en.txt (in English) and dvispc-ja.txt (in Japanese)
141 on our GitHub repository, <https://github.com/texjporg/tex-jp-build>
142 (under source/texk/dviout-util directory).