1g.mkfontcap(1)              GRASS GIS 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]      [--help]     [--verbose]
16       [--quiet]  [--ui]
17
18   Flags:
19       -o
20           Overwrite font configuration file if already existing
21
22       -s
23           Write  font  configuration file to standard output instead of $GIS‐
24           BASE/etc
25
26       --help
27           Print usage summary
28
29       --verbose
30           Verbose module output
31
32       --quiet
33           Quiet module output
34
35       --ui
36           Force launching GUI dialog
37
38   Parameters:
39       extradirs=string
40           List of extra directories to scan
41           Comma-separated list of extra directories to scan for Freetype-com‐
42           patible fonts as well as the defaults (see documentation)
43

DESCRIPTION

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

SEE ALSO

85        d.font
86

AUTHOR

88       Paul Kelly
89

SOURCE CODE

91       Available at: g.mkfontcap source code (history)
92
93       Main index | General index | Topics index | Keywords index |  Graphical
94       index | Full index
95
96       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
97
98
99
100GRASS 7.8.5                                                     g.mkfontcap(1)