Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GRODVI(1)							     GRODVI(1)

NAME
       grodvi -	convert	groff output to	TeX dvi	format

SYNOPSIS
       grodvi [	-dv ] [	-wn ] [	-Fdir ]	[ files...  ]

DESCRIPTION
       grodvi is a driver for groff that produces TeX dvi format.  Normally it
       should be run by	groff -Tdvi.  This will	run troff -Tdvi; it will  also
       input  the  macros /usr/share/tmac/tmac.dvi; if the input is being pre-
       processed with eqn it will also input /usr/share/groff_font/devdvi/eqn-
       char.

       The  dvi	file generated by grodvi can be	printed	by any correctly-writ-
       ten dvi driver.	The troff drawing primitives are implemented using the
       tpic  version 2 specials.  If the driver	does not support these,	the \D
       commands	will not produce any output.

       There is	an additional drawing command available:

       \D'R dh dv'
	      Draw a rule (solid black rectangle), with	one corner at the cur-
	      rent position, and the diagonally	opposite corner	at the current
	      position +(dh,dv).  Afterwards the current position will	be  at
	      the  opposite  corner.  This produces a rule in the dvi file and
	      so can be	printed	even with a driver that	does not  support  the
	      tpic specials unlike the other \D	commands.

       The  groff  command \X'anything'	is translated into the same command in
       the dvi file as would be	produced by \special{anything}	in  TeX;  any-
       thing may not contain a newline.

       Font  files for grodvi can be created from tfm files using tfmtodit(1).
       The font	description file should	contain	the following additional  com-
       mands:

       internalname name
		     The  name of the tfm file (without	the .tfm extension) is
		     name.

       checksum	n    The checksum in the tfm file is n.

       designsize n  The designsize in the tfm file is n.

       These are automatically generated by tfmtodit.

       In troff	the \N escape sequence can be used  to	access	characters  by
       their position in the corresponding tfm file; all characters in the tfm
       file can	be accessed this way.

OPTIONS
       -d     Do not use tpic specials to implement drawing  commands.	 Hori-
	      zontal  and  vertical lines will be implemented by rules.	 Other
	      drawing commands will be ignored.

       -v     Print the	version	number.

       -wn    Set the default line thickness to	n thousandths of an em.

       -Fdir  Search directory dir/devdvi  for	font  and  device  description
	      files.

FILES
       /usr/share/groff_font/devdvi/DESC
	      Device description file.

       /usr/share/groff_font/devdvi/ F
	      Font description file for	font F.

       /usr/share/tmac/tmac.dvi
	      Macros for use with grodvi.

BUGS
       Dvi  files  produced  by	grodvi use a different resolution (57816 units
       per inch) to those produced by TeX.  Incorrectly	written	drivers	 which
       assume  the  resolution	used  by TeX, rather than using	the resolution
       specified in the	dvi file will not work with grodvi.

       When using the -d option	with boxed  tables,  vertical  and  horizontal
       lines  can  sometimes  protrude by one pixel.  This is a	consequence of
       the way TeX requires that the heights and widths	of rules be rounded.

SEE ALSO
       tfmtodit(1), groff(1), troff(1),	eqn(1),	 groff_out(5),	groff_font(5),
       groff_char(7)

Groff Version 1.09		15 January 1995			     GRODVI(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES | BUGS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=grodvi&sektion=1&manpath=FreeBSD+2.0.5-RELEASE>

home | help