Name

       xtotroff - convert X font metrics into groff font metrics

Synopsis

       xtotroff [-d destination-directory] [-r resolution] [-s type-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 (or that specified by the -d option) 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.

       -d destination-directory
              Write font descriptions to destination-directory rather than  the  current  working
              directory.

       -r resolution
              Set  the  resolution for all font patterns in font-map.  The value is used for both
              the horizontal and vertical motion quanta.  If not specified, a resolution of 75dpi
              is assumed.

       -s type-size
              Set the type size in points for all font patterns in font-map.  If not specified, a
              size of 10 points is assumed.

Files

       /usr/share/groff/1.23.0/font/FontMap-X11
              is the font mapping file used to produce the pre-generated font description  files,
              supplied  with  groff,  of X11 core fonts corresponding to the 13 base Type 1 fonts
              for PostScript level 1.

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)