1g.mkfontcap(1)                Grass User's Manual               g.mkfontcap(1)
2
3
4

NAME

6       g.mkfontcap   - Generates the font configuration file by scanning vari‐
7       ous directories for fonts
8

KEYWORDS

10       general
11

SYNOPSIS

13       g.mkfontcap
14       g.mkfontcap help
15       g.mkfontcap [-os]  [extradirs=string]   [--verbose]  [--quiet]
16
17   Flags:
18       -o
19           Overwrite font configuration file if already existing
20
21       -s
22           Write font configuration file to standard output instead  of  $GIS‐
23           BASE/etc
24
25       --verbose
26           Verbose module output
27
28       --quiet
29           Quiet module output
30
31   Parameters:
32       extradirs=string
33           Comma-separated list of extra directories to scan for Freetype-com‐
34           patible fonts as well as the defaults (see documentation)
35

DESCRIPTION

37       g.mkfontcap is a utilty to generate a  GRASS  font  configuration  file
38       ("fontcap")  containing  details  of the fonts available on the current
39       system.  If Freetype is not installed, the font list will be limited to
40       the  set  of  Hershey  stroke  fonts supplied with GRASS. With Freetype
41       enabled however, the module will recursively scan all  files  within  a
42       predefined  hierarchy  to  find Freetype-compatible scalable fonts. The
43       list of directories scanned is currently:
44           /usr/lib/X11/fonts
45           /usr/share/X11/fonts
46           /usr/share/fonts
47           ${HOME}/Library/Fonts
48           /Library/Fonts
49           /System/Library/Fonts
50           ${WINDIR}/Fonts
51        These correspond to directories where fonts can be found on some  com‐
52       mon  operating systems. Extra directories to search can easily by added
53       using the extradirs parameter, which accepts a comma-separated list. An
54       extra  directory  may optionally contain an environment variable at the
55       start of the string, if enclosed in ${xxx} syntax (see examples above).
56
57       The module will normally write to the standard fontcap  file  location,
58       $GISBASE/etc/fontcap.  If  the  environment  variable GRASS_FONT_CAP is
59       set, the output will instead be written to the file specified  by  that
60       variable.  This  is useful if you don't have permission to modify $GIS‐
61       BASE/etc/fontcap, in this case you can use e.g.
62       g.mkfontcap -s > $HOME/.gfontcap
63       # use local file version instead of system copy
64       GRASS_FONT_CAP=$HOME/.gfontcap
65       export $GRASS_FONT_CAP
66        to create a personal copy and then to make GRASS use that file instead
67       of the system copy.
68
69       The  output  list of fonts is sorted first by type (Stroke fonts first,
70       followed by Freetype) and within each type by the  short  name  of  the
71       font.
72

SEE ALSO

74       d.font
75

AUTHOR

77       Paul Kelly
78
79       Last changed: $Date: 2008-01-31 09:38:05 +0100 (Thu, 31 Jan 2008) $
80
81       Full index
82
83       © 2003-2008 GRASS Development Team
84
85
86
87GRASS 6.3.0                                                     g.mkfontcap(1)