NAME

       g.mkfontcap   -  Generates the font configuration file by scanning various directories for
       fonts

KEYWORDS

       general

SYNOPSIS

       g.mkfontcap
       g.mkfontcap help
       g.mkfontcap [-os]  [extradirs=string]   [--verbose]  [--quiet]

   Flags:
       -o
           Overwrite font configuration file if already existing

       -s
           Write font configuration file to standard output instead of $GISBASE/etc

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       extradirs=string
           Comma-separated list of extra directories to scan  for  Freetype-compatible  fonts  as
           well as the defaults (see documentation)

DESCRIPTION

       g.mkfontcap is a utilty to generate a GRASS font configuration file ("fontcap") containing
       details of the fonts available on the current system.  If Freetype is not  installed,  the
       font  list  will  be  limited to the set of Hershey stroke fonts supplied with GRASS. With
       Freetype enabled however, the module will recursively scan all files within  a  predefined
       hierarchy  to  find Freetype-compatible scalable fonts. The list of directories scanned is
       currently:
           /usr/lib/X11/fonts
           /usr/share/X11/fonts
           /usr/share/fonts
           ${HOME}/Library/Fonts
           /Library/Fonts
           /System/Library/Fonts
           ${WINDIR}/Fonts
        These correspond to directories where  fonts  can  be  found  on  some  common  operating
       systems.  Extra  directories  to search can easily by added using the extradirs parameter,
       which accepts a comma-separated  list.  An  extra  directory  may  optionally  contain  an
       environment  variable  at  the  start  of  the  string,  if enclosed in ${xxx} syntax (see
       examples above).

       The   module   will   normally   write   to   the   standard   fontcap   file    location,
       $GISBASE/etc/fontcap.  If  the environment variable GRASS_FONT_CAP is set, the output will
       instead be written to the file specified by that variable. This is  useful  if  you  don't
       have permission to modify $GISBASE/etc/fontcap: in this case you can use e.g.
       # use local file version instead of system copy
       GRASS_FONT_CAP=$HOME/.gfontcap
       export GRASS_FONT_CAP
       g.mkfontcap
         to  create  a  personal  copy and then to make GRASS use that file instead of the system
       copy.

       The output list of fonts is  sorted  first  by  type  (Stroke  fonts  first,  followed  by
       Freetype) and within each type by the short name of the font.

SEE ALSO

       d.font

AUTHOR

       Paul Kelly

       Last changed: $Date: 2011-11-08 01:42:51 -0800 (Tue, 08 Nov 2011) $

       Full index

       © 2003-2013 GRASS Development Team