xtotroff(1) — Linux manual page
xtotroff(1) General Commands Manual xtotroff(1)
Name
xtotroff - convert X font metrics into groff font metrics
Synopsis
xtotroff [-r resolution] [-s point-size] font-map
xtotroff --help
xtotroff -v
xtotroff --version
Description
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.
Options
--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.
Bugs
The only supported font encodings are “iso8859-1” and “adobe-
fontspecific”.
See also
“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)
COLOPHON
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 2024-06-14. (At
that time, the date of the most recent commit that was found in
the repository was 2024-06-10.) 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