1xtotroff(1) General Commands Manual xtotroff(1)
2
3
4
6 xtotroff - convert X font metrics into groff font metrics
7
9 xtotroff [-d destination-directory] [-r resolution] [-s type-size]
10 font-map
11
12 xtotroff --help
13
14 xtotroff -v
15 xtotroff --version
16
18 xtotroff uses font-map to create groff(1) font description files from
19 X11 fonts. Each line in font-map consists of a series of lines of
20 paired groff font names and X font names as X Logical Font Description
21 (XLFD) patterns, with the pair members separated by spaces and/or tabs.
22 For example, an input font-map file consisting of the line
23 TB -adobe-times-bold-r-normal--*-*-*-*-p-*-iso8859-1
24 maps the XLFD on the right to the groff font name TB, conventionally
25 “Times bold”.
26
27 xtotroff opens a connection to the running X server to query its font
28 catalog, and aborts if it cannot. If necessary, the wildcards in the
29 XLFD patterns are populated with the arguments to the -r and -s op‐
30 tions. If a font name is still ambiguous, xtotroff aborts. For each
31 successful mapping, xtotroff creates a groff font description file in
32 the current working directory (or that specified by the -d option)
33 named for each groff font, and reports the mapping to the standard out‐
34 put stream.
35
37 --help displays a usage message, while -v and --version show version
38 information; all exit afterward.
39
40 -d destination-directory
41 Write font descriptions to destination-directory rather than the
42 current working directory.
43
44 -r resolution
45 Set the resolution for all font patterns in font-map. The value
46 is used for both the horizontal and vertical motion quanta. If
47 not specified, a resolution of 75dpi is assumed.
48
49 -s type-size
50 Set the type size in points for all font patterns in font-map.
51 If not specified, a size of 10 points is assumed.
52
54 /usr/share/groff/1.23.0/font/FontMap-X11
55 is the font mapping file used to produce the pre-generated font
56 description files, supplied with groff, of X11 core fonts corre‐
57 sponding to the 13 base Type 1 fonts for PostScript level 1.
58
60 The only supported font encodings are “iso8859-1” and “adobe-
61 fontspecific”.
62
64 “X Logical Font Description Conventions” ⟨https://www.x.org/releases/
65 X11R7.6/doc/xorg-docs/specs/XLFD/xlfd.html⟩, by Jim Flowers and Stephen
66 Gildea.
67
68 X(7), groff(1), gxditview(1), troff(1), groff_font(5)
69
70
71
72groff 1.23.0 2 November 2023 xtotroff(1)