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