Debian Codegraph @

upstream/debian-trixie/man5/groff_font.5

raw
1 .TH groff_font 5 "3 June 2025" "groff 1.23.0"
2 .SH Name
3 groff_font \- GNU
4 .I roff
5 device and font description files
6 .
7 .
8 .\" ====================================================================
9 .\" Legal Terms
10 .\" ====================================================================
11 .\"
12 .\" Copyright (C) 1989-2021 Free Software Foundation, Inc.
13 .\"
14 .\" This file is part of groff (GNU roff), which is a free software
15 .\" project.
16 .\"
17 .\" You can redistribute it and/or modify it under the terms of the GNU
18 .\" General Public License as published by the Free Software Foundation,
19 .\" either version 2 of the License, or (at your option) any later
20 .\" version.
21 .\"
22 .\" You should have received a copy of the GNU General Public License
23 .\" along with this program. If not, see
24 .\" <http://www.gnu.org/licenses/gpl-2.0.html>.
25 .
26 .
27 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
28 .do nr *groff_groff_font_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 .SH Description
49 .\" ====================================================================
50 .
51 .\" BEGIN Keep parallel with groff.texi node "Device and Font Files".
52 The
53 .I groff
54 font and output device description formats are slight
55 extensions of those used by AT&T device-independent
56 .IR troff . \" AT&T
57 .
58 In distinction to the AT&T implementation,
59 .I groff
60 lacks a binary format;
61 all files are text files.
62 .
63 (Plan\~9
64 .I troff \" Plan 9
65 has also abandoned the binary format.)
66 .
67 The device and font description files for a device
68 .I name
69 are stored in a
70 .IR dev name
71 directory.
72 .
73 The device description file is called
74 .IR DESC ,
75 and,
76 for each font supported by the device,
77 a font description file is
78 .RI called\~ f,
79 where
80 .IR f \~is
81 usually an abbreviation of a font's name and/or style.
82 .
83 For example,
84 the
85 .B ps
86 (PostScript)
87 device has
88 .I groff
89 font description files for Times roman
90 .RB ( TR )
91 and Zapf Chancery Medium italic
92 .RB ( ZCMI ),
93 among many others,
94 while the
95 .B utf8
96 device
97 (for terminal emulators)
98 has only font descriptions for the roman,
99 italic,
100 bold,
101 and bold-italic styles
102 .RB ( R ,
103 .BR I ,
104 .BR B ,
105 and
106 .BR BI ,
107 respectively).
108 .
109 .
110 .P
111 Device and font description files are read by the formatter,
112 .IR \%troff ,
113 and by output drivers.
114 .
115 The programs typically delegate these files' processing to an internal
116 library,
117 .IR libgroff ,
118 ensuring their consistent interpretation.
119 .
120 .
121 .\" ====================================================================
122 .SH "\f[I]DESC\f[] file format"
123 .\" ====================================================================
124 .
125 The
126 .I DESC
127 file contains a series of directives;
128 each begins a line.
129 .
130 Their order is not important,
131 with two exceptions:
132 (1) the
133 .B res
134 directive must precede any
135 .B \%papersize
136 directive;
137 and
138 (2) the
139 .B charset
140 directive must come last
141 (if at all).
142 .
143 If a directive name is repeated,
144 later entries in the file override previous ones
145 (except that the paper dimensions are computed based on the
146 .B res
147 directive last seen when
148 .B \%papersize
149 is encountered).
150 .
151 Spaces and/or tabs separate words and are ignored at line boundaries.
152 .
153 Comments start with the
154 .RB \[lq] # \[rq]
155 character and extend to the end of a line.
156 .
157 Empty lines are ignored.
158 .
159 .
160 .TP
161 .BI family\~ fam
162 The default font family is
163 .IR fam .
164 .
165 .
166 .TP
167 .BI fonts\~ "n F1"\~\c
168 .RI .\|.\|.\&\~ Fn
169 Fonts
170 .IR F1 ", \|.\|.\|.\|, " Fn
171 are mounted at font positions
172 .IR m "\|+\|1, \|.\|.\|., " m \|+\| n
173 where
174 .I m
175 is the number of
176 .B styles
177 (see below).
178 .
179 This directive may extend over more than one line.
180 .
181 A font name
182 .RB of\~ 0
183 causes no font to be mounted at the corresponding position.
184 .
185 .
186 .TP
187 .BI hor\~ n
188 The horizontal motion quantum is
189 .IR n \~basic
190 units.
191 .
192 Horizontal quantities are rounded to multiples
193 .RI of\~ n.
194 .
195 .
196 .TP
197 .BI image_generator\~ program
198 Use
199 .I program
200 to generate PNG images from PostScript input.
201 .
202 Under GNU/Linux,
203 this is usually
204 .MR gs 1 ,
205 but under other systems
206 (notably Cygwin)
207 it might be set to another name.
208 .
209 The
210 .MR grohtml 1
211 driver uses this directive.
212 .
213 .
214 .TP
215 .BI paperlength\~ n
216 The vertical dimension of the output medium is
217 .IR n \~basic
218 units
219 (deprecated:
220 use
221 .B \%papersize
222 instead).
223 .
224 .
225 .TP
226 .BI papersize\~ format-or-dimension-pair-or-file-name\c
227 \~.\|.\|.
228 The dimensions of the output medium are as according to the
229 argument,
230 which is either
231 a standard paper format,
232 a pair of dimensions,
233 or the name of a plain text file containing either of the foregoing.
234 .
235 Recognized paper formats are the ISO and DIN formats
236 .BR A0 \[en] A7 ,
237 .BR B0 \[en] B7 ,
238 .BR C0 \[en] C7 ,
239 and
240 .BR D0 \[en] D7 ;
241 .\" XXX: tmac/papersize.tmac does not support [ABCD]7.
242 the U.S.\& formats
243 .BR letter ,
244 .BR legal ,
245 .BR tabloid ,
246 .BR ledger ,
247 .BR statement ,
248 and
249 .BR executive ;
250 and the envelope formats
251 .BR com10 ,
252 .BR monarch ,
253 and
254 .BR DL .
255 .
256 Matching is performed without regard for lettercase.
257 .
258 .
259 .IP
260 Alternatively,
261 the argument can be a custom paper format
262 .IB length , width
263 (with no spaces before or after the comma).
264 .
265 Both
266 .I length
267 and
268 .I width
269 must have a unit appended;
270 valid units are
271 .RB \[lq] i \[rq]
272 for inches,
273 .RB \[lq] c \[rq]
274 for centimeters,
275 .RB \[lq] p \[rq]
276 for points,
277 and
278 .RB \[lq] P \[rq]
279 for picas.
280 .
281 Example:
282 .RB \[lq] 12c,235p \[rq].
283 .
284 An argument that starts with a digit is always treated as a custom paper
285 format.
286 .
287 .
288 .IP
289 Finally,
290 the argument can be a file name
291 (e.g.,
292 .IR /etc/papersize );
293 if the file can be opened,
294 the first line is read and a match attempted against each other form.
295 .
296 No comment syntax is supported.
297 .
298 .
299 .IP
300 More than one argument can be specified;
301 each is scanned in turn and the first valid paper specification used.
302 .
303 .
304 .TP
305 .BI paperwidth\~ n
306 The horizontal dimension of the output medium is
307 .IR n \~basic
308 units
309 (deprecated:
310 use
311 .B \%papersize
312 instead).
313 .
314 .
315 .TP
316 .B pass_filenames
317 Direct
318 .I \%troff
319 to emit the name of the source file being processed.
320 .
321 This is achieved with the intermediate output command
322 .RB \[lq] "x F" \[rq],
323 which
324 .I \%grohtml
325 interprets.
326 .
327 .
328 .TP
329 .BI postpro\~ program
330 Use
331 .I program
332 as the postprocessor.
333 .
334 .
335 .TP
336 .BI prepro\~ program
337 Use
338 .I program
339 as a preprocessor.
340 .
341 The
342 .B html
343 and
344 .B xhtml
345 output devices use this directive.
346 .
347 .
348 .TP
349 .BI print\~ program
350 Use
351 .I program
352 as the print spooler.
353 .
354 If omitted,
355 .IR groff 's
356 .B \-l
357 and
358 .B \-L
359 options are ignored.
360 .
361 .
362 .TP
363 .BI res\~ n
364 The device resolution is
365 .I n
366 basic units per inch.
367 .
368 .
369 .TP
370 .BI sizes\~ s1\~\c
371 .RI .\|.\|.\&\~ sn\~\c
372 .B 0
373 The device has fonts at
374 .IR s1 ,
375 \&.\|.\|.,
376 .I sn
377 scaled points
378 (see below).
379 .
380 The list of sizes must be terminated by
381 .RB a\~ 0 .
382 .
383 Each
384 .I si
385 can also be a range of sizes
386 .IR m \[en] n .
387 .
388 The list can extend over more than one line.
389 .
390 .
391 .TP
392 .BI sizescale\~ n
393 A typographical point
394 is subdivided into
395 .IR n \~scaled
396 points.
397 .
398 The default
399 .RB is\~ 1 .
400 .
401 .
402 .TP
403 .BI styles\~ S1\~\c
404 .RI .\|.\|.\&\~ Sm
405 The
406 .RI first\~ m
407 font mounting positions are associated with styles
408 .IR S1 ,
409 \&.\|.\|.,
410 .IR Sm .
411 .
412 .
413 .TP
414 .B tcommand
415 The postprocessor can handle the
416 .B t
417 .RB and\~ u
418 intermediate output commands.
419 .
420 .
421 .TP
422 .B unicode
423 The output device supports the complete Unicode repertoire.
424 .
425 This directive is useful only for devices which produce character
426 entities instead of glyphs.
427 .
428 .
429 .IP
430 If
431 .B unicode
432 is present,
433 no
434 .B charset
435 section is required in the font description files since the Unicode
436 handling built into
437 .I groff
438 is used.
439 .
440 However,
441 if there are entries in a font description file's
442 .B charset
443 section,
444 they either override the default mappings for those particular
445 characters or add new mappings
446 (normally for composite characters).
447 .
448 .
449 .IP
450 The
451 .BR utf8 ,
452 .BR html ,
453 and
454 .B xhtml
455 output devices use this directive.
456 .
457 .
458 .TP
459 .BI unitwidth\~ n
460 Quantities in the font description files are in basic units for fonts
461 whose type size is
462 .IR n \~scaled
463 points.
464 .
465 .
466 .TP
467 .B unscaled_charwidths
468 Make the font handling module always return unscaled glyph widths.
469 .
470 The
471 .I \%grohtml
472 driver uses this directive.
473 .
474 .
475 .TP
476 .B use_charnames_in_special
477 .I \%troff
478 should encode named glyphs inside device control commands.
479 .
480 The
481 .I \%grohtml
482 driver uses this directive.
483 .
484 .
485 .TP
486 .BI vert\~ n
487 The vertical motion quantum is
488 .IR n \~basic
489 units.
490 .
491 Vertical quantities are rounded to multiples
492 .RI of\~ n.
493 .
494 .
495 .TP
496 .B charset
497 This directive and the rest of the file are ignored.
498 .
499 It is recognized for compatibility with other
500 .I troff \" generic
501 implementations.
502 .
503 In GNU
504 .IR troff , \" GNU
505 character set repertoire is described on a per-font basis.
506 .
507 .
508 .P
509 .I \%troff
510 recognizes but ignores the directives
511 .BR spare1 ,
512 .BR spare2 ,
513 and
514 .BR biggestfont .
515 .
516 .
517 .P
518 The
519 .BR res ,
520 .BR unitwidth ,
521 .BR fonts ,
522 and
523 .B sizes
524 lines are mandatory.
525 .
526 Directives not listed above are ignored by
527 .I \%troff
528 but may be used by postprocessors to obtain further information about
529 the device.
530 .
531 .
532 .\" ====================================================================
533 .SH "Font description file format"
534 .\" ====================================================================
535 .
536 On typesetting output devices,
537 each font is typically available at multiple sizes.
538 .
539 While paper measurements in the device description file are in absolute
540 units,
541 measurements applicable to fonts must be proportional to the type size.
542 .
543 .I groff
544 achieves this using the precedent set by AT&T device-independent
545 .IR troff : \" AT&T
546 one font size is chosen as a norm,
547 and all others are scaled linearly relative to that basis.
548 .
549 The \[lq]unit width\[rq] is the number of basic units per point when the
550 font is rendered at this nominal size.
551 .
552 .
553 .P
554 For instance,
555 .IR groff 's
556 .B lbp
557 device uses a
558 .B unitwidth
559 of\~800.
560 .
561 Its Times roman font
562 .RB (\[lq] TR \[rq])
563 has a
564 .B spacewidth
565 of\~833;
566 this is also the width of its comma,
567 period,
568 centered period,
569 and mathematical asterisk,
570 while its \[lq]M\[rq] is 2,963 basic units.
571 .
572 Thus,
573 an \[lq]M\[rq] on the
574 .B lbp
575 device is 2,963 basic units wide at a notional type size of 800\~points.
576 .
577 (800-point type is not practical for most purposes,
578 but using it enables the quantities in the font description files to be
579 expressed as integers.)
580 .
581 .
582 .P
583 A font description file has two sections.
584 .
585 The first is a sequence of directives,
586 and is parsed similarly to the
587 .I DESC
588 file described above.
589 .
590 Except for the directive names that begin the second section,
591 their ordering is immaterial.
592 .
593 Later directives of the same name override earlier ones,
594 spaces and tabs are handled in the same way,
595 and the same comment syntax is supported.
596 .
597 Empty lines are ignored throughout.
598 .
599 .
600 .TP
601 .BI name\~ F
602 The name of the font
603 .RI is\~ F .
604 .
605 .RB \[lq] DESC \[rq]
606 is an invalid font name.
607 .
608 Simple integers are valid,
609 but their use is discouraged.
610 .
611 .RI ( groff
612 requests and escape sequences interpret non-negative font names as
613 mounting positions instead.
614 .
615 Further,
616 a font named
617 .RB \[lq] 0 \[rq]
618 cannot be automatically mounted by the
619 .B fonts
620 directive of a
621 .I DESC
622 file.)
623 .
624 .
625 .TP
626 .BI spacewidth\~ n
627 The width of an unadjusted inter-word space is
628 .IR n \~basic
629 units.
630 .
631 .
632 .P
633 The directives above must appear in the first section;
634 those below are optional.
635 .
636 .
637 .TP
638 .BI slant\~ n
639 The font's glyphs have a slant of
640 .IR n \~degrees;
641 a positive
642 .I n
643 slants in the direction of text flow.
644 .
645 .
646 .TP
647 .BI ligatures\~ lig1\~\c
648 .RI .\|.\|.\&\~ lign\~\c
649 .RB [ 0 ]
650 Glyphs
651 .IR lig1 ,
652 \&.\|.\|.,
653 .I lign
654 are ligatures;
655 possible ligatures are
656 .BR ff ,
657 .BR fi ,
658 .BR fl ,
659 .BR ffi ,
660 and
661 .BR ffl .
662 .
663 For compatibility with other
664 .I troff
665 implementations,
666 the list of ligatures may be terminated with
667 .RB a\~ 0 .
668 .
669 The list of ligatures must not extend over more than one line.
670 .
671 .
672 .TP
673 .B special
674 The font is
675 .IR special :
676 when a glyph is requested that is not present in the current font,
677 it is sought in any mounted fonts that bear this property.
678 .
679 .
680 .P
681 Other directives in this section are ignored by
682 .IR \%troff ,
683 but may be used by postprocessors to obtain further information about
684 the font.
685 .
686 .
687 .P
688 The second section contains one or two subsections.
689 .
690 These can appear in either order;
691 the first one encountered commences the second section.
692 .
693 Each starts with a directive on a line by itself.
694 .
695 A
696 .B charset
697 subsection is mandatory unless the associated
698 .I DESC
699 file contains the
700 .B unicode
701 directive.
702 .
703 Another subsection,
704 .BR \%kernpairs ,
705 is optional.
706 .
707 .
708 .P
709 The directive
710 .B charset
711 starts the character set subsection.
712 .
713 (For typesetter devices,
714 this directive is misnamed since it starts a list of glyphs,
715 not characters.)
716 .
717 It precedes a series of glyph descriptions,
718 one per line.
719 .
720 Each such glyph description comprises a set of fields separated by
721 spaces or tabs and organized as follows.
722 .
723 .
724 .IP
725 .I name metrics type code
726 .RI [ entity-name ]
727 .RB [ \-\-
728 .IR comment ]
729 .
730 .
731 .P
732 .I name
733 identifies the glyph:
734 if
735 .I name
736 is a printable
737 .RI character\~ c ,
738 it corresponds to the
739 .I troff \" generic
740 ordinary
741 .RI character\~ c .
742 .
743 If
744 .I name
745 is a multi-character sequence not beginning with
746 .BR \[rs] ,
747 it corresponds to the GNU
748 .I troff \" GNU
749 special character escape sequence
750 \[lq]\c
751 .BI \[rs][ name ]\c
752 \[rq].
753 .
754 A name consisting of three minus signs,
755 .RB \[lq] \-\-\- \[rq],
756 indicates that the glyph is unnamed:
757 such glyphs can be accessed only by the
758 .B \[rs]N
759 escape sequence in
760 .IR troff . \" generic; \N is portable
761 .
762 A special character named
763 .RB \[lq] \-\-\- \[rq]
764 can still be defined using
765 .B .char
766 and similar requests.
767 .
768 The
769 .I name
770 .RB \[lq] \[rs]\- \[rq]
771 defines the minus sign glyph.
772 .
773 .\" TODO: Withdraw support for this. No one seems to use it.
774 Finally,
775 .I name
776 can be the horizontal motion escape sequences,
777 .B \[rs]|
778 and
779 .B \[rs]\[ha]
780 (\[lq]thin\[rq] and \[lq]hair\[rq] spaces,
781 respectively),
782 in which case only the width metric described below is applied;
783 a font can thus customize the widths of these spaces.
784 .\" XXX: For exhaustivity purposes...you can define "\whatever", which
785 .\" has to be accessed with \C'\\whatever' or \[\\whatever], but the
786 .\" parser matches predefined escape sequences before looking up special
787 .\" characters. Most such definitions are inaccessible from the
788 .\" language, because nearly every '\x', where 'x' is a Unicode basic
789 .\" Latin character, is a predefined groff escape sequence.
790 .
791 .
792 .br
793 .ne 4v \" Keep next paragraph together with (possibly 2-line) synopsis.
794 .P
795 The form of the
796 .I metrics
797 field is as follows
798 (on one line;
799 it may be broken here for readability).
800 .
801 .
802 .IP
803 .\" XXX: Turning off adjustment is ugly; thanks to meter-long specimens
804 .\" like this, we need an escape sequence that selectively disables
805 .\" adjustment at the end of a word.
806 .na
807 .I width\/\c
808 .RI [\fB,\fP[ \:height\/\c
809 .RI [\fB,\fP[ \:depth\/\c
810 .RI [\fB,\fP[ \:\%italic-correction\/\c
811 .RI [\fB,\fP[ \:\%left-italic-correction\/\c
812 .RI [\fB,\fP[ \:\%subscript-correction ]]]]]]]]]]
813 .ad \*[AD]
814 .
815 .
816 .P
817 There must not be any spaces,
818 tabs,
819 or newlines between these
820 .I subfields,
821 .
822 which are in basic units expressed as decimal integers.
823 .
824 Unspecified subfields default
825 .RB to\~ 0 .
826 .
827 Since there is no associated binary format,
828 these values are not required to fit into the C language data type
829 .B char
830 as they are in AT&T device-independent
831 .IR troff . \" AT&T
832 .
833 .
834 .P
835 The
836 .I width
837 subfield gives the width of the glyph.
838 .
839 The
840 .I height
841 subfield gives the height of the glyph
842 (upwards is positive);
843 if a glyph does not extend above the baseline,
844 it should be given a zero height,
845 rather than a negative height.
846 .
847 The
848 .I depth
849 subfield gives the depth of the glyph,
850 that is,
851 the distance below the baseline to which the glyph extends
852 (downwards is positive);
853 if a glyph does not extend below the baseline,
854 it should be given a zero depth,
855 rather than a negative depth.
856 .
857 Italic corrections are relevant to glyphs in italic or oblique styles.
858 .
859 The
860 .I italic-correction
861 is the amount of space that should be added after an oblique glyph to be
862 followed immediately by an upright glyph.
863 .
864 The
865 .I left-italic-correction
866 is the amount of space that should be added before an oblique glyph to
867 be preceded immediately by an upright glyph.
868 .
869 The
870 .I
871 subscript-correction
872 is the amount of space that should be added after an oblique glyph to be
873 followed by a subscript;
874 it should be less than the italic correction.
875 .
876 .
877 .P
878 For fonts used with typesetting devices,
879 the
880 .I type
881 field gives a featural description of the glyph:
882 it is a bit mask recording whether the glyph is an ascender,
883 descender,
884 both,
885 or neither.
886 .
887 When a
888 .B \[rs]w
889 escape sequence is interpolated,
890 these values are bitwise or-ed together
891 for each glyph
892 and stored in the
893 .B ct
894 register.
895 .
896 In font descriptions for terminal devices,
897 all glyphs might have a type of zero,
898 regardless of their appearance.
899 .
900 .
901 .TP
902 0
903 means the glyph lies entirely between the baseline and
904 a horizontal line at the \[lq]x-height\[rq] of the font,
905 as with \[lq]a\[rq],
906 \[lq]c\[rq],
907 and
908 \[lq]x\[rq];
909 .
910 .
911 .TP
912 1
913 means the glyph descends below the baseline,
914 like \[lq]p\[rq];
915 .
916 .
917 .TP
918 2
919 means the glyph ascends above the font's x-height,
920 like \[lq]A\[rq] or
921 \[lq]b\[rq]);
922 and
923 .
924 .
925 .TP
926 3
927 means the glyph is both an ascender and a descender\[em]this is true of
928 parentheses in some fonts.
929 .
930 .
931 .P
932 The
933 .I code
934 field gives a numeric identifier that the postprocessor uses to render
935 the glyph.
936 .
937 The glyph can be specified to
938 .I troff \" generic
939 using this code by means of the
940 .B \[rs]N
941 escape sequence.
942 .
943 The code can be any integer
944 (that is,
945 any integer parsable by the C standard library's
946 .MR strtol 3
947 function).
948 .
949 .
950 .P
951 The
952 .I entity-name
953 field defines an identifier for the glyph that the postprocessor
954 uses to print the
955 .I \%troff
956 glyph
957 .IR name .
958 .
959 This field is optional;
960 it was introduced so that the
961 .I \%grohtml
962 output driver could encode its character set.
963 .
964 For example,
965 the glyph
966 .B \[rs][Po]
967 is represented by
968 .RB \[lq] &pound; \[rq]
969 in HTML 4.0.
970 .
971 For efficiency,
972 these data are now compiled directly into
973 .IR \%grohtml .
974 .
975 .I grops
976 uses the field to build sub-encoding arrays for PostScript fonts
977 containing more than 256 glyphs.
978 .
979 Anything on the line after the
980 .I entity-name
981 field or
982 .RB \[lq] \-\- \[rq]
983 is ignored.
984 .
985 .
986 .P
987 A line in the
988 .B charset
989 section can also have the form
990 .
991 .RS
992 .IB name\~ \[dq]
993 .RE
994 .
995 identifying
996 .I name
997 as another name for the glyph mentioned in the preceding line.
998 .
999 Such aliases can be chained.
1000 .
1001 .
1002 .P
1003 The directive
1004 .B \%kernpairs
1005 starts a list of kerning adjustments to be made to adjacent glyph pairs
1006 from this font.
1007 .
1008 It contains a sequence of lines formatted as follows.
1009 .
1010 .RS
1011 .I g1 g2 n
1012 .RE
1013 .
1014 The foregoing means that when glyph
1015 .I g1
1016 is typeset immediately before
1017 .IR g2 ,
1018 the space between them should be increased
1019 .RI by\~ n .
1020 .
1021 Most kerning pairs should have a negative value
1022 .RI for\~ n .
1023 .\" END Keep parallel with groff.texi node "Device and Font Files".
1024 .
1025 .
1026 .br
1027 .ne 4v
1028 .\" ====================================================================
1029 .SH Files
1030 .\" ====================================================================
1031 .
1032 .TP
1033 .IR /usr/\:\%share/\:\%groff/\:\%1.23.0/\:\%font/\:\%dev name /\:DESC
1034 describes the output device
1035 .IR name .
1036 .
1037 .
1038 .TP
1039 .IR /usr/\:\%share/\:\%groff/\:\%1.23.0/\:\%font/\:\%dev name / F
1040 describes the font known
1041 .RI as\~ F
1042 on device
1043 .IR name .
1044 .
1045 .
1046 .\" ====================================================================
1047 .SH "See also"
1048 .\" ====================================================================
1049 .
1050 .IR "Groff: The GNU Implementation of troff" ,
1051 by Trent A.\& Fisher and Werner Lemberg,
1052 is the primary
1053 .I groff
1054 manual.
1055 .
1056 You can browse it interactively with \[lq]info groff\[rq].
1057 .
1058 .
1059 .P
1060 \[lq]Troff User's Manual\[rq]
1061 by Joseph F.\& Ossanna,
1062 1976
1063 (revised by Brian W.\& Kernighan,
1064 1992),
1065 AT&T Bell Laboratories Computing Science Technical Report No.\& 54,
1066 widely called simply \[lq]CSTR\~#54\[rq],
1067 documents the language,
1068 device and font description file formats,
1069 and device-independent output format
1070 referred to collectively in
1071 .I groff
1072 documentation as
1073 .RI \[lq]AT&T\~ troff \[rq].
1074 .
1075 .
1076 .P
1077 \[lq]A Typesetter-independent TROFF\[rq]
1078 by Brian W.\& Kernighan,
1079 1982,
1080 AT&T Bell Laboratories Computing Science Technical Report No.\& 97,
1081 provides additional insights into the
1082 device and font description file formats
1083 and device-independent output format.
1084 .
1085 .
1086 .P
1087 .MR groff 1 ,
1088 subsection \[lq]Utilities\[rq],
1089 lists programs available for describing fonts in a variety of formats
1090 such that
1091 .I groff
1092 output drivers can use them.
1093 .
1094 .
1095 .P
1096 .MR \%troff 1
1097 documents the default device and font description file search path.
1098 .
1099 .
1100 .P
1101 .MR groff_out 5 ,
1102 .MR addftinfo 1
1103 .
1104 .
1105 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
1106 .cp \n[*groff_groff_font_5_man_C]
1107 .do rr *groff_groff_font_5_man_C
1108 .
1109 .
1110 .\" Local Variables:
1111 .\" fill-column: 72
1112 .\" mode: nroff
1113 .\" End:
1114 .\" vim: set filetype=groff textwidth=72: