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  utility 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  en‐
49       abled however, the module will recursively scan all files within a pre‐
50       defined hierarchy to find Freetype-compatible scalable fonts. The  list
51       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  us‐
63       ing  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       Accessed: Saturday Oct 28 18:17:20 2023
94
95       Main index | General index | Topics index | Keywords index |  Graphical
96       index | Full index
97
98       © 2003-2023 GRASS Development Team, GRASS GIS 8.3.1 Reference Manual
99
100
101
102GRASS 8.3.1                                                     g.mkfontcap(1)