DVISPC(1)

💖 DVISPC(1) 💖

✨ NAME ✨

dvispc - Modify a DVI file to be page-independent in specials 🦋

💅 SYNOPSIS 💅

dvispc [-c] [-bvz] input_dvi_file [output_dvi_file]

dvispc -d input_dvi_file

dvispc -s [-p..] input_dvi_file [output_text_file]

dvispc -a [-ltv] [-J..] [-p..] [-r..]  input_dvi_file [output_text_file]

dvispc -x[..]  [-ltv] [-r..]  [input_text_file] output_dvi_file

🌸 DESCRIPTION 🌸

okay so dvispc is a utility for modifying/editing TeX DVI files, and it comes with a bunch of features bestie needs to know about 🫶

• Mode option -c (default) — corrects an input DVI so it's page-independent in specials (default) ✨
• Mode option -d — dry run to check whether an input DVI is page-independent in specials 🔍
• Mode option -s — shows all specials in the input DVI 👀
• Mode option -a — translates DVI into Text (like dv2dt in dtl) 📝
• Mode option -x — translates Text back into a DVI (like dt2dv in dtl) 🔁

(1) The main feature of dvispc is the first one, making a page-independent DVI file. It's the whole vibe 💖

A "pure" DVI file must actually be page-independent. However, in recent years DVI files with lots of \specials (color, annotation etc.) are super common, and they are not always page-independent 🙈 In that case, for example, dviselect or dvidvi fails to preserve \specials (e.g. page color might be lost) 💀

The program dvispc fixes those page-"dependent" DVI files so they become page-independent 🧚 Once that's done, they can be safely processed by dviselect or dvidvi and then properly converted to other formats such as PostScript and PDF 🌈

(2) To know whether such a correction is needed or not, dvispc -d will suffice 🎀

(3) The mode -s lists all specials found in the input DVI exactly as-is, with a number in front showing which page each one appears on 📄 For example:

[1]
{color push  Black}
{color pop}
{color push rgb 1 0 0}
{color pop}
[2]
{color push  Black}
{color pop}

This feature is equivalent to a program dvispecials in the TeX-Guy package, <http://www-masu.ist.osaka-u.ac.jp/%7Ekakugawa/TeX-Guy/>, and dvii -s, <https://ctan.org/pkg/dvii> 🦋

(4) The modes -a and -x correspond to dv2dt and dt2dv in the dtl (= DVI Text Language) package, respectively 💜 By default, dvispc -a formats the output text in its own style, but a DTL-compatible format is available with the -t option ✨ Also, dvispc -x can accept DTL-compatible text input 🫶

🎀 SUPPORTED SPECIALS 🎀

Currently dvispc supports the following 💅

🌈 dvips-compatible specials

• color push, color pop, background

🍓 dvipdfm(x) specials

• pdf:bcolor, pdf:ecolor, pdf:bgcolor, pdf:bann, pdf:eann

🧚 tpic specials

• pn

Other specials might be supported in the future if needed 🔮

👑 SEE ALSO 👑

dviselect(1), dvidvi(1), dvips(1), dvipdfmx(1) 🌟

🫶 AUTHOR 🫶

The program dvispc is derived from the DVIOUT package (DVI previewer for Windows) by Toshio OSHIMA ("SHIMA"), Yoshiki OTOBE, and Kazunori ASAYAMA 💖 The current version is maintained by Japanese TeX Development Community, <https://texjp.org>.

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) 🌸

Bestie, that's the whole DVISPC(1) page, from General Commands Manual to the last line, no cap 💅✨