Debian Codegraph @

upstream/opensuse-tumbleweed/man5/groff_font.5

raw
1 .TH groff_font 5 "2 March 2026" "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 Or,
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 Finally
300 .I string
301 can be a keyword locale, so
302 .B groff
303 will determine the papersize from system locale (LC_PAPER).
304 .IP
305 .
306 More than one argument can be specified;
307 each is scanned in turn and the first valid paper specification used.
308 .
309 .
310 .TP
311 .BI paperwidth\~ n
312 The horizontal dimension of the output medium is
313 .IR n \~basic
314 units
315 (deprecated:
316 use
317 .B \%papersize
318 instead).
319 .
320 .
321 .TP
322 .B pass_filenames
323 Direct
324 .I \%troff
325 to emit the name of the source file being processed.
326 .
327 This is achieved with the intermediate output command
328 .RB \[lq] "x F" \[rq],
329 which
330 .I \%grohtml
331 interprets.
332 .
333 .
334 .TP
335 .BI postpro\~ program
336 Use
337 .I program
338 as the postprocessor.
339 .
340 .
341 .TP
342 .BI prepro\~ program
343 Use
344 .I program
345 as a preprocessor.
346 .
347 The
348 .B html
349 and
350 .B xhtml
351 output devices use this directive.
352 .
353 .
354 .TP
355 .BI print\~ program
356 Use
357 .I program
358 as the print spooler.
359 .
360 If omitted,
361 .IR groff 's
362 .B \-l
363 and
364 .B \-L
365 options are ignored.
366 .
367 .
368 .TP
369 .BI res\~ n
370 The device resolution is
371 .I n
372 basic units per inch.
373 .
374 .
375 .TP
376 .BI sizes\~ s1\~\c
377 .RI .\|.\|.\&\~ sn\~\c
378 .B 0
379 The device has fonts at
380 .IR s1 ,
381 \&.\|.\|.,
382 .I sn
383 scaled points
384 (see below).
385 .
386 The list of sizes must be terminated by
387 .RB a\~ 0 .
388 .
389 Each
390 .I si
391 can also be a range of sizes
392 .IR m \[en] n .
393 .
394 The list can extend over more than one line.
395 .
396 .
397 .TP
398 .BI sizescale\~ n
399 A typographical point
400 is subdivided into
401 .IR n \~scaled
402 points.
403 .
404 The default
405 .RB is\~ 1 .
406 .
407 .
408 .TP
409 .BI styles\~ S1\~\c
410 .RI .\|.\|.\&\~ Sm
411 The
412 .RI first\~ m
413 font mounting positions are associated with styles
414 .IR S1 ,
415 \&.\|.\|.,
416 .IR Sm .
417 .
418 .
419 .TP
420 .B tcommand
421 The postprocessor can handle the
422 .B t
423 .RB and\~ u
424 intermediate output commands.
425 .
426 .
427 .TP
428 .B unicode
429 The output device supports the complete Unicode repertoire.
430 .
431 This directive is useful only for devices which produce character
432 entities instead of glyphs.
433 .
434 .
435 .IP
436 If
437 .B unicode
438 is present,
439 no
440 .B charset
441 section is required in the font description files since the Unicode
442 handling built into
443 .I groff
444 is used.
445 .
446 However,
447 if there are entries in a font description file's
448 .B charset
449 section,
450 they either override the default mappings for those particular
451 characters or add new mappings
452 (normally for composite characters).
453 .
454 .
455 .IP
456 The
457 .BR utf8 ,
458 .BR html ,
459 and
460 .B xhtml
461 output devices use this directive.
462 .
463 .
464 .TP
465 .BI unitwidth\~ n
466 Quantities in the font description files are in basic units for fonts
467 whose type size is
468 .IR n \~scaled
469 points.
470 .
471 .
472 .TP
473 .B unscaled_charwidths
474 Make the font handling module always return unscaled glyph widths.
475 .
476 The
477 .I \%grohtml
478 driver uses this directive.
479 .
480 .
481 .TP
482 .B use_charnames_in_special
483 .I \%troff
484 should encode named glyphs inside device control commands.
485 .
486 The
487 .I \%grohtml
488 driver uses this directive.
489 .
490 .
491 .TP
492 .BI vert\~ n
493 The vertical motion quantum is
494 .IR n \~basic
495 units.
496 .
497 Vertical quantities are rounded to multiples
498 .RI of\~ n.
499 .
500 .
501 .TP
502 .B charset
503 This directive and the rest of the file are ignored.
504 .
505 It is recognized for compatibility with other
506 .I troff \" generic
507 implementations.
508 .
509 In GNU
510 .IR troff , \" GNU
511 character set repertoire is described on a per-font basis.
512 .
513 .
514 .P
515 .I \%troff
516 recognizes but ignores the directives
517 .BR spare1 ,
518 .BR spare2 ,
519 and
520 .BR biggestfont .
521 .
522 .
523 .P
524 The
525 .BR res ,
526 .BR unitwidth ,
527 .BR fonts ,
528 and
529 .B sizes
530 lines are mandatory.
531 .
532 Directives not listed above are ignored by
533 .I \%troff
534 but may be used by postprocessors to obtain further information about
535 the device.
536 .
537 .
538 .\" ====================================================================
539 .SH "Font description file format"
540 .\" ====================================================================
541 .
542 On typesetting output devices,
543 each font is typically available at multiple sizes.
544 .
545 While paper measurements in the device description file are in absolute
546 units,
547 measurements applicable to fonts must be proportional to the type size.
548 .
549 .I groff
550 achieves this using the precedent set by AT&T device-independent
551 .IR troff : \" AT&T
552 one font size is chosen as a norm,
553 and all others are scaled linearly relative to that basis.
554 .
555 The \[lq]unit width\[rq] is the number of basic units per point when the
556 font is rendered at this nominal size.
557 .
558 .
559 .P
560 For instance,
561 .IR groff 's
562 .B lbp
563 device uses a
564 .B unitwidth
565 of\~800.
566 .
567 Its Times roman font
568 .RB (\[lq] TR \[rq])
569 has a
570 .B spacewidth
571 of\~833;
572 this is also the width of its comma,
573 period,
574 centered period,
575 and mathematical asterisk,
576 while its \[lq]M\[rq] is 2,963 basic units.
577 .
578 Thus,
579 an \[lq]M\[rq] on the
580 .B lbp
581 device is 2,963 basic units wide at a notional type size of 800\~points.
582 .
583 (800-point type is not practical for most purposes,
584 but using it enables the quantities in the font description files to be
585 expressed as integers.)
586 .
587 .
588 .P
589 A font description file has two sections.
590 .
591 The first is a sequence of directives,
592 and is parsed similarly to the
593 .I DESC
594 file described above.
595 .
596 Except for the directive names that begin the second section,
597 their ordering is immaterial.
598 .
599 Later directives of the same name override earlier ones,
600 spaces and tabs are handled in the same way,
601 and the same comment syntax is supported.
602 .
603 Empty lines are ignored throughout.
604 .
605 .
606 .TP
607 .BI name\~ F
608 The name of the font
609 .RI is\~ F .
610 .
611 .RB \[lq] DESC \[rq]
612 is an invalid font name.
613 .
614 Simple integers are valid,
615 but their use is discouraged.
616 .
617 .RI ( groff
618 requests and escape sequences interpret non-negative font names as
619 mounting positions instead.
620 .
621 Further,
622 a font named
623 .RB \[lq] 0 \[rq]
624 cannot be automatically mounted by the
625 .B fonts
626 directive of a
627 .I DESC
628 file.)
629 .
630 .
631 .TP
632 .BI spacewidth\~ n
633 The width of an unadjusted inter-word space is
634 .IR n \~basic
635 units.
636 .
637 .
638 .P
639 The directives above must appear in the first section;
640 those below are optional.
641 .
642 .
643 .TP
644 .BI slant\~ n
645 The font's glyphs have a slant of
646 .IR n \~degrees;
647 a positive
648 .I n
649 slants in the direction of text flow.
650 .
651 .
652 .TP
653 .BI ligatures\~ lig1\~\c
654 .RI .\|.\|.\&\~ lign\~\c
655 .RB [ 0 ]
656 Glyphs
657 .IR lig1 ,
658 \&.\|.\|.,
659 .I lign
660 are ligatures;
661 possible ligatures are
662 .BR ff ,
663 .BR fi ,
664 .BR fl ,
665 .BR ffi ,
666 and
667 .BR ffl .
668 .
669 For compatibility with other
670 .I troff
671 implementations,
672 the list of ligatures may be terminated with
673 .RB a\~ 0 .
674 .
675 The list of ligatures must not extend over more than one line.
676 .
677 .
678 .TP
679 .B special
680 The font is
681 .IR special :
682 when a glyph is requested that is not present in the current font,
683 it is sought in any mounted fonts that bear this property.
684 .
685 .
686 .P
687 Other directives in this section are ignored by
688 .IR \%troff ,
689 but may be used by postprocessors to obtain further information about
690 the font.
691 .
692 .
693 .P
694 The second section contains one or two subsections.
695 .
696 These can appear in either order;
697 the first one encountered commences the second section.
698 .
699 Each starts with a directive on a line by itself.
700 .
701 A
702 .B charset
703 subsection is mandatory unless the associated
704 .I DESC
705 file contains the
706 .B unicode
707 directive.
708 .
709 Another subsection,
710 .BR \%kernpairs ,
711 is optional.
712 .
713 .
714 .P
715 The directive
716 .B charset
717 starts the character set subsection.
718 .
719 (For typesetter devices,
720 this directive is misnamed since it starts a list of glyphs,
721 not characters.)
722 .
723 It precedes a series of glyph descriptions,
724 one per line.
725 .
726 Each such glyph description comprises a set of fields separated by
727 spaces or tabs and organized as follows.
728 .
729 .
730 .IP
731 .I name metrics type code
732 .RI [ entity-name ]
733 .RB [ \-\-
734 .IR comment ]
735 .
736 .
737 .P
738 .I name
739 identifies the glyph:
740 if
741 .I name
742 is a printable
743 .RI character\~ c ,
744 it corresponds to the
745 .I troff \" generic
746 ordinary
747 .RI character\~ c .
748 .
749 If
750 .I name
751 is a multi-character sequence not beginning with
752 .BR \[rs] ,
753 it corresponds to the GNU
754 .I troff \" GNU
755 special character escape sequence
756 \[lq]\c
757 .BI \[rs][ name ]\c
758 \[rq].
759 .
760 A name consisting of three minus signs,
761 .RB \[lq] \-\-\- \[rq],
762 indicates that the glyph is unnamed:
763 such glyphs can be accessed only by the
764 .B \[rs]N
765 escape sequence in
766 .IR troff . \" generic; \N is portable
767 .
768 A special character named
769 .RB \[lq] \-\-\- \[rq]
770 can still be defined using
771 .B .char
772 and similar requests.
773 .
774 The
775 .I name
776 .RB \[lq] \[rs]\- \[rq]
777 defines the minus sign glyph.
778 .
779 .\" TODO: Withdraw support for this. No one seems to use it.
780 Finally,
781 .I name
782 can be the horizontal motion escape sequences,
783 .B \[rs]|
784 and
785 .B \[rs]\[ha]
786 (\[lq]thin\[rq] and \[lq]hair\[rq] spaces,
787 respectively),
788 in which case only the width metric described below is applied;
789 a font can thus customize the widths of these spaces.
790 .\" XXX: For exhaustivity purposes...you can define "\whatever", which
791 .\" has to be accessed with \C'\\whatever' or \[\\whatever], but the
792 .\" parser matches predefined escape sequences before looking up special
793 .\" characters. Most such definitions are inaccessible from the
794 .\" language, because nearly every '\x', where 'x' is a Unicode basic
795 .\" Latin character, is a predefined groff escape sequence.
796 .
797 .
798 .br
799 .ne 4v \" Keep next paragraph together with (possibly 2-line) synopsis.
800 .P
801 The form of the
802 .I metrics
803 field is as follows
804 (on one line;
805 it may be broken here for readability).
806 .
807 .
808 .IP
809 .\" XXX: Turning off adjustment is ugly; thanks to meter-long specimens
810 .\" like this, we need an escape sequence that selectively disables
811 .\" adjustment at the end of a word.
812 .na
813 .I width\/\c
814 .RI [\fB,\fP[ \:height\/\c
815 .RI [\fB,\fP[ \:depth\/\c
816 .RI [\fB,\fP[ \:\%italic-correction\/\c
817 .RI [\fB,\fP[ \:\%left-italic-correction\/\c
818 .RI [\fB,\fP[ \:\%subscript-correction ]]]]]]]]]]
819 .ad \*[AD]
820 .
821 .
822 .P
823 There must not be any spaces,
824 tabs,
825 or newlines between these
826 .I subfields,
827 .
828 which are in basic units expressed as decimal integers.
829 .
830 Unspecified subfields default
831 .RB to\~ 0 .
832 .
833 Since there is no associated binary format,
834 these values are not required to fit into the C language data type
835 .B char
836 as they are in AT&T device-independent
837 .IR troff . \" AT&T
838 .
839 .
840 .P
841 The
842 .I width
843 subfield gives the width of the glyph.
844 .
845 The
846 .I height
847 subfield gives the height of the glyph
848 (upwards is positive);
849 if a glyph does not extend above the baseline,
850 it should be given a zero height,
851 rather than a negative height.
852 .
853 The
854 .I depth
855 subfield gives the depth of the glyph,
856 that is,
857 the distance below the baseline to which the glyph extends
858 (downwards is positive);
859 if a glyph does not extend below the baseline,
860 it should be given a zero depth,
861 rather than a negative depth.
862 .
863 Italic corrections are relevant to glyphs in italic or oblique styles.
864 .
865 The
866 .I italic-correction
867 is the amount of space that should be added after an oblique glyph to be
868 followed immediately by an upright glyph.
869 .
870 The
871 .I left-italic-correction
872 is the amount of space that should be added before an oblique glyph to
873 be preceded immediately by an upright glyph.
874 .
875 The
876 .I
877 subscript-correction
878 is the amount of space that should be added after an oblique glyph to be
879 followed by a subscript;
880 it should be less than the italic correction.
881 .
882 .
883 .P
884 For fonts used with typesetting devices,
885 the
886 .I type
887 field gives a featural description of the glyph:
888 it is a bit mask recording whether the glyph is an ascender,
889 descender,
890 both,
891 or neither.
892 .
893 When a
894 .B \[rs]w
895 escape sequence is interpolated,
896 these values are bitwise or-ed together
897 for each glyph
898 and stored in the
899 .B ct
900 register.
901 .
902 In font descriptions for terminal devices,
903 all glyphs might have a type of zero,
904 regardless of their appearance.
905 .
906 .
907 .TP
908 0
909 means the glyph lies entirely between the baseline and
910 a horizontal line at the \[lq]x-height\[rq] of the font,
911 as with \[lq]a\[rq],
912 \[lq]c\[rq],
913 and
914 \[lq]x\[rq];
915 .
916 .
917 .TP
918 1
919 means the glyph descends below the baseline,
920 like \[lq]p\[rq];
921 .
922 .
923 .TP
924 2
925 means the glyph ascends above the font's x-height,
926 like \[lq]A\[rq] or
927 \[lq]b\[rq]);
928 and
929 .
930 .
931 .TP
932 3
933 means the glyph is both an ascender and a descender\[em]this is true of
934 parentheses in some fonts.
935 .
936 .
937 .P
938 The
939 .I code
940 field gives a numeric identifier that the postprocessor uses to render
941 the glyph.
942 .
943 The glyph can be specified to
944 .I troff \" generic
945 using this code by means of the
946 .B \[rs]N
947 escape sequence.
948 .
949 The code can be any integer
950 (that is,
951 any integer parsable by the C standard library's
952 .MR strtol 3
953 function).
954 .
955 .
956 .P
957 The
958 .I entity-name
959 field defines an identifier for the glyph that the postprocessor
960 uses to print the
961 .I \%troff
962 glyph
963 .IR name .
964 .
965 This field is optional;
966 it was introduced so that the
967 .I \%grohtml
968 output driver could encode its character set.
969 .
970 For example,
971 the glyph
972 .B \[rs][Po]
973 is represented by
974 .RB \[lq] &pound; \[rq]
975 in HTML 4.0.
976 .
977 For efficiency,
978 these data are now compiled directly into
979 .IR \%grohtml .
980 .
981 .I grops
982 uses the field to build sub-encoding arrays for PostScript fonts
983 containing more than 256 glyphs.
984 .
985 Anything on the line after the
986 .I entity-name
987 field or
988 .RB \[lq] \-\- \[rq]
989 is ignored.
990 .
991 .
992 .P
993 A line in the
994 .B charset
995 section can also have the form
996 .
997 .RS
998 .IB name\~ \[dq]
999 .RE
1000 .
1001 identifying
1002 .I name
1003 as another name for the glyph mentioned in the preceding line.
1004 .
1005 Such aliases can be chained.
1006 .
1007 .
1008 .P
1009 The directive
1010 .B \%kernpairs
1011 starts a list of kerning adjustments to be made to adjacent glyph pairs
1012 from this font.
1013 .
1014 It contains a sequence of lines formatted as follows.
1015 .
1016 .RS
1017 .I g1 g2 n
1018 .RE
1019 .
1020 The foregoing means that when glyph
1021 .I g1
1022 is typeset immediately before
1023 .IR g2 ,
1024 the space between them should be increased
1025 .RI by\~ n .
1026 .
1027 Most kerning pairs should have a negative value
1028 .RI for\~ n .
1029 .\" END Keep parallel with groff.texi node "Device and Font Files".
1030 .
1031 .
1032 .br
1033 .ne 4v
1034 .\" ====================================================================
1035 .SH Files
1036 .\" ====================================================================
1037 .
1038 .TP
1039 .IR /usr/\:\%share/\:\%groff/\:\%1.23.0/\:\%font/\:\%dev name /\:DESC
1040 describes the output device
1041 .IR name .
1042 .
1043 .
1044 .TP
1045 .IR /usr/\:\%share/\:\%groff/\:\%1.23.0/\:\%font/\:\%dev name / F
1046 describes the font known
1047 .RI as\~ F
1048 on device
1049 .IR name .
1050 .
1051 .
1052 .\" ====================================================================
1053 .SH "See also"
1054 .\" ====================================================================
1055 .
1056 .IR "Groff: The GNU Implementation of troff" ,
1057 by Trent A.\& Fisher and Werner Lemberg,
1058 is the primary
1059 .I groff
1060 manual.
1061 .
1062 You can browse it interactively with \[lq]info groff\[rq].
1063 .
1064 .
1065 .P
1066 \[lq]Troff User's Manual\[rq]
1067 by Joseph F.\& Ossanna,
1068 1976
1069 (revised by Brian W.\& Kernighan,
1070 1992),
1071 AT&T Bell Laboratories Computing Science Technical Report No.\& 54,
1072 widely called simply \[lq]CSTR\~#54\[rq],
1073 documents the language,
1074 device and font description file formats,
1075 and device-independent output format
1076 referred to collectively in
1077 .I groff
1078 documentation as
1079 .RI \[lq]AT&T\~ troff \[rq].
1080 .
1081 .
1082 .P
1083 \[lq]A Typesetter-independent TROFF\[rq]
1084 by Brian W.\& Kernighan,
1085 1982,
1086 AT&T Bell Laboratories Computing Science Technical Report No.\& 97,
1087 provides additional insights into the
1088 device and font description file formats
1089 and device-independent output format.
1090 .
1091 .
1092 .P
1093 .MR groff 1 ,
1094 subsection \[lq]Utilities\[rq],
1095 lists programs available for describing fonts in a variety of formats
1096 such that
1097 .I groff
1098 output drivers can use them.
1099 .
1100 .
1101 .P
1102 .MR \%troff 1
1103 documents the default device and font description file search path.
1104 .
1105 .
1106 .P
1107 .MR groff_out 5 ,
1108 .MR addftinfo 1
1109 .
1110 .
1111 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
1112 .cp \n[*groff_groff_font_5_man_C]
1113 .do rr *groff_groff_font_5_man_C
1114 .
1115 .
1116 .\" Local Variables:
1117 .\" fill-column: 72
1118 .\" mode: nroff
1119 .\" End:
1120 .\" vim: set filetype=groff textwidth=72: