Debian Codegraph @

upstream/debian-trixie/man5/groff_out.5

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