man7.org > Linux > man-pages

Linux/UNIX system programming training

addftinfo(1) — Linux manual page

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

addftinfo(1)             General Commands Manual            addftinfo(1)

Name         top

       addftinfo - add font metrics to troff fonts for use with groff

Synopsis         top

       addftinfo [-asc-height n] [-body-depth n] [-body-height n]
                 [-cap-height n] [-comma-depth n] [-desc-depth n]
                 [-fig-height n] [-x-height n] resolution unit-width
                 font

       addftinfo --help

       addftinfo -v

       addftinfo --version

Description         top

       addftinfo reads an AT&T troff font description file font, adds
       additional font metric information required by GNU troff(1), and
       writes the combined result to the standard output.  The
       information added is derived from the font's existing parameters
       and assumptions about traditional troff names for characters.
       Among the font metrics added are the heights and depths of
       characters (how far each extends vertically above and below the
       baseline).  The resolution and unit-width arguments should be the
       same as the corresponding parameters in the DESC file.  font is
       the name of the file describing the font; if font ends with “I”,
       the font is assumed to be oblique (or italic).

Options         top

       --help displays a usage message, while -v and --version show
       version information; all exit afterward.

       All other options change parameters that are used to derive the
       heights and depths.  Like the existing quantities in the font
       description file, each value n is in scaled points,
       inches/resolution for a font whose type size is unit-width; see
       groff_font(5).

       -asc-height n
              height of characters with ascenders, such as “b”, “d”, or
              “l”

       -body-depth n
              depth of characters such as parentheses

       -body-height n
              height of characters such as parentheses

       -cap-height n
              height of uppercase letters such as “A”

       -comma-depth n
              depth of a comma

       -desc-depth n
              depth of characters with descenders, such as “p”, “q”, or
              “y”

       -fig-height
              height of figures (numerals)

       -x-height n
              height of lowercase letters without ascenders such as “x”

       addftinfo makes no attempt to use the specified parameters to
       infer unspecified parameters.  If a parameter is not specified,
       the default will be used.  The defaults are chosen to produce
       reasonable values for a Times font.

See also         top

       groff_font(5), groff(1), groff_char(7)

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
       man-pages@man7.org

groff 1.23.0.1273-9d53-dirty   6 June 2024                  addftinfo(1)

HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI