Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

addftinfo (1)

Name

addftinfo - add information to troff font files for use with groff

Synopsis

addftinfo [ -v ] [ param-option value....  ] res unitwidth font

Description

ADDFTINFO(1)                General Commands Manual               ADDFTINFO(1)



NAME
       addftinfo - add information to troff font files for use with groff

SYNOPSIS
       addftinfo [ -v ] [ param-option value....  ] res unitwidth font

DESCRIPTION
       addftinfo  reads a troff font file and adds some additional font-metric
       information that is used by the groff system.  The font file  with  the
       information  added  is written on the standard output.  The information
       added is guessed using some parametric information about the  font  and
       assumptions about the traditional troff names for characters.  The main
       information added is the heights and depths of characters.  The res and
       unitwidth  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 will be assumed to be italic.

OPTIONS
       -v prints the version number.

       All  other options change one of the parameters that are used to derive
       the heights and depths.  Like the existing quantities in the font file,
       each  value  is in inches/res for a font whose point size is unitwidth.
       param-option must be one of:

       -x-height
              The height of lowercase letters without ascenders such as x.

       -fig-height
              The height of figures (digits).

       -asc-height
              The height of characters with ascenders, such as b, d or l.

       -body-height
              The height of characters such as parentheses.

       -cap-height
              The height of uppercase letters such as A.

       -comma-depth
              The depth of a comma.

       -desc-depth
              The depth of characters with descenders, such as p, q, or y.

       -body-depth
              The depth of characters such as parentheses.

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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | text/groff       |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

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

       Watch a man-page name(n) with
              man n name
       in text mode and with
              groffer n name
       in graphical mode (PDF, etc.).

COPYING
       Copyright (C) 1989-2014 Free Software Foundation, Inc.

       Permission  is  granted  to make and distribute verbatim copies of this
       manual provided the copyright notice and  this  permission  notice  are
       preserved on all copies.

       Permission  is granted to copy and distribute modified versions of this
       manual under the conditions for verbatim  copying,  provided  that  the
       entire  resulting derived work is distributed under the terms of a per-
       mission notice identical to this one.

       Permission is granted to copy and distribute translations of this  man-
       ual into another language, under the above conditions for modified ver-
       sions, except that this permission notice may be included  in  transla-
       tions approved by the Free Software Foundation instead of in the origi-
       nal English.



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source                was                downloaded                from
       https://ftp.gnu.org/gnu/groff/groff-1.22.3.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.gnu.org/software/groff.



Groff Version 1.22.3            4 November 2014                   ADDFTINFO(1)