6 .\" Like TP, but if specified indent is more than half
7 .\" the current line-length - indent, use the default indent.
9 .ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
12 .TH @G@GRN @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
14 @g@grn \- groff preprocessor for gremlin files
22 is a preprocessor for including
28 writes to standard output, processing only input lines between two that
33 Those lines must contain
36 These commands request a
38 file, and the picture in that file is
39 converted and placed in the
44 request may be followed by a C, L, or R to center, left, or right
47 picture (default justification is center).
50 is mentioned, the standard input is read.
51 At the end of the picture, the position on the page is the bottom of the
60 the position is left at the top of the picture.
62 Please note that currently only the \-me macro package has support for
68 The following command-line options are understood:
71 Prepare output for printer
77 for acceptable devices.
80 Set the library to directory
84 file cannot be found in the current directory,
86 is prepended to the filename for a second try.
87 The default library directory is
96 is the name of the device) for the
98 file before the normal
108 even when followed by a character other than space or newline.
111 This switch causes the picture to be traversed twice:
112 The first time, only the interiors of filled polygons (as borderless
113 polygons) are printed.
114 The second time, the outline is printed as a series of line segments.
115 This way, postprocessors that overwrite rather than merge picture elements
116 (such as Postscript) can still have text and graphics on a shaded
120 Print the version number.
122 Each input line between
129 Commands consist of one or two strings separated by white space, the first
130 string being the command and the second its operand.
131 Commands may be upper or lower case and abbreviated down to one character.
133 Commands that affect a picture's environment (those listed before
135 see below) are only in effect for the current picture:
136 The environment is reinitialized to the defaults at the start of the next
138 The commands are as follows:
149 text size number 1 (2, 3, or 4) to
152 The default is 12 (resp. 16, 24, and 36).
161 Set the roman (italics, bold, or special) font to
165 (either a name or number).
166 The default is R (resp. I, B, and S).
171 Set the stipple font to
178 may be abbreviated down as far as `st' (to avoid
183 default for stipples (unless one is set by the default command), and it is
186 picture with polygons without specifying a
192 Magnify the picture (in addition to any default magnification) by
194 a floating point number larger than zero.
197 may be abbreviated down to `sc'.
206 narrow (resp. medium and thick) lines to
211 The default is 1 (resp. 3 and 5), which corresponds to 0.15pt
212 (resp. 0.45pt and 0.75pt).
214 .BI pointscale\ <off/on>
215 Scale text to match the picture.
216 Gremlin text is usually printed in the point size specified with the
218 .BR 1 ,\ 2 ,\ 3 ,\ or\ 4
219 regardless of any scaling factors in the picture.
222 will cause the point sizes to scale with the picture (within
224 limitations, of course).
225 An operand of anything but
227 will turn text scaling on.
230 Reset the picture environment defaults to the settings in the current
232 This is meant to be used as a global parameter setting mechanism at the
235 input file, but can be used at any time to reset the
239 Forces the picture to be
242 This overrides any scaling factors present in the same picture.
250 inches high, overriding other scaling factors.
251 If both `width' and `height' are specified the tighter constraint will
252 determine the scale of the picture.
256 commands are not saved with a
259 They will, however, affect point size scaling if that option is set.
266 located the current directory (or in the library directory; see the
271 commands are given, the second one overrides the first.
274 doesn't exist, an error message is reported and processing continues from
278 .SH NOTES ABOUT GROFF
281 is a preprocessor, it doesn't know about current indents, point sizes,
282 margins, number registers, etc.
285 input can be placed between the
292 text is now processed by
294 so anything legal in a single line of
296 input is legal in a line of
298 text (barring `.' directives at the beginning of a line).
299 Thus, it is possible to have equations within a
301 figure by including in the
305 expressions enclosed by previously defined delimiters (e.g.
310 along with other preprocessors, it is best to run
320 should always be run last.
322 A picture is considered an entity, but that doesn't stop
324 from trying to break it up if it falls off the end of a page.
325 Placing the picture between `keeps' in \-me macros will ensure proper
339 to the width and height of the
341 figure (in device units) before entering the
343 request (this is for those who want to rewrite these macros).
345 .Tp \w'@FONTDIR@/devname/DESC'u+3n
346 .BI @FONTDIR@/dev name /DESC
347 Device description file for device
351 .BR groff (@MAN1EXT@),
356 David Slattengren and Barry Roitblat wrote the original Berkeley
359 Daniel Senderowicz and Werner Lemberg modified it for