{
    "mode": "info",
    "parameter": "GRODVI",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/info/GRODVI/json",
    "generated": "2026-07-05T23:46:29Z",
    "synopsis": "grodvi [-dl] [-F dir] [-p papersize] [-w n] [file ...]\ngrodvi --help\ngrodvi -v\ngrodvi --version",
    "sections": {
        "NAME": {
            "content": "grodvi - convert groff output to TeX DVI format\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "grodvi [-dl] [-F dir] [-p papersize] [-w n] [file ...]\n\ngrodvi --help\n\ngrodvi -v\ngrodvi --version\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "grodvi is a driver for groff that produces TeX DVI format.  Normally it\nshould be run by groff -Tdvi.  This will run troff -Tdvi; it will  also\ninput the macros in /usr/share/groff/1.22.4/tmac/dvi.tmac.\n\nThe  DVI file generated by grodvi can be printed by any correctly-writ-\nten DVI driver.  The troff drawing primitives are implemented using the\ntpic  version 2 specials.  If the driver does not support these, the \\D\ncommands will not produce any output.\n\nThere is an additional drawing command available:\n\n\\D'R dh dv'\nDraw a rule (solid black rectangle), with one corner at the cur-\nrent position, and the diagonally opposite corner at the current\nposition +(dh,dv).  Afterwards the current position will  be  at\nthe  opposite  corner.  This produces a rule in the DVI file and\nso can be printed even with a driver that does not  support  the\ntpic specials unlike the other \\D commands.\n\nThe  groff  command \\X'anything' is translated into the same command in\nthe DVI file as would be produced by \\special{anything}  in  TeX;  any-\nthing may not contain a newline.\n\nFor inclusion of EPS image files, -Tdvi loads pspic.tmac automatically,\nproviding the PSPIC macro.  Please check grofftmac(5) for  a  detailed\ndescription.\n\nFont  files for grodvi can be created from tfm files using tfmtodit(1).\nThe font description file should contain the following additional  com-\nmands:\n\ninternalname name\nThe name of the tfm file (without the .tfm extension) is name.\n\nchecksum n\nThe checksum in the tfm file is n.\n\ndesignsize n\nThe designsize in the tfm file is n.\n\nThese are automatically generated by tfmtodit.\n\nThe default color for \\m and \\M is black.  Currently, the drawing color\nfor \\D commands is always black, and fill color values  are  translated\nto gray.\n\nIn  troff  the  \\N  escape sequence can be used to access characters by\ntheir position in the corresponding tfm file; all characters in the tfm\nfile can be accessed this way.\n\nBy design, the DVI format doesn't care about physical dimensions of the\noutput medium.  Instead, grodvi emits the  equivalent  to  TeX's  \\spe-\ncial{papersize=width,length}  on  the  first  page; dvips (and possibly\nother DVI drivers) then sets the page size accordingly.  If either  the\npage width or length is not positive, no papersize special is output.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "Whitespace is permitted between a command-line option and its argument.\n\n-d     Do  not  use tpic specials to implement drawing commands.  Hori-\nzontal and vertical lines will be implemented by  rules.   Other\ndrawing commands will be ignored.\n\n-Fdir  Prepend  directory  dir/devname  to the search path for font and\ndevice description files; name is the name of the  device,  usu-\nally dvi.\n\n-l     Specify landscape orientation.\n",
            "subsections": [
                {
                    "name": "-ppapersize",
                    "content": "Specify  paper dimensions.  This overrides the papersize, paper-\nlength, and paperwidth commands in the DESC file; it accepts the\nsame  arguments  as the papersize command (see grofffont(5) for\ndetails).\n\n-v     Print the version number.\n\n-wn    Set the default line thickness to n thousandths of  an  em.   If\nthis  option  isn't  specified,  the  line thickness defaults to\n0.04 em.\n"
                }
            ]
        },
        "USAGE": {
            "content": "There are styles called R, I, B, and BI mounted  at  font  positions  1\nto 4.   The  fonts  are grouped into families T and H having members in\neach of these styles:\n\nTR     CM Roman (cmr10)\nTI     CM Text Italic (cmti10)\nTB     CM Bold Extended Roman (cmbx10)\nTBI    CM Bold Extended Text Italic (cmbxti10)\nHR     CM Sans Serif (cmss10)\nHI     CM Slanted Sans Serif (cmssi10)\nHB     CM Sans Serif Bold Extended (cmssbx10)\nHBI    CM Slanted Sans Serif Bold Extended (cmssbxo10)\n\nThere are also the following fonts which are not members of a family:\n\nCW     CM Typewriter Text (cmtt10)\nCWI    CM Italic Typewriter Text (cmitt10)\n\nSpecial fonts are MI (cmmi10), S (cmsy10), EX  (cmex10),  SC  (cmtex10,\nonly  for  CW),  and,  perhaps surprisingly, TR, TI, and CW, due to the\ndifferent font encodings of text fonts.  For italic fonts, CWI is  used\ninstead of CW.\n\nFinally,  the  symbol  fonts  of  the American Mathematical Society are\navailable as special fonts SA (msam10)  and  SB  (msbm10).   These  two\nfonts are not mounted by default.\n\nUsing  the  option  -mec (which loads the file ec.tmac) provides the EC\nand TC fonts.  The design of the EC family is very similar to  that  of\nthe  CM  fonts; additionally, they give a much better coverage of groff\nsymbols.  Note that ec.tmac must be called before any language-specific\nfiles; it doesn't take care of hcode values.\n",
            "subsections": []
        },
        "ENVIRONMENT": {
            "content": "GROFFFONTPATH\nA  list of directories in which to search for the devname direc-\ntory  in  addition  to  the  default  ones.   See  troff(1)  and\ngrofffont(5) for more details.\n",
            "subsections": []
        },
        "FILES": {
            "content": "/usr/share/groff/1.22.4/font/devdvi/DESC\nDevice description file.\n\n/usr/share/groff/1.22.4/font/devdvi/F\nFont description file for font F.\n\n/usr/share/groff/1.22.4/tmac/dvi.tmac\nMacros for use with grodvi.\n\n/usr/share/groff/1.22.4/tmac/ec.tmac\nMacros to switch to EC fonts.\n",
            "subsections": []
        },
        "BUGS": {
            "content": "Dvi  files  produced  by grodvi use a different resolution (57816 units\nper inch) from those produced  by  TeX.   Incorrectly  written  drivers\nwhich  assume the resolution used by TeX, rather than using the resolu-\ntion specified in the DVI file will not work with grodvi.\n\nWhen using the -d option with boxed  tables,  vertical  and  horizontal\nlines  can  sometimes  protrude by one pixel.  This is a consequence of\nthe way TeX requires that the heights and widths of rules be rounded.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "tfmtodit(1),   groff(1),   troff(1),    groffout(5),    grofffont(5),\ngroffchar(7), grofftmac(5)\n\ngroff 1.22.4                     23 March 2022                       GRODVI(1)",
            "subsections": []
        }
    },
    "summary": "grodvi - convert groff output to TeX DVI format",
    "flags": [
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "Specify paper dimensions. This overrides the papersize, paper- length, and paperwidth commands in the DESC file; it accepts the same arguments as the papersize command (see grofffont(5) for details). -v Print the version number. -wn Set the default line thickness to n thousandths of an em. If this option isn't specified, the line thickness defaults to 0.04 em."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "tfmtodit",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/tfmtodit/1/json"
        },
        {
            "name": "groff",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/groff/1/json"
        },
        {
            "name": "troff",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/troff/1/json"
        },
        {
            "name": "groffout",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/groffout/5/json"
        },
        {
            "name": "grofffont",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/grofffont/5/json"
        },
        {
            "name": "groffchar",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/groffchar/7/json"
        },
        {
            "name": "grofftmac",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/grofftmac/5/json"
        }
    ]
}