1xtotroff(1)                 General Commands Manual                xtotroff(1)
2
3
4

Name

6       xtotroff - convert X font metrics into groff font metrics
7

Synopsis

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

Description

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

Options

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

Files

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

Bugs

60       The   only   supported  font  encodings  are  “iso8859-1”  and  “adobe-
61       fontspecific”.
62

See also

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)
Impressum