Penguin
Recent Changes
Annotated edit history of grodvi(1) version 4, including all changes. View license author blame.
Rev Author # Line
1 perry 1 GRODVI
2 !!!GRODVI
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 FILES
8 BUGS
9 SEE ALSO
10 ----
11 !!NAME
12
13
14 grodvi - convert groff output to TeX dvi format
15 !!SYNOPSIS
16
17
18 __grodvi__ [[ __-dv__ ] [[ __-w__''n'' ] [[
19 __-F__''dir'' ] [[ ''files''... ]
20
21
22 It is possible to have whitespace between a command line
23 option and its parameter.
24 !!DESCRIPTION
25
26
27 __grodvi__ is a driver for __groff__ that produces TEX
28 dvi format. Normally it should be run by __groff -Tdvi__.
29 This will run __troff -Tdvi__; it will also input the
30 macros __/usr/share/groff/1.17.2/tmac/dvi.tmac__; if the
31 input is being preprocessed with __eqn__ it will also
32 input
33 __/usr/share/groff/1.17.2/font/devdvi/eqnchar__.
34
35
36 The dvi file generated by __grodvi__ can be printed by
37 any correctly-written dvi driver. The troff drawing
38 primitives are implemented using the tpic version 2
39 specials. If the driver does not support these, the __D__
40 commands will not produce any output.
41
42
43 There is an additional drawing command
44 available:
45
46
47 __D'R__ ''dh dv''__'__
48
49
50 Draw a rule (solid black rectangle), with one corner at the
51 current position, and the diagonally opposite corner at the
52 current position +(''dh'',''dv''). Afterwards the
53 current position will be at the opposite corner. This
54 produces a rule in the dvi file and so can be printed even
55 with a driver that does not support the tpic specials unlike
56 the other __D__ commands.
57
58
59 The groff command __X'__''anything''__'__ is
60 translated into the same command in the dvi file as would be
61 produced by __special{__''anything''__}__ in TEX;
62 ''anything may not contain a newline.''
63
64
65 Font files for __grodvi__ can be created from tfm files
66 using tfmtodit(1). The font description file should
67 contain the following additional commands:
68
69
70 __internalname__ ''name''
71
72
73 The name of the tfm file (without the __.tfm__ extension)
74 is ''name''.
75
76
77 __checksum__ ''n''
78
79
80 The checksum in the tfm file is ''n''.
81
82
83 __designsize__ ''n''
84
85
86 The designsize in the tfm file is ''n''.
87
88
89 These are automatically generated by
90 __tfmtodit.__
91
92
93 In __troff__ the __N__ escape sequence can be used to
94 access characters by their position in the corresponding tfm
95 file; all characters in the tfm file can be accessed this
96 way.
97 !!OPTIONS
98
99
100 __-d__
101
102
103 Do not use tpic specials to implement drawing commands.
104 Horizontal and vertical lines will be implemented by rules.
105 Other drawing commands will be ignored.
106
107
108 __-v__
109
110
111 Print the version number.
112
113
114 __-w__''n''
115
116
117 Set the default line thickness to ''n'' thousandths of an
118 em.
119
120
121 __-F__''dir''
122
123
124 Prepend directory ''dir''__/devdvi__ to the search
125 path for font and device description files.
126 !!FILES
127
128
129 __/usr/share/groff/1.17.2/font/devdvi/DESC__
130
131
132 Device description file.
133
134
135 __/usr/share/groff/1.17.2/font/devdvi/__''F''
136
137
138 Font description file for font ''F''.
139
140
141 __/usr/share/groff/1.17.2/tmac/dvi.tmac__
142
143
144 Macros for use with __grodvi__.
145 !!BUGS
146
147
148 Dvi files produced by __grodvi__ use a different
149 resolution (57816 units per inch) to those produced by TEX.
150 Incorrectly written drivers which assume the resolution used
151 by TEX, rather than using the resolution specified in the
152 dvi file will not work with __grodvi__.
153
154
155 When using the __-d__ option with boxed tables, vertical
156 and horizontal lines can sometimes protrude by one pixel.
157 This is a consequence of the way TEX requires that the
158 heights and widths of rules be rounded.
159 !!SEE ALSO
160
161
162 tfmtodit(1), groff(1), troff(1),
4 perry 163 groff_out(5), __groff_font__(5),
164 groff_char(7)
1 perry 165 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.