{
    "content": [
        {
            "type": "text",
            "text": "# dviselect(1) (man)\n\n**Summary:** dviselect - extract pages from DVI files\n\n**Synopsis:** dviselect [ -s ] [ -i infile ] [ -o outfile ] list of pages [ infile [ outfile ] ]\n\n## See Also\n\n- dviconcat(1)\n- latex(1)\n- tex(1)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **DESCRIPTION** (41 lines)\n- **AUTHOR** (2 lines)\n- **SEE ALSO** (4 lines)\n- **BUGS** (18 lines)\n\n## Full Content\n\n### NAME\n\ndviselect - extract pages from DVI files\n\n### SYNOPSIS\n\ndviselect [ -s ] [ -i infile ] [ -o outfile ] list of pages [ infile [ outfile ] ]\n\n### DESCRIPTION\n\nDviselect  selects  pages  from a DVI file produced by TeX, creating a new DVI file usable by\nany of the TeX conversion programs, or even by dviselect itself.\n\nA range is a string of the form even, odd, or first:last where both first and  last  are  op‐\ntional  numeric  strings,  with  negative numbers indicated by a leading underscore character\n``''.  If both first and last are omitted, the colon may also be omitted, or may be replaced\nwith  an  asterisk  ``*''.  A page range is a list of ranges separated by periods.  A list of\npages is described by a set of page ranges separated by commas and/or white space.\n\nDviselect actually looks at the ten count variables that  TeX  writes;  the  first  of  these\n(\\count0)  is  the  page number, with \\count1 through \\count9 having varied uses depending on\nwhich macro packages are in use.  (Typically \\count1 might be a chapter or  section  number.)\nA page is included in dviselect's output if all its \\count values match any one of the ranges\nlisted on the command line.  For example, the command ``dviselect *.1,35:'' might select  ev‐\nerything in chapter 1, as well as pages 35 and up.  ``dviselect 10:30'' would select pages 10\nthrough 30 (inclusive).  ``:43'' means everything up to and including page 43 (including neg‐\native-numbered pages).  To get all even-numbered pages, use ``even''; to get all odd-numbered\npages, use ``odd''.  If a Table of Contents has negative page numbers,  ``:1''  will  select\nit.   Note  that  ``*'' must be quoted from the shell; the empty string is more convenient to\nuse, if harder to read.\n\nInstead of \\count values, dviselect can also select by ``absolute page  number'',  where  the\nfirst  page  is page 1, the second page 2, and so forth.  Absolute page numbers are indicated\nby a leading equal sign ``=''.  Ranges of absolute pages are also allowed: ``dviselect =3:7''\nwill  extract  the  third  through  seventh  pages.  Dot separators are not legal in absolute\nranges, and there are no negative absolute page numbers.  Even/odd specifiers,  however,  are\nlegal; ``dviselect =even'' selects every other page, starting with the second.\n\nMore precisely, an asterisk or an empty string implies no limit; an equal sign means absolute\npage number rather than \\counts; a leading colon means everything up  to  and  including  the\ngiven page; a trailing colon means everything from the given page on; the word ``even'' means\nonly even values shall be accepted; the word ``odd'' means only odd values shall be accepted;\nand  a period indicates that the next \\count should be examined.  If fewer than 10 ranges are\nspecified, the remaining \\counts are left unrestricted (that is, ``1:5''  and  ``1:5.*''  are\nequivalent).   A single number n is treated as if it were the range n:n.  An arbitrary number\nof page selectors may be given, separated by commas or whitespace; a page is selected if  any\nof the selectors matches its \\counts or absolute page number.\n\nDviselect  normally  prints  the page numbers of the pages selected; the -s option suppresses\nthis.\n\n### AUTHOR\n\nChris Torek, University of Maryland\n\n### SEE ALSO\n\ndviconcat(1), latex(1), tex(1)\nMC-TeX User's Guide\nThe TeXbook\n\n### BUGS\n\nA leading ``-'' ought to be allowed for negative numbers, but it is currently used as a  syn‐\nonym for ``:'', for backwards compatibility.\n\nSection  or  subsection selection will sometimes fail, for the DVI file lists only the \\count\nvalues that were active when the page ended.  Clever macro packages  can  alleviate  this  by\nmaking  use of other ``free'' \\count registers.  Chapters normally begin on new pages, and do\nnot suffer from this particular problem.\n\nThe heuristic that decides which arguments are page selectors and which are file names is of‐\nten wrong.  Using shell redirection or the -i and -o options is safest.\n\nDviselect  does  not  adjust the parameters in the postamble; however, since these values are\nnormally used only to size certain structures in the output conversion programs, and the  pa‐\nrameters never need to be adjusted upward, this has not proven to be a problem.\n\n\n\nDVISELECT(1)\n\n"
        }
    ],
    "structuredContent": {
        "command": "dviselect",
        "section": "1",
        "mode": "man",
        "summary": "dviselect - extract pages from DVI files",
        "synopsis": "dviselect [ -s ] [ -i infile ] [ -o outfile ] list of pages [ infile [ outfile ] ]",
        "flags": [],
        "examples": [],
        "see_also": [
            {
                "name": "dviconcat",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/dviconcat/1/json"
            },
            {
                "name": "latex",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/latex/1/json"
            },
            {
                "name": "tex",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/tex/1/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 41,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "BUGS",
                "lines": 18,
                "subsections": []
            }
        ]
    }
}