Debian Codegraph @

upstream/mageia-cauldron/man5/groff_out.5

raw
1 .TH groff_out 5 "2 July 2023" "groff 1.23.0"
2 .SH Name
3 groff_out \- GNU
4 .I roff
5 intermediate output format
6 .
7 .
8 .\" XXX: This page needs review and editing.
9 .\" ====================================================================
10 .\" Legal Terms
11 .\" ====================================================================
12 .\"
13 .\" Copyright (C) 1989-2023 Free Software Foundation, Inc.
14 .\"
15 .\" This file is part of groff, the GNU roff type-setting system.
16 .\"
17 .\" Permission is granted to copy, distribute and/or modify this
18 .\" document under the terms of the GNU Free Documentation License,
19 .\" Version 1.3 or any later version published by the Free Software
20 .\" Foundation; with no Invariant Sections, with no Front-Cover Texts,
21 .\" and with no Back-Cover Texts.
22 .\"
23 .\" A copy of the Free Documentation License is included as a file
24 .\" called FDL in the main directory of the groff source package.
25 .
26 .
27 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
28 .do nr *groff_groff_out_5_man_C \n[.cp]
29 .cp 0
30 .
31 .\" Define fallback for groff 1.23's MR macro if the system lacks it.
32 .nr do-fallback 0
33 .if !\n(.f .nr do-fallback 1 \" mandoc
34 .if \n(.g .if !d MR .nr do-fallback 1 \" older groff
35 .if !\n(.g .nr do-fallback 1 \" non-groff *roff
36 .if \n[do-fallback] \{\
37 . de MR
38 . ie \\n(.$=1 \
39 . I \%\\$1
40 . el \
41 . IR \%\\$1 (\\$2)\\$3
42 . .
43 .\}
44 .rr do-fallback
45 .
46 .
47 .\" ====================================================================
48 .\" Setup
49 .\" ====================================================================
50 .
51 .\" ================= Document configuration
52 .
53 .\" Number register to decide whether the commands '{' and '}' are used
54 .\" 0: disable (current default); 1: enable
55 .nr @USE_ENV_STACK 0
56 .
57 .ig
58 Unfortunately, old versions of groff used an illogical position change
59 after some D\~commands (Dp, DP, Dt). If the register
60 @STUPID_DRAWING_POSITIONING is 1 (current default) then change position
61 after these commands, otherwise the position is not changed.
62 ..
63 .nr @STUPID_DRAWING_POSITIONING 1
64 .
65 .\" ================= Semantical definitions
66 .
67 .nr @maxcolor 65536
68 .ds @backslash \[rs]\"
69 .ds @linebreak \fR\[la]line-break\[ra]\fP\"
70 .
71 .\" Begin of macro definitions
72 .
73 .de offset
74 .RI ( \,\\$1\/ ,\ \,\\$2\/ )\\$3
75 ..
76 .de indexed_offset
77 .offset \fI\\$1\/\fP\d\s-3\\$2\s+3\u\x'\n[.v]/4' \fI\\$3\/\fP\
78 \d\s-3\\$4\s+3\u\x'\n[.v]/4' \\$5\x'\n[.v]/4'
79 ..
80 .\" format: .command <name> "<arguments>" <punctuation>
81 .de command
82 \fB\\$1\fP\ \fI\,\\$2\/\fP\\$3
83 ..
84 .\" format: .D-command <subcommand> "<arguments>"
85 .de D-command
86 \fBD\\$1\fP\ \fI\,\\$2\/\fP\|\*[@linebreak]
87 ..
88 .
89 .\" We set these as troff micromotions rather than eqn because \d and \u
90 .\" can be lifted to XML subscript/superscript tags. Don't change
91 .\" these to a parameterized string, man2html won't handle that.
92 .ds hv1 \fIh\d\s-3\&1\s+3\u\~v\d\s-3\&1\s+3\u\fP\x'\n[.v]/4'
93 .ds hv2 \fIh\d\s-3\&2\s+3\u\~v\d\s-3\&2\s+3\u\fP\x'\n[.v]/4'
94 .ds hvn \fIh\d\s-3\&n\s+3\u\~v\d\s-3\&n\s+3\u\fP\x'\n[.v]/4'
95 .
96 .de Da-command
97 \fBDa\fP\ \*[hv1] \*[hv2]\|\*[@linebreak]
98 ..
99 .\" graphics command .D with a variable number of arguments
100 .\" format: .D-multiarg <subcommand>
101 .de D-multiarg
102 \fBD\\$1\fP\ \*[hv1] \*[hv2] \&.\|.\|.\& \*[hvn]\|\*[@linebreak]
103 ..
104 .\" format: .x-command <subname> "<arguments>"
105 .de x-command
106 \fBx\\$1\fP\ \fI\\$2\fP\|\*[@linebreak]
107 ..
108 .de xsub
109 .RI "(" "\\$1" " control command)"
110 .br
111 ..
112 .\" End of macro definitions
113 .
114 .
115 .\" ====================================================================
116 .SH Description
117 .\" ====================================================================
118 .
119 The fundamental operation of the
120 .MR \%troff 1
121 formatter is the translation of the
122 .MR groff 7
123 input language into a series of instructions concerned primarily with
124 placing glyphs or geometric objects at specific positions on a
125 rectangular page.
126 .
127 In the following discussion,
128 the term
129 .I command
130 refers to this intermediate output language,
131 never to the
132 .MR groff 7
133 language intended for use by document authors.
134 .
135 Intermediate output commands comprise several categories:
136 glyph output;
137 font,
138 color,
139 and text size selection;
140 motion of the printing position;
141 page advancement;
142 drawing of geometric primitives;
143 and device control commands,
144 a catch-all for other operations.
145 .
146 The last includes directives to start and stop output,
147 identify the intended output device,
148 and embed URL hyperlinks in supported output formats.
149 .
150 .
151 .P
152 Because the front-end command
153 .MR groff 1
154 is a wrapper that normally runs the
155 .I \%troff
156 formatter to generate intermediate output
157 and an output driver (\[lq]postprocessor\[rq]) to consume it,
158 users normally do not encounter this language.
159 .
160 The
161 .I groff
162 program's
163 .B \-Z
164 option inhibits postprocessing such that this intermediate output is
165 sent to the standard output stream as when
166 .I \%troff
167 is run manually.
168 .
169 .
170 .P
171 .IR groff 's
172 intermediate output facilitates the development of output drivers and
173 other postprocessors by offering a common programming interface.
174 .
175 It is an extension of the page description language developed by Brian
176 Kernighan for AT&T device-independent
177 .I troff \" AT&T
178 circa 1980.
179 .
180 Where a distinction is necessary,
181 we will say
182 .RI \[lq] \%troff
183 output\[rq] to describe the output of GNU
184 .IR troff , \" GNU
185 and \[lq]intermediate output\[rq] to denote the language accepted by
186 the parser implemented in
187 .IR groff 's
188 internal C++ library used by most of its output drivers.
189 .\" XXX GBR leaves off here.
190 .
191 .
192 .\" ====================================================================
193 .SH "Language concepts"
194 .\" ====================================================================
195 .
196 During the run of
197 .IR \%troff ,
198 the
199 .I roff
200 input is cracked down to the information on what has to be printed at
201 what position on the intended device.
202 .
203 So the language of the
204 .I intermediate output
205 format can be quite small.
206 .
207 Its only elements are commands with or without arguments.
208 .
209 In this document, the term \[lq]command\[rq] always refers to the
210 .I intermediate output
211 language, never to the
212 .I roff
213 language used for document formatting.
214 .
215 There are commands for positioning and text writing, for drawing, and
216 for device controlling.
217 .
218 .
219 .\" ====================================================================
220 .SS Separation
221 .\" ====================================================================
222 .
223 .I Classical troff output
224 had strange requirements on whitespace.
225 .
226 The
227 .I groff
228 output parser, however, is smart about whitespace by making it
229 maximally optional.
230 .
231 The whitespace characters, i.e., the
232 .IR tab ,
233 .IR space ,
234 and
235 .I newline
236 characters, always have a syntactical meaning.
237 .
238 They are never printable because spacing within the output is always
239 done by positioning commands.
240 .
241 .
242 .P
243 Any sequence of
244 .I space
245 or
246 .I tab
247 characters is treated as a single
248 .I syntactical
249 .IR space .
250 .
251 It separates commands and arguments, but is only required when there
252 would occur a clashing between the command code and the arguments
253 without the space.
254 .
255 Most often, this happens when variable length command names,
256 arguments, argument lists, or command clusters meet.
257 .
258 Commands and arguments with a known, fixed length need not be
259 separated by
260 .I syntactical
261 .IR space .
262 .
263 .
264 .P
265 A line break is a syntactical element, too.
266 .
267 Every command argument can be followed by whitespace, a comment, or a
268 newline character.
269 .
270 Thus a
271 .I syntactical line break
272 is defined to consist of optional
273 .I syntactical space
274 that is optionally followed by a comment, and a newline character.
275 .
276 .
277 .P
278 The normal commands, those for positioning and text, consist of a
279 single letter taking a fixed number of arguments.
280 .
281 For historical reasons, the parser allows stacking of such commands on
282 the same line, but fortunately, in
283 .I groff intermediate
284 .IR output ,
285 every command with at least one argument is followed by a line break,
286 thus providing excellent readability.
287 .
288 .P
289 The other commands \[em] those for drawing and device controlling \[em]
290 have a more complicated structure; some recognize long command names,
291 and some take a variable number of arguments.
292 .
293 So all
294 .B D
295 and
296 .B x
297 commands were designed to request a
298 .I syntactical line break
299 after their last argument.
300 .
301 Only one command,
302 .RB \[oq] x\ X \[cq]
303 has an argument that can stretch over several lines, all other
304 commands must have all of their arguments on the same line as the
305 command, i.e., the arguments may not be split by a line break.
306 .
307 .P
308 Lines containing only spaces and/or a comment are treated as empty and
309 ignored.
310 .
311 .
312 .\" ====================================================================
313 .SS "Argument units"
314 .\" ====================================================================
315 .
316 Some commands accept integer arguments that represent measurements,
317 but the scaling units of the formatter's language are never used.
318 .
319 Most commands assume a scaling unit
320 .RB of\~\[lq] u \[rq]
321 (basic units),
322 and others
323 .RB use\~\[lq] z \[rq]
324 (scaled points);
325 .
326 These are defined by the parameters specified in the device's
327 .I DESC
328 file;
329 see
330 .MR groff_font 5
331 and,
332 for more on scaling units,
333 .MR groff 7
334 and
335 .IR "Groff: The GNU Implementation of troff" ,
336 the
337 .I groff
338 Texinfo manual.
339 .
340 Color-related commands use dimensionless integers.
341 .
342 .
343 .P
344 Note that single characters can have the eighth bit set, as can the
345 names of fonts and special characters (this is, glyphs).
346 .
347 The names of glyphs and fonts can be of arbitrary length.
348 .
349 A glyph that is to be printed will always be in the current font.
350 .
351 .
352 .P
353 A string argument is always terminated by the next whitespace
354 character (space, tab, or newline); an embedded
355 .B #
356 character is regarded as part of the argument, not as the beginning of
357 a comment command.
358 .
359 An integer argument is already terminated by the next non-digit
360 character, which then is regarded as the first character of the next
361 argument or command.
362 .
363 .
364 .\" ====================================================================
365 .SS "Document parts"
366 .\" ====================================================================
367 .
368 A correct
369 .I intermediate output
370 document consists of two parts, the
371 .I prologue
372 and the
373 .IR body .
374 .
375 .P
376 The task of the
377 .I prologue
378 is to set the general device parameters using three exactly specified
379 commands.
380 .
381 The
382 .I groff prologue
383 is guaranteed to consist of the following three lines (in that order):
384 .RS
385 .P
386 .B x\ T
387 .I device
388 .br
389 .B x\ res
390 .I n\ h\ v
391 .br
392 .B x init
393 .RE
394 .P
395 with the arguments set as outlined in subsection \[lq]Device Control
396 Commands\[rq] below.
397 .
398 However, the parser for the
399 .I intermediate output
400 format is able to swallow additional whitespace and comments as well.
401 .
402 .
403 .P
404 The
405 .I body
406 is the main section for processing the document data.
407 .
408 Syntactically, it is a sequence of any commands different from the
409 ones used in the
410 .IR prologue .
411 .
412 Processing is terminated as soon as the first
413 .B x\ stop
414 command is encountered; the last line of any
415 .I groff intermediate output
416 always contains such a command.
417 .
418 .
419 .P
420 Semantically, the
421 .I body
422 is page oriented.
423 .
424 A new page is started by a
425 .BR p \~command.
426 .
427 Positioning, writing, and drawing commands are always done within the
428 current page, so they cannot occur before the first
429 .BR p \~command.
430 .
431 Absolute positioning (by the
432 .B H
433 and
434 .BR V \~commands)
435 is done relative to the current page, all other positioning
436 is done relative to the current location within this page.
437 .
438 .
439 .\" ====================================================================
440 .SH "Command reference"
441 .\" ====================================================================
442 .
443 This section describes all
444 .I intermediate output
445 commands, the classical commands as well as the
446 .I groff
447 extensions.
448 .
449 .
450 .\" ====================================================================
451 .SS "Comment command"
452 .\" ====================================================================
453 .
454 .TP
455 .BI # anything\c
456 \[la]line-break\[ra]
457 A comment.
458 .
459 Ignore any characters from the
460 .BR # \~character
461 up to the next newline.
462 .
463 Each comment can be preceded by arbitrary
464 .I syntactical
465 .IR space ;
466 every command can be terminated by a comment.
467 .
468 .
469 .\" ====================================================================
470 .SS "Simple commands"
471 .\" ====================================================================
472 .
473 The commands in this subsection have a command code consisting of a
474 single character, taking a fixed number of arguments.
475 .
476 Most of them are commands for positioning and text writing.
477 .
478 These commands are smart about whitespace.
479 .
480 Optionally,
481 .I syntactical space
482 can be inserted before, after, and between the command letter and its
483 arguments.
484 .
485 All of these commands are stackable, i.e., they can be preceded by
486 other simple commands or followed by arbitrary other commands on the
487 same line.
488 .
489 A separating
490 .I syntactical space
491 is necessary only when two integer arguments would clash or if the
492 preceding argument ends with a string argument.
493 .
494 .
495 .if \n[@USE_ENV_STACK]=1 \{\
496 .TP
497 .command {
498 Open a new environment by copying the current device configuration data
499 to the environment stack.
500 .
501 The current environment is setup by the device specification and
502 manipulated by the setting commands.
503 .
504 .
505 .TP
506 .command }
507 Close the current environment
508 (opened by a preceding
509 .BR { \~command)
510 and restore the previous environment from the environment
511 stack as the current device configuration data.
512 .
513 .\} \" endif @USE_ENV_STACK
514 .
515 .
516 .TP
517 .command C id \[la]white-space\[ra]
518 Typeset the glyph of the special character
519 .IR id .
520 .
521 Trailing syntactical space is necessary to allow special character names
522 of arbitrary length.
523 .
524 The drawing position is not advanced.
525 .\" XXX: Why does it matter that we read its size if we don't advance
526 .\" the drawing position?
527 .\" its size is read from the font description file.
528 .
529 .
530 .TP
531 .command c c
532 Typeset the glyph of the ordinary character
533 .RI character\~ c .
534 .
535 The drawing position is not advanced.
536 .\" XXX: Why does it matter that we read its size if we don't advance
537 .\" the drawing position?
538 .\" its size is read from the font description file.
539 .
540 .
541 .TP
542 .command f n
543 Select the font mounted at
544 .RI position\~ n .
545 .
546 .IR n\~ cannot
547 be negative.
548 .
549 .
550 .TP
551 .command H n
552 Horizontally move the drawing position to
553 .IR n\~ basic
554 units from the left edge of the page.
555 .
556 .IR n\~ cannot
557 be negative.
558 .
559 .
560 .TP
561 .command h n
562 Move the drawing position right
563 .I n
564 basic units.
565 .
566 AT&T
567 .I troff \" AT&T
568 allowed negative
569 .I n;
570 GNU
571 .I troff \" GNU
572 does not produce such values,
573 but
574 .IR groff 's
575 output driver library handles them.
576 .
577 .
578 .TP
579 .command m "scheme \f[R][\f[]component\f[R] .\|.\|.]"
580 Select the stroke color using the
581 .IR component s
582 in the color space
583 .IR scheme .
584 .
585 Each
586 .I component
587 is an integer between 0 and \n[@maxcolor].
588 .
589 The quantity of components and their meanings vary with each
590 .IR scheme .
591 .
592 This command is a
593 .I groff
594 extension.
595 .
596 .
597 .RS
598 .TP
599 .command mc "cyan magenta yellow"
600 Use the CMY color scheme with components
601 cyan,
602 magenta,
603 and yellow.
604 .
605 .
606 .TP
607 .command md
608 Use the default color
609 (no components;
610 black in most cases).
611 .
612 .
613 .TP
614 .command mg gray
615 Use a grayscale color scheme with a component ranging
616 between 0 (black) and \n[@maxcolor] (white).
617 .
618 .
619 .TP
620 .command mk "cyan magenta yellow black"
621 Use the CMYK color scheme with components
622 cyan,
623 magenta,
624 yellow,
625 and black.
626 .
627 .
628 .TP
629 .command mr "red green blue"
630 Use the RGB color scheme with components
631 red,
632 green,
633 and blue.
634 .RE
635 .
636 .
637 .TP
638 .command N n
639 Typeset the glyph with
640 .RI index\~ n
641 in the current font.
642 .
643 .IR n\~ is
644 normally a non-negative integer.
645 .
646 The drawing position is not advanced.
647 .
648 The
649 .B html
650 and
651 .B xhtml
652 devices use this command with
653 .RI negative\~ n
654 to produce unbreakable space;
655 the absolute value of
656 .I n
657 is taken and interpreted in basic units.
658 .
659 .
660 .TP
661 .command n b\~a
662 Indicate a break.
663 .
664 No action is performed;
665 the command is present to make the output more easily parsed.
666 .
667 The integers
668 .I b
669 .RI and\~ a
670 describe the vertical space amounts before and after the break,
671 respectively.
672 .
673 GNU
674 .I troff \" GNU
675 issues this command but
676 .IR groff 's
677 output driver library ignores it.
678 .
679 See
680 .B v
681 and
682 .BR V .
683 .
684 .
685 .TP
686 .command p n
687 Begin a new page,
688 setting its number
689 .RI to\~ n .
690 .
691 Each page is independent,
692 even from those using the same number.
693 .
694 The vertical drawing position is set to\~0.
695 .
696 All positioning,
697 writing,
698 and drawing commands are interpreted in the context of a page,
699 so a
700 .BR p \~command
701 must precede them.
702 .
703 .
704 .TP
705 .command s n
706 Set type size to
707 .I n
708 scaled points
709 .RB (unit\~ z
710 in GNU
711 .IR troff ). \" GNU
712 .
713 AT&T
714 .I troff \" AT&T
715 used unscaled points
716 .RB ( p )
717 instead;
718 see section \[lq]Compatibility\[rq] below.
719 .
720 .
721 .TP
722 .command t xyz\f[R]\|.\|.\|.\& \f[R]\[la]white-space\[ra]
723 .TQ
724 .command t "xyz\f[R]\|.\|.\|.\&\f[] dummy-arg" \[la]white-space\[ra]
725 Typeset word
726 .IR xyz ;
727 that is,
728 set a sequence of ordinary glyphs named
729 .IR x ,
730 .IR y ,
731 .IR z ,
732 \&.\|.\|.\|,
733 terminated by a space or newline;
734 an optional second integer argument is ignored
735 (this allows the formatter to generate an even number of arguments).
736 .\" XXX: Why?
737 .
738 Each glyph is set at the current drawing position,
739 and the position is then advanced horizontally by the glyph's width.
740 .
741 A glyph's width is read from its metrics in the font description file,
742 scaled to the current type size,
743 and rounded to a multiple of the horizontal motion quantum.
744 .
745 Use the
746 .B C
747 command to emplace glyphs of special characters.
748 .
749 The
750 .BR t \~command
751 is a
752 .I groff
753 extension and is output only for devices whose
754 .I DESC
755 file contains the
756 .B tcommand
757 directive;
758 see
759 .MR groff_font 5 .
760 .
761 .
762 .TP
763 .command u "n xyz"\f[R]\|.\|.\|.\& \f[R]\[la]white-space\[ra]
764 .TQ
765 .command u "xyz\f[R]\|.\|.\|.\&\f[] dummy-arg" \[la]white-space\[ra]
766 Typeset word
767 .I xyz
768 with track kerning.
769 .
770 As
771 .BR t ,
772 but after placing each glyph,
773 the drawing position is further advanced horizontally
774 .RI by\~ n
775 basic units.
776 .
777 The
778 .BR u \~command
779 is a
780 .I groff
781 extension and is output only for devices whose
782 .I DESC
783 file contains the
784 .B tcommand
785 directive;
786 see
787 .MR groff_font 5 .
788 .
789 .
790 .TP
791 .command V n
792 Vertically move the drawing position to
793 .IR n\~ basic
794 units from the top edge of the page.
795 .
796 .IR n\~ cannot
797 be negative.
798 .
799 .
800 .TP
801 .command v n
802 Move the drawing position down
803 .I n
804 basic units.
805 .
806 AT&T
807 .I troff \" AT&T
808 allowed negative
809 .I n;
810 GNU
811 .I troff \" GNU
812 does not produce such values,
813 but
814 .IR groff 's
815 output driver library handles them.
816 .
817 .
818 .TP
819 .command w
820 Indicate an inter-word space.
821 .
822 No action is performed;
823 the command is present to make the output more easily parsed.
824 .
825 Only adjustable,
826 breakable inter-word spaces are thus described;
827 those resulting from
828 .B \[rs]\[ti]
829 or horizontal motion escape sequences are not.
830 .
831 GNU
832 .I troff \" GNU
833 issues this command but
834 .IR groff 's
835 output driver library ignores it.
836 .
837 See
838 .B h
839 and
840 .BR H .
841 .
842 .
843 .\" ====================================================================
844 .SS "Graphics commands"
845 .\" ====================================================================
846 .
847 Each graphics or drawing command in the
848 .I intermediate output
849 starts with the letter\~\c
850 .B D
851 followed by one or two characters that specify a subcommand; this
852 is followed by a fixed or variable number of integer arguments that
853 are separated by a single space character.
854 .
855 A
856 .BR D \~command
857 may not be followed by another command on the same line (apart from a
858 comment), so each
859 .BR D \~command
860 is terminated by a
861 .I syntactical line
862 .IR break .
863 .
864 .
865 .P
866 .I \%troff
867 output follows the classical spacing rules (no space between command
868 and subcommand, all arguments are preceded by a single space
869 character), but the parser allows optional space between the command
870 letters and makes the space before the first argument optional.
871 .
872 As usual, each space can be any sequence of tab and space characters.
873 .
874 .
875 .P
876 Some graphics commands can take a variable number of arguments.
877 .
878 In this case, they are integers representing a size measured in basic
879 units\~\c
880 .BR u .
881 .
882 The
883 .I h
884 arguments
885 stand for horizontal distances where positive means right, negative
886 left.
887 .
888 The
889 .I v
890 arguments
891 stand for vertical distances where positive means down, negative up.
892 .
893 All these distances are offsets relative to the current location.
894 .
895 .
896 .P
897 Unless indicated otherwise, each graphics command directly corresponds
898 to a similar
899 .I groff
900 .B \*[@backslash]D
901 escape sequence; see
902 .MR groff 7 .
903 .
904 .
905 .P
906 Unknown
907 .BR D \~commands
908 are assumed to be device-specific.
909 .
910 Its arguments are parsed as strings; the whole information is then
911 sent to the postprocessor.
912 .
913 .
914 .P
915 In the following command reference, the syntax element
916 .I \[la]line-break\[ra]
917 means a
918 .I syntactical line break
919 as defined in subsection \[lq]Separation\[rq] above.
920 .
921 .
922 .TP
923 .D-multiarg \[ti]
924 Draw B-spline from current position to offset
925 .indexed_offset h 1 v 1 ,
926 then to offset
927 .indexed_offset h 2 v 2
928 if given, etc., up to
929 .indexed_offset h n v n .
930 This command takes a variable number of argument pairs; the current
931 position is moved to the terminal point of the drawn curve.
932 .
933 .
934 .TP
935 .Da-command
936 Draw arc from current position to
937 .indexed_offset h 1 v 1 \|+\|\c
938 .indexed_offset h 2 v 2
939 with center at
940 .indexed_offset h 1 v 1 ;
941 then move the current position to the final point of the arc.
942 .
943 .
944 .TP
945 .D-command C d
946 .TQ
947 .D-command C "d dummy-arg"
948 Draw a solid circle using the current fill color with diameter\~\c
949 .I d
950 (integer in basic units\~\c
951 .BR u )
952 with leftmost point at the current position; then move the current
953 position to the rightmost point of the circle.
954 .
955 An optional second integer argument is ignored (this allows the
956 formatter to generate an even number of arguments).
957 .
958 This command is a
959 .I groff
960 extension.
961 .
962 .
963 .TP
964 .D-command c d
965 Draw circle line with diameter\~\c
966 .I d
967 (integer in basic units\~\c
968 .BR u )
969 with leftmost point at the current position; then move the current
970 position to the rightmost point of the circle.
971 .
972 .
973 .TP
974 .D-command E "h v"
975 Draw a solid ellipse in the current fill color with a horizontal
976 diameter of\~\c
977 .I h
978 and a vertical diameter of\~\c
979 .I v
980 (both integers in basic units\~\c
981 .BR u )
982 with the leftmost point at the current position; then move to the
983 rightmost point of the ellipse.
984 .
985 This command is a
986 .I groff
987 extension.
988 .
989 .
990 .TP
991 .D-command e "h v"
992 Draw an outlined ellipse with a horizontal diameter of\~\c
993 .I h
994 and a vertical diameter of\~\c
995 .I v
996 (both integers in basic units\~\c
997 .BR u )
998 with the leftmost point at current position; then move to the
999 rightmost point of the ellipse.
1000 .
1001 .
1002 .TP
1003 .D-command F "color-scheme \fR[\fPcomponent\fR .\|.\|.]\fP"
1004 Set fill color for solid drawing objects using different color
1005 schemes; the analogous command for setting the color of text, line
1006 graphics, and the outline of graphic objects is
1007 .BR m .
1008 .
1009 The color components are specified as integer arguments between 0 and
1010 \n[@maxcolor].
1011 .
1012 The number of color components and their meaning vary for the
1013 different color schemes.
1014 .
1015 These commands are generated by the
1016 .I groff
1017 escape sequences
1018 .BR \*[@backslash]D\[aq]F\ .\|.\|. '
1019 and
1020 .B \*[@backslash]M
1021 (with no other corresponding graphics commands).
1022 .
1023 This command is a
1024 .I groff
1025 extension.
1026 .
1027 .
1028 .RS
1029 .
1030 .TP
1031 .D-command Fc "cyan magenta yellow"
1032 Set fill color for solid drawing objects using the CMY color scheme,
1033 having the 3\~color components cyan, magenta, and yellow.
1034 .
1035 .
1036 .TP
1037 .D-command Fd
1038 Set fill color for solid drawing objects to the default fill color value
1039 (black in most cases).
1040 .
1041 No component arguments.
1042 .
1043 .
1044 .TP
1045 .D-command Fg "gray"
1046 Set fill color for solid drawing objects to the shade of gray given by
1047 the argument, an integer between 0 (black) and \n[@maxcolor] (white).
1048 .
1049 .
1050 .TP
1051 .D-command Fk "cyan magenta yellow black"
1052 Set fill color for solid drawing objects using the CMYK color scheme,
1053 having the 4\~color components cyan, magenta, yellow, and black.
1054 .
1055 .TP
1056 .D-command Fr "red green blue"
1057 Set fill color for solid drawing objects using the RGB color scheme,
1058 having the 3\~color components red, green, and blue.
1059 .
1060 .RE
1061 .
1062 .
1063 .TP
1064 .D-command f n
1065 The argument
1066 .I n
1067 must be an integer in the range \-32767 to 32767.
1068 .
1069 .RS
1070 .TP
1071 .RI 0\|\[<=]\| n \|\[<=]\|1000
1072 Set the color for filling solid drawing objects to a shade of gray,
1073 where 0 corresponds to solid white, 1000 (the default) to solid black,
1074 and values in between to intermediate shades of gray; this is
1075 obsoleted by command
1076 .BR DFg .
1077 .
1078 .TP
1079 .IR n "\|<\|0 or " n \|>\|1000
1080 Set the filling color to the color that is currently being used for
1081 the text and the outline, see command
1082 .BR m .
1083 For example, the command sequence
1084 .
1085 .RS
1086 .IP
1087 .EX
1088 mg 0 0 \n[@maxcolor]
1089 Df \-1
1090 .EE
1091 .RE
1092 .
1093 .IP
1094 sets all colors to blue.
1095 .
1096 .P
1097 This command is a
1098 .I groff
1099 extension.
1100 .
1101 .RE
1102 .
1103 .
1104 .TP
1105 .D-command l "h v"
1106 Draw line from current position to offset
1107 .offset h v
1108 (integers in basic units\~\c
1109 .BR u );
1110 then set current position to the end of the drawn line.
1111 .
1112 .
1113 .TP
1114 .D-multiarg p
1115 Draw a polygon line from current position to offset
1116 .indexed_offset h 1 v 1 ,
1117 from there to offset
1118 .indexed_offset h 2 v 2 ,
1119 etc., up to offset
1120 .indexed_offset h n v n ,
1121 and from there back to the starting position.
1122 .
1123 .ie \n[@STUPID_DRAWING_POSITIONING]=1 \{\
1124 For historical reasons, the position is changed by adding the sum of
1125 all arguments with odd index to the current horizontal position and the
1126 even ones to the vertical position.
1127 .
1128 Although this doesn't make sense it is kept for compatibility.
1129 .
1130 .\}
1131 .el \{\
1132 As the polygon is closed, the end of drawing is the starting point, so
1133 the position doesn't change.
1134 .\}
1135 .
1136 This command is a
1137 .I groff
1138 extension.
1139 .
1140 .
1141 .TP
1142 .D-multiarg P
1143 The same macro as the corresponding
1144 .B Dp
1145 command with the same arguments, but draws a solid polygon in the
1146 current fill color rather than an outlined polygon.
1147 .
1148 .if \n[@STUPID_DRAWING_POSITIONING]=1 \{\
1149 The position is changed in the same way as with
1150 .BR Dp .
1151 .\}
1152 .
1153 This command is a
1154 .I groff
1155 extension.
1156 .
1157 .
1158 .TP
1159 .D-command t n
1160 Set the current line thickness
1161 .RI to\~ n
1162 (an integer in basic
1163 .RB units\~ u )
1164 if
1165 .IR n \|>\|0;
1166 if
1167 .IR n \|=\|0
1168 select the smallest available line thickness;
1169 otherwise,
1170 the line thickness is made proportional to the type size,
1171 which is the default.
1172 .
1173 .if \n[@STUPID_DRAWING_POSITIONING]=1 \{\
1174 For historical reasons,
1175 the horizontal position is changed by adding the argument to the current
1176 horizontal position,
1177 while the vertical position is not changed.
1178 .
1179 Although this doesn't make sense,
1180 it is kept for compatibility.
1181 .\}
1182 .
1183 This command is a
1184 .I groff
1185 extension.
1186 .
1187 .
1188 .\" ====================================================================
1189 .SS "Device control commands"
1190 .\" ====================================================================
1191 .
1192 Each device control command starts with the letter
1193 .B x
1194 followed by a space character (optional or arbitrary space/\:tab in
1195 .IR groff )
1196 and a subcommand letter or word; each argument (if any) must be
1197 preceded by a
1198 .I syntactical
1199 .IR space .
1200 .
1201 All
1202 .B x
1203 commands are terminated by a
1204 .IR "syntactical line break" ;
1205 no device control command can be followed by another command on the same
1206 line (except a comment).
1207 .
1208 .P
1209 The subcommand is basically a single letter, but to increase
1210 readability, it can be written as a word, i.e., an arbitrary sequence
1211 of characters terminated by the next tab, space, or newline character.
1212 .
1213 All characters of the subcommand word but the first are simply ignored.
1214 .
1215 For example,
1216 .I \%troff
1217 outputs the initialization command
1218 .B x\ i
1219 as
1220 .B x\ init
1221 and the resolution command
1222 .B x\ r
1223 as
1224 .BR "x\ res" .
1225 .
1226 But writings like
1227 .B x\ i_like_groff
1228 and
1229 .B x\ roff_is_groff
1230 are accepted as well to mean the same commands.
1231 .
1232 .P
1233 In the following, the syntax element
1234 .I \[la]line-break\[ra]
1235 means a
1236 .I syntactical line break
1237 as defined in subsection \[lq]Separation\[rq] above.
1238 .
1239 .TP
1240 .x-command F name
1241 .xsub Filename
1242 Use
1243 .I name
1244 as the intended name for the current file in error reports.
1245 .
1246 This is useful for remembering the original file name when
1247 .I groff
1248 uses an internal piping mechanism.
1249 .
1250 The input file is not changed by this command.
1251 .
1252 This command is a
1253 .I groff
1254 extension.
1255 .
1256 .
1257 .TP
1258 .x-command f "n\ s"
1259 .xsub font
1260 Mount font position\~\c
1261 .I n
1262 (a non-negative integer) with font named\~\c
1263 .I s
1264 (a text word);
1265 see
1266 .MR groff_font 5 .
1267 .
1268 .
1269 .TP
1270 .x-command H n
1271 .xsub Height
1272 Set character height to\~\c
1273 .I n
1274 (a positive integer in scaled points\~\c
1275 .BR z ).
1276 .
1277 .I Classical troff
1278 used the unit points (\c
1279 .BR p )
1280 instead;
1281 see section \[lq]Compatibility\[rq] below.
1282 .
1283 .
1284 .TP
1285 .x-command i
1286 .xsub init
1287 Initialize device.
1288 .
1289 This is the third command of the
1290 .IR prologue .
1291 .
1292 .
1293 .TP
1294 .x-command p
1295 .xsub pause
1296 Parsed but ignored.
1297 .
1298 The classical documentation reads
1299 .I pause device, can be
1300 .IR restarted .
1301 .
1302 .
1303 .TP
1304 .x-command r "n\ h\ v"
1305 .xsub resolution
1306 Resolution is\~\c
1307 .IR n ,
1308 while
1309 .I h
1310 is the minimal horizontal motion, and
1311 .I v
1312 the minimal vertical motion possible with this device; all arguments
1313 are positive integers in basic units\~\c
1314 .B u
1315 per inch.
1316 .
1317 This is the second command of the
1318 .IR prologue .
1319 .
1320 .
1321 .TP
1322 .x-command S n
1323 .xsub Slant
1324 Set slant to\~\c
1325 .I n
1326 degrees (an integer in basic units\~\c
1327 .BR u ).
1328 .
1329 .
1330 .TP
1331 .x-command s
1332 .xsub stop
1333 Terminates the processing of the current file; issued as the last
1334 command of any
1335 .I intermediate \%troff
1336 .IR output .
1337 .
1338 .
1339 .TP
1340 .x-command t
1341 .xsub trailer
1342 Generate trailer information, if any.
1343 .
1344 In
1345 .BR groff ,
1346 this is currently ignored.
1347 .
1348 .
1349 .TP
1350 .x-command T xxx
1351 .xsub Typesetter
1352 .
1353 Set the name of the output driver to
1354 .IR xxx ,
1355 a sequence of non-whitespace characters terminated by whitespace.
1356 .
1357 The possible names correspond to those of
1358 .IR groff 's
1359 .B \-T
1360 option.
1361 .
1362 This is the first command of the prologue.
1363 .
1364 .
1365 .TP
1366 .x-command u n
1367 .xsub underline
1368 Configure underlining of spaces.
1369 .
1370 If
1371 .I n
1372 is\~1, start underlining of spaces;
1373 if
1374 .I n
1375 is\~0, stop underlining of spaces.
1376 .
1377 This is needed for the
1378 .B cu
1379 request in
1380 .B \%nroff
1381 mode and is ignored otherwise.
1382 .
1383 This command is a
1384 .I groff
1385 extension.
1386 .
1387 .
1388 .TP
1389 .x-command X anything
1390 .xsub X-escape
1391 Send string
1392 .I anything
1393 uninterpreted to the device.
1394 .
1395 If the line following this command starts with a
1396 .B +
1397 character this line is interpreted as a continuation line in the
1398 following sense.
1399 .
1400 The
1401 .B +
1402 is ignored, but a newline character is sent instead to the device, the
1403 rest of the line is sent uninterpreted.
1404 .
1405 The same applies to all following lines until the first character of a
1406 line is not a
1407 .B +
1408 character.
1409 .
1410 This command is generated by the
1411 .I groff
1412 escape sequence
1413 .BR \*[@backslash]X .
1414 .
1415 The line-continuing feature is a
1416 .I groff
1417 extension.
1418 .
1419 .
1420 .\" ====================================================================
1421 .SS "Obsolete command"
1422 .\" ====================================================================
1423 .
1424 In
1425 .I classical troff
1426 output, emitting a single glyph was mostly done by a very
1427 strange command that combined a horizontal move and the printing of a
1428 glyph.
1429 .
1430 It didn't have a command code, but is represented by a 3-character
1431 argument consisting of exactly 2\~digits and a character.
1432 .
1433 .TP
1434 .I ddc
1435 Move right
1436 .I dd
1437 (exactly two decimal digits) basic units\~\c
1438 .BR u ,
1439 then print glyph with single-letter name\~\c
1440 .IR c .
1441 .
1442 .
1443 .RS
1444 .P
1445 In
1446 .IR groff ,
1447 arbitrary
1448 .I syntactical space
1449 around and within this command is allowed to be added.
1450 .
1451 Only when a preceding command on the same line ends with an argument
1452 of variable length a separating space is obligatory.
1453 .
1454 In
1455 .I classical
1456 .IR troff ,
1457 large clusters of these and other commands were used, mostly without
1458 spaces; this made such output almost unreadable.
1459 .
1460 .RE
1461 .
1462 .
1463 .P
1464 For modern high-resolution devices, this command does not make sense
1465 because the width of the glyphs can become much larger than two
1466 decimal digits.
1467 .
1468 In
1469 .IR groff ,
1470 it is used only for output to the
1471 .BR X75 ,
1472 .BR X75\-12 ,
1473 .BR X100 ,
1474 and
1475 .B X100\-12
1476 devices.
1477 .
1478 For others,
1479 the commands
1480 .B t
1481 .RB and\~ u
1482 provide greater functionality and superior troubleshooting capacity.
1483 .
1484 .
1485 .\" ====================================================================
1486 .SH Postprocessing
1487 .\" ====================================================================
1488 .
1489 The
1490 .I roff
1491 postprocessors are programs that have the task to translate the
1492 .I intermediate output
1493 into actions that are sent to a device.
1494 .
1495 A device can be some piece of hardware such as a printer, or a software
1496 file format suitable for graphical or text processing.
1497 .
1498 The
1499 .I groff
1500 system provides powerful means that make the programming of such
1501 postprocessors an easy task.
1502 .P
1503 There is a library function that parses the
1504 .I intermediate output
1505 and sends the information obtained to the device via methods of a
1506 class with a common interface for each device.
1507 .
1508 So a
1509 .I groff
1510 postprocessor must only redefine the methods of this class.
1511 .
1512 For details,
1513 see the reference in section \[lq]Files\[rq] below.
1514 .
1515 .
1516 .\" ====================================================================
1517 .SH Example
1518 .\" ====================================================================
1519 .
1520 This section presents the
1521 .I intermediate output
1522 generated from the same input for three different devices.
1523 .
1524 The input is the sentence
1525 .I hell world
1526 fed into
1527 .I groff
1528 on the command line.
1529 .
1530 .
1531 .IP \[bu] 2m
1532 High-resolution device
1533 .I ps
1534 .
1535 .
1536 .RS
1537 .P
1538 .EX
1539 .RB "shell>\~" "echo \[dq]hell world\[dq] | groff \-Z \-T ps"
1540 .EE
1541 .
1542 .
1543 .P
1544 .EX
1545 x T ps
1546 x res 72000 1 1
1547 x init
1548 p1
1549 x font 5 TR
1550 f5
1551 s10000
1552 V12000
1553 H72000
1554 thell
1555 wh2500
1556 tw
1557 H96620
1558 torld
1559 n12000 0
1560 x trailer
1561 V792000
1562 x stop
1563 .EE
1564 .RE
1565 .
1566 .
1567 .P
1568 This output can be fed into the postprocessor
1569 .MR grops 1
1570 to get its representation as a PostScript file, or
1571 .MR gropdf 1
1572 to output directly to PDF.
1573 .
1574 .
1575 .IP \[bu] 2m
1576 Low-resolution device
1577 .I latin1
1578 .
1579 .
1580 .RS
1581 .P
1582 This is similar to the high-resolution device except that the
1583 positioning is done at a minor scale.
1584 .
1585 Some comments (lines starting with
1586 .IR # )
1587 were added for clarification; they were not generated by the
1588 formatter.
1589 .
1590 .
1591 .P
1592 .EX
1593 \fBshell>\fP "hell world" | groff \-Z \-T latin1
1594 .EE
1595 .
1596 .
1597 .P
1598 .EX
1599 .I # prologue
1600 x T latin1
1601 x res 240 24 40
1602 x init
1603 .I # begin a new page
1604 p1
1605 .I # font setup
1606 x font 1 R
1607 f1
1608 s10
1609 .I # initial positioning on the page
1610 V40
1611 H0
1612 .I # write text \[aq]hell\[aq]
1613 thell
1614 .I # inform about a space, and do it by a horizontal jump
1615 wh24
1616 .I # write text \[aq]world\[aq]
1617 tworld
1618 .I # announce line break, but do nothing because ...
1619 n40 0
1620 .I # ... the end of the document has been reached
1621 x trailer
1622 V2640
1623 x stop
1624 .EE
1625 .RE
1626 .
1627 .
1628 .P
1629 This output can be fed into the postprocessor
1630 .MR grotty 1
1631 to get a formatted text document.
1632 .
1633 .
1634 .IP \[bu] 2m
1635 Classical style output
1636 .
1637 .
1638 .RS
1639 .P
1640 As a computer monitor has a very low resolution compared to modern
1641 printers the
1642 .I intermediate output
1643 for the X\~devices can use the jump-and-write command with its 2-digit
1644 displacements.
1645 .
1646 .
1647 .P
1648 .EX
1649 \fBshell>\fP "hell world" | groff \-Z \-T X100
1650 .EE
1651 .
1652 .
1653 .P
1654 .EX
1655 x T X100
1656 x res 100 1 1
1657 x init
1658 p1
1659 x font 5 TR
1660 f5
1661 s10
1662 V16
1663 H100
1664 .I # write text with old-style jump-and-write command
1665 ch07e07l03lw06w11o07r05l03dh7
1666 n16 0
1667 x trailer
1668 V1100
1669 x stop
1670 .EE
1671 .RE
1672 .
1673 .
1674 .P
1675 This output can be fed into the postprocessor
1676 .MR xditview 1x
1677 or
1678 .MR gxditview 1
1679 for displaying in\~X.
1680 .
1681 .
1682 .P
1683 Due to the obsolete jump-and-write command, the text clusters in the
1684 classical output are almost unreadable.
1685 .
1686 .
1687 .\" ====================================================================
1688 .SH Compatibility
1689 .\" ====================================================================
1690 .
1691 The
1692 .I intermediate output
1693 language of the
1694 .I classical troff
1695 was first documented in
1696 [CSTR\~#97].
1697 .
1698 The
1699 .I groff intermediate output
1700 format is compatible with this specification except for the following
1701 features.
1702 .
1703 .
1704 .IP \[bu] 2m
1705 The classical quasi device independence is not yet implemented.
1706 .
1707 .
1708 .IP \[bu] 2m
1709 The old hardware was very different from what we use today.
1710 .
1711 So the
1712 .I groff
1713 devices are also fundamentally different from the ones in
1714 .I classical
1715 .IR troff .
1716 .
1717 For example, the classical PostScript device was called
1718 .I post
1719 and had a resolution of 720 units per inch,
1720 while
1721 .IR groff 's
1722 .I ps
1723 device has a resolution of 72000 units per inch.
1724 .
1725 Maybe, by implementing some rescaling mechanism similar to the
1726 classical quasi device independence, these could be integrated into
1727 modern
1728 .IR groff .
1729 .
1730 .
1731 .IP \[bu] 2m
1732 The B-spline command
1733 .B D\[ti]
1734 is correctly handled by the
1735 .I intermediate output
1736 parser, but the drawing routines aren't implemented in some of the
1737 postprocessor programs.
1738 .
1739 .
1740 .IP \[bu] 2m
1741 The argument of the commands
1742 .B s
1743 and
1744 .B x H
1745 has the implicit unit scaled point\~\c
1746 .B z
1747 in
1748 .IR groff ,
1749 while
1750 .I classical troff
1751 had point (\c
1752 .BR p ).
1753 .
1754 This isn't an incompatibility, but a compatible extension, for both
1755 units coincide for all devices without a
1756 .I sizescale
1757 parameter, including all classical and the
1758 .I groff
1759 text devices.
1760 .
1761 The few
1762 .I groff
1763 devices with a sizescale parameter either did not exist, had a
1764 different name, or seem to have had a different resolution.
1765 .
1766 So conflicts with classical devices are very unlikely.
1767 .
1768 .
1769 .ie \n[@STUPID_DRAWING_POSITIONING]=1 \{\
1770 .IP \[bu] 2m
1771 The position changing after the commands
1772 .BR Dp ,
1773 .BR DP ,
1774 and
1775 .B Dt
1776 is illogical, but as old versions of groff used this feature it is
1777 kept for compatibility reasons.
1778 .\} \" @STUPID_DRAWING_POSITIONING
1779 .el \{\
1780 .IP \[bu] 2m
1781 Temporarily, there existed some confusion on the positioning after the
1782 .B D
1783 commands that are
1784 .I groff
1785 extensions.
1786 .
1787 This has been clarified by establishing the classical rule for all
1788 groff drawing commands:
1789 .
1790 .
1791 .RS
1792 .P
1793 .ft I
1794 The position after a graphic object has been drawn is at its end;
1795 for circles and ellipses, the "end" is at the right side.
1796 .ft
1797 .RE
1798 .
1799 .
1800 .P
1801 From this, the positionings specified for the drawing commands above
1802 follow quite naturally.
1803 .\} \" @STUPID_DRAWING_POSITIONING
1804 .
1805 .P
1806 The differences between
1807 .I groff
1808 and
1809 .I classical troff
1810 are documented in
1811 .MR groff_diff 7 .
1812 .
1813 .
1814 .\" ====================================================================
1815 .SH Files
1816 .\" ====================================================================
1817 .
1818 .TP
1819 .IR /usr/\:\%share/\:\%groff/\:\%1.23.0/\:\%font/\:\%dev name /\:DESC
1820 describes the output device
1821 .IR name .
1822 .
1823 .
1824 .br
1825 .ne 4v
1826 .\" ====================================================================
1827 .SH Authors
1828 .\" ====================================================================
1829 .
1830 James Clark wrote an early version of this document,
1831 which described only the differences between AT&T
1832 device-independent
1833 .IR troff 's
1834 output format and that of GNU
1835 .IR roff .
1836 .
1837 The present version was completely rewritten in 2001 by
1838 .MT groff\-bernd\:.warken\-72@\:web\:.de
1839 Bernd Warken
1840 .ME .
1841 .
1842 .
1843 .\" ====================================================================
1844 .SH "See also"
1845 .\" ====================================================================
1846 .
1847 .P
1848 .IR "Groff: The GNU Implementation of troff" ,
1849 by Trent A.\& Fisher and Werner Lemberg,
1850 is the primary
1851 .I groff
1852 manual.
1853 .
1854 You can browse it interactively with \[lq]info groff\[rq].
1855 .
1856 .
1857 .P
1858 \[lq]Troff User's Manual\[rq]
1859 by Joseph F.\& Ossanna,
1860 1976
1861 (revised by Brian W.\& Kernighan,
1862 1992),
1863 AT&T Bell Laboratories Computing Science Technical Report No.\& 54,
1864 widely called simply \[lq]CSTR\~#54\[rq],
1865 documents the language,
1866 device and font description file formats,
1867 and device-independent output format
1868 referred to collectively in
1869 .I groff
1870 documentation as
1871 .RI \[lq]AT&T\~ troff \[rq].
1872 .
1873 .
1874 .P
1875 \[lq]A Typesetter-independent TROFF\[rq]
1876 by Brian W.\& Kernighan,
1877 1982,
1878 AT&T Bell Laboratories Computing Science Technical Report No.\& 97,
1879 provides additional insights into the
1880 device and font description file formats
1881 and device-independent output format.
1882 .
1883 .
1884 .TP
1885 .MR groff 1
1886 documents the
1887 .B \-Z
1888 option and contains pointers to further
1889 .I groff
1890 documentation.
1891 .
1892 .
1893 .TP
1894 .MR groff 7
1895 describes the
1896 .I groff
1897 language,
1898 including its escape sequences and system of units.
1899 .
1900 .
1901 .TP
1902 .MR groff_font 5
1903 details the device scaling parameters of device
1904 .I DESC
1905 files.
1906 .
1907 .
1908 .TP
1909 .MR \%troff 1
1910 generates the device-independent intermediate output documented here.
1911 .
1912 .
1913 .TP
1914 .MR roff 7
1915 presents historical aspects and the general structure of
1916 .I roff
1917 systems.
1918 .
1919 .
1920 .TP
1921 .MR groff_diff 7
1922 enumerates differences between the intermediate output produced by AT&T
1923 .I troff \" AT&T
1924 and that of
1925 .IR groff .
1926 .
1927 .
1928 .TP
1929 .MR gxditview 1
1930 is a viewer for intermediate output.
1931 .
1932 .
1933 .TP
1934 .UR https://\:github.com/\:Alhadis/\:Roff\:.js/
1935 .I Roff.js
1936 .UE
1937 is a viewer for intermediate output written in JavaScript.
1938 .
1939 .
1940 .P
1941 .MR grodvi 1 ,
1942 .MR grohtml 1 ,
1943 .MR grolbp 1 ,
1944 .MR grolj4 1 ,
1945 .MR gropdf 1 ,
1946 .MR grops 1 ,
1947 and
1948 .MR grotty 1
1949 are
1950 .I groff
1951 postprocessors.
1952 .
1953 .
1954 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
1955 .cp \n[*groff_groff_out_5_man_C]
1956 .do rr *groff_groff_out_5_man_C
1957 .
1958 .
1959 .\" Local Variables:
1960 .\" fill-column: 72
1961 .\" mode: nroff
1962 .\" End:
1963 .\" vim: set filetype=groff textwidth=72: