{
    "content": [
        {
            "type": "text",
            "text": "# dvispc(1) (man)\n\n## NAME\n\ndvispc - Modify a DVI file to be page-independent in specials\n\n## SYNOPSIS\n\ndvispc [-c] [-bvz] inputdvifile [outputdvifile]\ndvispc -d inputdvifile\ndvispc -s [-p..] inputdvifile [outputtextfile]\ndvispc -a [-ltv] [-J..] [-p..] [-r..]  inputdvifile [outputtextfile]\ndvispc -x[..]  [-ltv] [-r..]  [inputtextfile] outputdvifile\n\n## DESCRIPTION\n\nDvispc is a utility to modify/edit TeX DVI file with the following features:\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **SUPPORTED SPECIALS**\n- **SEE ALSO**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "dvispc",
        "section": "1",
        "mode": "man",
        "summary": "dvispc - Modify a DVI file to be page-independent in specials",
        "synopsis": "dvispc [-c] [-bvz] inputdvifile [outputdvifile]\ndvispc -d inputdvifile\ndvispc -s [-p..] inputdvifile [outputtextfile]\ndvispc -a [-ltv] [-J..] [-p..] [-r..]  inputdvifile [outputtextfile]\ndvispc -x[..]  [-ltv] [-r..]  [inputtextfile] outputdvifile",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [
            {
                "name": "dviselect",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/dviselect/1/json"
            },
            {
                "name": "dvidvi",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/dvidvi/1/json"
            },
            {
                "name": "dvips",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/dvips/1/json"
            },
            {
                "name": "dvipdfmx",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/dvipdfmx/1/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 10,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 49,
                "subsections": []
            },
            {
                "name": "SUPPORTED SPECIALS",
                "lines": 11,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 10,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "dvispc - Modify a DVI file to be page-independent in specials\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "dvispc [-c] [-bvz] inputdvifile [outputdvifile]\n\ndvispc -d inputdvifile\n\ndvispc -s [-p..] inputdvifile [outputtextfile]\n\ndvispc -a [-ltv] [-J..] [-p..] [-r..]  inputdvifile [outputtextfile]\n\ndvispc -x[..]  [-ltv] [-r..]  [inputtextfile] outputdvifile\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "Dvispc is a utility to modify/edit TeX DVI file with the following features:\n\nMode option -c (default):\ncorrect an input DVI to be page-independent in specials (default)\n\nMode option -d:\ndry run to check if an input DVI is page-independent in specials\n\nMode option -s:\nshow all specials in the input DVI\n\nMode option -a:\ntranslate DVI into a Text (like dv2dt in dtl)\n\nMode option -x:\ntranslate Text into a DVI (like dt2dv in dtl)\n\n(1) The main feature of dvispc is the first one, to make a page-independent DVI file.\n\nA \"pure\" DVI file must be actually page-independent.  However in recent years, DVI files with\nlots of \\special's (color, annotation etc.) are commonly used, and they are not always  page-\nindependent.  In  such  case,  for  example, dviselect or dvidvi fails to preserve \\special's\n(e.g. page color might be lost).\n\nThe program dvispc corrects such page-\"dependent\" DVI files to be page-independent, which can\nbe  safely processed by dviselect or dvidvi and then properly converted to other formats such\nas PostScript and PDF.\n\n(2) To know whether such a correction is needed or not, dvispc -d will suffice.\n\n(3) The mode -s lists all specials found in the input DVI  as-is,  with  a  preceding  number\nwhich denotes the page where it appears.  For example,\n\n[1]\n{color push  Black}\n{color pop}\n{color push rgb 1 0 0}\n{color pop}\n[2]\n{color push  Black}\n{color pop}\n\nThis  feature  is  equivalent  to  a  program  dvispecials  in  TeX-Guy  package <http://www-\nmasu.ist.osaka-u.ac.jp/%7Ekakugawa/TeX-Guy/> and dvii -s <https://ctan.org/pkg/dvii>.\n\n(4) The mode -a and -x correspond to dv2dt and dt2dv in the dtl (= DVI Text Language) package\nrespectively. By default dvispc -a formats the output text in its own style, but DTL-compati‐\nble format is available with -t option. Also, dvispc -x can accept DTL-compatible text input.\n",
                "subsections": []
            },
            "SUPPORTED SPECIALS": {
                "content": "Currently dvispc supports the followings:\n\ndvips-compatible specials\ncolor push, color pop, background\ndvipdfm(x) specials\npdf:bcolor, pdf:ecolor, pdf:bgcolor, pdf:bann, pdf:eann\ntpic specials:\npn\n\nOther specials might be supported in the future if needed.\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "dviselect(1), dvidvi(1), dvips(1), dvipdfmx(1)\n",
                "subsections": []
            },
            "AUTHOR": {
                "content": "The program dvispc is derived from the DVIOUT package (DVI previewer for Windows)  by  Toshio\nOSHIMA  (\"SHIMA\"), Yoshiki OTOBE, and Kazunori ASAYAMA.  Current version is maintained by Ja‐\npanese TeX Development Community <https://texjp.org>.\nFor more information, please refer to dvispc-en.txt (in English) and dvispc-ja.txt (in  Japa‐\nnese)   on   our   GitHub   repository,   <https://github.com/texjporg/tex-jp-build>   (under\nsource/texk/dviout-util directory).\n\n\n\nDVISPC(1)",
                "subsections": []
            }
        }
    }
}