xtotroff(1) — Linux manual page

Name | Synopsis | Description | Options | Bugs | See also | COLOPHON

xtotroff(1)              General Commands Manual             xtotroff(1)

Name         top

       xtotroff - convert X font metrics into groff font metrics

Synopsis         top

       xtotroff [-r resolution] [-s point-size] font-map

       xtotroff --help

       xtotroff -v
       xtotroff --version

Description         top

       xtotroff uses font-map to create 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         top

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

       -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         top

       The only supported font encodings are “iso8859-1” and “adobe-

See also         top

       “X Logical Font Description Conventions” 
       .html⟩, by Jim Flowers and Stephen Gildea.

COLOPHON         top

       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 2023-06-23.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2023-06-23.)  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

groff 1.23.0.rc1.1931-35c9b  30 January 2022                 xtotroff(1)