|
Name | Synopsis | Description | Options | Bugs | See also | COLOPHON |
|
|
|
xtotroff(1) General Commands Manual xtotroff(1)
xtotroff - convert X font metrics into groff font metrics
xtotroff [-r resolution] [-s point-size] font-map
xtotroff --help
xtotroff -v
xtotroff --version
xtotroff uses font-map to create groff(1) font description files
from X11 fonts. Each line in font-map consists of a series of
lines of paired groff font names and X font names as X Logical
Font Description (XLFD) patterns, with the pair members separated
by spaces and/or tabs. For example, an input font-map file
consisting of the line
TB -adobe-times-bold-r-normal--*-*-*-*-p-*-iso8859-1
maps the XLFD on the right to the groff font name TB,
conventionally “Times bold”.
xtotroff opens a connection to the running X server to query its
font catalog, and aborts if it cannot. If necessary, the
wildcards in the XLFD patterns are populated with the arguments to
the -r and -s options. If a font name is still ambiguous,
xtotroff aborts. For each successful mapping, xtotroff creates a
groff font description file in the current working directory named
for each groff font, and reports the mapping to the standard
output stream.
--help displays a usage message, while -v and --version show
version information; all exit afterward.
-r resolution
Set the resolution for all font patterns in font-map. The
value is used for both the horizontal and vertical
resolution. If not specified, a resolution of 75dpi is
assumed.
-s point-size
Set the point size for all font patterns in font-map. If
not specified, a size of 10 points is assumed.
The only supported font encodings are “iso8859-1” and “adobe-
fontspecific”.
“X Logical Font Description Conventions”
⟨https://www.x.org/releases/X11R7.6/doc/xorg-docs/specs/XLFD/xlfd
.html⟩, by Jim Flowers and Stephen Gildea.
X(7), groff(1), gxditview(1), troff(1), groff_font(5)
This page is part of the groff (GNU troff) project. Information
about the project can be found at
⟨http://www.gnu.org/software/groff/⟩. If you have a bug report for
this manual page, see ⟨http://www.gnu.org/software/groff/⟩. This
page was obtained from the project's upstream Git repository
⟨https://git.savannah.gnu.org/git/groff.git⟩ on 2025-08-11. (At
that time, the date of the most recent commit that was found in
the repository was 2025-08-09.) If you discover any rendering
problems in this HTML version of the page, or you believe there is
a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
man-pages@man7.org
groff 1.23.0.rc1.1931-35c9b 30 January 2022 xtotroff(1)