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

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

See also         top

       “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         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 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
       [email protected]

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