{ "content": [ { "type": "text", "text": "# dvi2tty(1) (man)\n\n**Summary:** dvi2tty - preview a TeX DVI file on an ordinary ASCII terminal\n\n**Synopsis:** dvi2tty [ options ] dvifile\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -o | — | — | Write output to file ``file''. |\n| -p | — | — | Print the pages chosen by list. Numbers refer to TeX page numbers (known as \\count0). An example of format for list is ` |\n| -P | — | — | Like -p except that page numbers refer to the sequential ordering of the pages in the dvi-file. Negative numbers don't m |\n| -w | — | — | the ability to display in 132 columns it might be a good idea to use -w132 and toggle the terminal into this mode as out |\n| -v | — | — | |\n| -q | — | — | pending on the whims of the person installing the program). |\n| -e | — | — | the number of spaces between words becomes less, with a positive value it becomes more. -e-11 seems to worked well. |\n| -f | — | — | piled in (often ``more''). This may be the default, but it is still okay to redirect output with ``>'', the pager will n |\n| -F | — | — | and the default pager. |\n| — | — | — | (e.g., ``-Fless''). |\n| -t | — | — | |\n| -a | — | — | characters are output without the accent sign. |\n| -l | — | — | with a form-feed character. |\n| -c | — | — | when running in tt-font. |\n| -u | — | — | supports latin1 characters. Note this may interfere with -s. Best not to use -u and -s together. |\n| -s | — | — | nals in Scandinavia are mapped to ``{|}[\\]''. Note this may interfere with -u. Best not to use -u and -s together. |\n| -J | — | — | |\n| -N | — | — | |\n| -A | — | — | |\n| -U | — | — | |\n| — | — | — | ShiftJIS, ISO-2022-JP, and UTF-8, respectively. |\n| — | — | — | Print the name of fonts when switching to it (and ending it). The delim argument is used to delimit the fontname. |\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **DESCRIPTION** (22 lines) — 23 subsections\n - Options: (1 lines)\n - -o file (2 lines)\n - -p list (5 lines)\n - -P list (3 lines)\n - -w (3 lines)\n - -v (1 lines)\n - -q (2 lines)\n - -e (3 lines)\n - -f (3 lines)\n - -F (2 lines)\n - -Fprog (2 lines)\n - -t (1 lines)\n - -a (2 lines)\n - -l (2 lines)\n - -c (2 lines)\n - -u (3 lines)\n - -s (3 lines)\n - -J (1 lines)\n - -N (1 lines)\n - -A (1 lines)\n - -U (1 lines)\n - -Eenc (2 lines)\n - -bdelim (3 lines)\n- **FILES** (2 lines)\n- **ENVIRONMENT** (3 lines)\n- **SEE ALSO** (2 lines)\n- **AUTHOR** (4 lines)\n- **BUGS** (8 lines)\n\n## Full Content\n\n### NAME\n\ndvi2tty - preview a TeX DVI file on an ordinary ASCII terminal\n\n### SYNOPSIS\n\ndvi2tty [ options ] dvifile\n\n### DESCRIPTION\n\ndvi2tty converts a TeX DVI file to a format that is appropriate for terminals and line print‐\ners. The program is intended to be used for preliminary proofreading of TeX-ed documents. By\ndefault the output is directed to the terminal, possibly through a pager (depending on how\nthe program was installed), but it can be directed to a file or a pipe.\n\nThe output leaves much to be desired, but is still useful if you want to avoid walking to the\nlaser printer (or whatever) for each iteration of your document.\nSince dvi2tty produces output for terminals and line printers the representation of documents\nis naturally quite primitive. In principle font changes are totally ignored, but dvi2tty\nrecognizes a few mathematical and special symbols that can be displayed on an ordinary ASCII\nterminal, such as the '+' and '-' symbol.\n\nIf the width of the output text requires more columns than fits in one line (cf. the -w op‐\ntion) it is broken into several lines by dvi2tty although they will be printed as one line on\nregular TeX output devices (e.g., laser printers). To show that a broken line is really just\none logical line an asterisk (``*'') in the last position means that the logical line is con‐\ntinued on the next physical line output by dvi2tty. Such a continuation line is started with\na space and an asterisk in the first two columns.\n\nOptions may be specified in the environment variable DVI2TTY. Any option on the command\nline, conflicting with one in the environment, will override the one from the environment.\n\n#### Options:\n\n#### -o file\n\nWrite output to file ``file''.\n\n#### -p list\n\nPrint the pages chosen by list. Numbers refer to TeX page numbers (known as \\count0).\nAn example of format for list is ``1,3:6,8'' to choose pages 1, 3 through 6 and 8.\nNegative numbers can be used exactly as in TeX, e.g., -1 comes before -4 as in\n``-p-1:-4,17''.\n\n#### -P list\n\nLike -p except that page numbers refer to the sequential ordering of the pages in the\ndvi-file. Negative numbers don't make a lot of sense here...\n\n#### -w\n\nthe ability to display in 132 columns it might be a good idea to use -w132 and toggle\nthe terminal into this mode as output will probably look somewhat better.\n\n#### -v\n\n#### -q\n\npending on the whims of the person installing the program).\n\n#### -e\n\nthe number of spaces between words becomes less, with a positive value it becomes\nmore. -e-11 seems to worked well.\n\n#### -f\n\npiled in (often ``more''). This may be the default, but it is still okay to redirect\noutput with ``>'', the pager will not be used if output is not going to a terminal.\n\n#### -F\n\nand the default pager.\n\n#### -Fprog\n\n(e.g., ``-Fless'').\n\n#### -t\n\n#### -a\n\ncharacters are output without the accent sign.\n\n#### -l\n\nwith a form-feed character.\n\n#### -c\n\nwhen running in tt-font.\n\n#### -u\n\nsupports latin1 characters. Note this may interfere with -s. Best not to use -u and\n-s together.\n\n#### -s\n\nnals in Scandinavia are mapped to ``{|}[\\]''. Note this may interfere with -u. Best\nnot to use -u and -s together.\n\n#### -J\n\n#### -N\n\n#### -A\n\n#### -U\n\n#### -Eenc\n\nShiftJIS, ISO-2022-JP, and UTF-8, respectively.\n\n#### -bdelim\n\nPrint the name of fonts when switching to it (and ending it). The delim argument is\nused to delimit the fontname.\n\n### FILES\n\n/bin/more probably the default pager.\n\n### ENVIRONMENT\n\nPAGER the pager to use.\nDVI2TTY can be set to hold command-line options.\n\n### SEE ALSO\n\nTeX, dvi2ps\n\n### AUTHOR\n\nOriginal Pascal version: Svante Lindahl, Royal Institute of Technology, Stockholm\nImproved C version: Marcel Mol, MESA Consulting\nNow maintained at https://github.com/t-tk/dvi2tty/releases.\n\n### BUGS\n\nBlanks between words get lost quite easily. This is less likely if you are using a wider out‐\nput than the default 80.\n\nOnly one file may be specified on the command line.\n\n\n\n4 March 2021 DVI2TTY(1)\n\n" } ], "structuredContent": { "command": "dvi2tty", "section": "1", "mode": "man", "summary": "dvi2tty - preview a TeX DVI file on an ordinary ASCII terminal", "synopsis": "dvi2tty [ options ] dvifile", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "-o", "long": null, "arg": null, "description": "Write output to file ``file''." }, { "flag": "-p", "long": null, "arg": null, "description": "Print the pages chosen by list. Numbers refer to TeX page numbers (known as \\count0). An example of format for list is ``1,3:6,8'' to choose pages 1, 3 through 6 and 8. Negative numbers can be used exactly as in TeX, e.g., -1 comes before -4 as in ``-p-1:-4,17''." }, { "flag": "-P", "long": null, "arg": null, "description": "Like -p except that page numbers refer to the sequential ordering of the pages in the dvi-file. Negative numbers don't make a lot of sense here..." }, { "flag": "-w", "long": null, "arg": null, "description": "the ability to display in 132 columns it might be a good idea to use -w132 and toggle the terminal into this mode as output will probably look somewhat better." }, { "flag": "-v", "long": null, "arg": null, "description": "" }, { "flag": "-q", "long": null, "arg": null, "description": "pending on the whims of the person installing the program)." }, { "flag": "-e", "long": null, "arg": null, "description": "the number of spaces between words becomes less, with a positive value it becomes more. -e-11 seems to worked well." }, { "flag": "-f", "long": null, "arg": null, "description": "piled in (often ``more''). This may be the default, but it is still okay to redirect output with ``>'', the pager will not be used if output is not going to a terminal." }, { "flag": "-F", "long": null, "arg": null, "description": "and the default pager." }, { "flag": "", "long": null, "arg": null, "description": "(e.g., ``-Fless'')." }, { "flag": "-t", "long": null, "arg": null, "description": "" }, { "flag": "-a", "long": null, "arg": null, "description": "characters are output without the accent sign." }, { "flag": "-l", "long": null, "arg": null, "description": "with a form-feed character." }, { "flag": "-c", "long": null, "arg": null, "description": "when running in tt-font." }, { "flag": "-u", "long": null, "arg": null, "description": "supports latin1 characters. Note this may interfere with -s. Best not to use -u and -s together." }, { "flag": "-s", "long": null, "arg": null, "description": "nals in Scandinavia are mapped to ``{|}[\\]''. Note this may interfere with -u. Best not to use -u and -s together." }, { "flag": "-J", "long": null, "arg": null, "description": "" }, { "flag": "-N", "long": null, "arg": null, "description": "" }, { "flag": "-A", "long": null, "arg": null, "description": "" }, { "flag": "-U", "long": null, "arg": null, "description": "" }, { "flag": "", "long": null, "arg": null, "description": "ShiftJIS, ISO-2022-JP, and UTF-8, respectively." }, { "flag": "", "long": null, "arg": null, "description": "Print the name of fonts when switching to it (and ending it). The delim argument is used to delimit the fontname." } ], "examples": [], "see_also": [], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 22, "subsections": [ { "name": "Options:", "lines": 1 }, { "name": "-o file", "lines": 2, "flag": "-o" }, { "name": "-p list", "lines": 5, "flag": "-p" }, { "name": "-P list", "lines": 3, "flag": "-P" }, { "name": "-w", "lines": 3, "flag": "-w" }, { "name": "-v", "lines": 1, "flag": "-v" }, { "name": "-q", "lines": 2, "flag": "-q" }, { "name": "-e", "lines": 3, "flag": "-e" }, { "name": "-f", "lines": 3, "flag": "-f" }, { "name": "-F", "lines": 2, "flag": "-F" }, { "name": "-Fprog", "lines": 2 }, { "name": "-t", "lines": 1, "flag": "-t" }, { "name": "-a", "lines": 2, "flag": "-a" }, { "name": "-l", "lines": 2, "flag": "-l" }, { "name": "-c", "lines": 2, "flag": "-c" }, { "name": "-u", "lines": 3, "flag": "-u" }, { "name": "-s", "lines": 3, "flag": "-s" }, { "name": "-J", "lines": 1, "flag": "-J" }, { "name": "-N", "lines": 1, "flag": "-N" }, { "name": "-A", "lines": 1, "flag": "-A" }, { "name": "-U", "lines": 1, "flag": "-U" }, { "name": "-Eenc", "lines": 2 }, { "name": "-bdelim", "lines": 3 } ] }, { "name": "FILES", "lines": 2, "subsections": [] }, { "name": "ENVIRONMENT", "lines": 3, "subsections": [] }, { "name": "SEE ALSO", "lines": 2, "subsections": [] }, { "name": "AUTHOR", "lines": 4, "subsections": [] }, { "name": "BUGS", "lines": 8, "subsections": [] } ] } }