gnu/usr.bin/groff/man/grodvi.man

   1 .\" -*- nroff -*-
   2 .ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
   3 .el .ds tx TeX
   4 .TH GRODVI @MAN1EXT@ "31 May 1990" "Groff Version @VERSION@"
   5 .SH NAME
   6 grodvi \- convert groff output to TeX dvi format
   7 .SH SYNOPSIS
   8 .B grodvi
   9 [
  10 .B \-dv
  11 ] [
  12 .BI \-w n
  13 ] [
  14 .BI \-F dir
  15 ] [
  16 .IR files \|.\|.\|.
  17 ]
  18 .SH DESCRIPTION
  19 .B grodvi
  20 is a driver for
  21 .B groff
  22 that produces \*(tx dvi format.
  23 Normally it should be run by
  24 .BR groff\ \-Tdvi .
  25 This will run
  26 .BR gtroff\ \-Tdvi ;
  27 it will also input the macros
  28 .BR @MACRODIR@/tmac.dvi ;
  29 if the input is being preprocessed with
  30 .B geqn
  31 it will also input
  32 .BR @FONTDIR@/devdvi/eqnchar .
  33 .LP
  34 The dvi file generated by
  35 .B grodvi
  36 can be printed by any correctly-written dvi driver.
  37 The troff drawing primitives are implemented
  38 using the tpic version 2 specials.
  39 If the driver does not support these, the
  40 .B \eD
  41 commands will not produce any output.
  42 .LP
  43 There is an additional drawing command available:
  44 .TP
  45 .BI \eD'R\  dh\ dv '
  46 Draw a rule (solid black rectangle), with one corner
  47 at the current position, and the diagonally opposite corner
  48 at the current position
  49 .RI +( dh , dv ).
  50 Afterwards the current position will be at the opposite corner.  This
  51 produces a rule in the dvi file and so can be printed even with a
  52 driver that does not support the tpic specials unlike the other
  53 .B \eD
  54 commands.
  55 .LP
  56 The groff command
  57 .BI \eX' anything '
  58 is translated into the same command in the dvi file as would be
  59 produced by
  60 .BI \especial{ anything }
  61 in \*(tx;
  62 .I anything may not contain a newline.
  63 .LP
  64 Font files for
  65 .B grodvi
  66 can be created from tfm files using
  67 .BR tfmtodit (@MAN1EXT@).
  68 The font description file should contain the following
  69 additional commands:
  70 .TP \w'\fBinternalname'u+2n
  71 .BI internalname\   name
  72 The name of the tfm file (without the
  73 .B .tfm
  74 extension) is
  75 .IR name .
  76 .TP
  77 .BI checksum\  n
  78 The checksum in the tfm file is
  79 .IR n .
  80 .TP
  81 .BI designsize\  n
  82 The designsize in the tfm file is
  83 .IR n .
  84 .LP
  85 These are automatically generated by
  86 .B tfmtodit.
  87 .LP
  88 In
  89 .B gtroff
  90 the
  91 .B \eN
  92 escape sequence can be used to access characters by their position
  93 in the corresponding tfm file;
  94 all characters in the tfm file can be accessed this way.
  95 .SH OPTIONS
  96 .TP
  97 .B \-d
  98 Do not use tpic specials to implement drawing commands.
  99 Horizontal and vertical lines will be implemented by rules.
 100 Other drawing commands will be ignored.
 101 .TP
 102 .B \-v
 103 Print the version number.
 104 .TP
 105 .BI \-w n
 106 Set the default line thickness to
 107 .I n
 108 thousandths of an em.
 109 .TP
 110 .BI \-F dir
 111 Search directory
 112 .IB dir /devdvi
 113 for font and device description files.
 114 .SH FILES
 115 .TP
 116 .B @FONTDIR@/devdvi/DESC
 117 Device desciption file.
 118 .TP
 119 .B @FONTDIR@/devdvi/ F
 120 Font description file for font
 121 .IR F .
 122 .TP
 123 .B @MACRODIR@/tmac.dvi
 124 Macros for use with
 125 .BR grodvi .
 126 .SH BUGS
 127 Dvi files produced by
 128 .B grodvi
 129 use a different resolution (57816 units per inch) to those produced by
 130 \*(tx.
 131 Incorrectly written drivers which assume the resolution used by \*(tx,
 132 rather than using the resolution specified in the dvi file will not
 133 work with grodvi.
 134 .LP
 135 When using the
 136 .B \-d
 137 option with boxed tables,
 138 vertical and horizontal lines can sometimes protrude by one pixel.
 139 This is a consequence of the way \*(tx requires that the heights
 140 and widths of rules be rounded.
 141 .SH "SEE ALSO"
 142 .BR tfmtodit (@MAN1EXT@),
 143 .BR groff (@MAN1EXT@),
 144 .BR gtroff (@MAN1EXT@),
 145 .BR groff_out (@MAN5EXT@),
 146 .BR groff_font (@MAN5EXT@)
 147 .br
 148 .I "Groff Character Names"