Manual.md: document Font packages and font_dirs variable

resolves void-linux/void-packages#1229

[ci skip]
This commit is contained in:
maxice8 2018-08-18 17:27:04 -03:00
parent 2d0c2b9d4d
commit 9ac0e2c87b
No known key found for this signature in database
GPG Key ID: 543B9D4F4299F06B

View File

@ -38,6 +38,7 @@ packages for XBPS, the `Void Linux` native packaging system.
* [Python packages](#pkgs_python)
* [Go packages](#pkgs_go)
* [Haskell packages](#pkgs_haskell)
* [Font packages](#pkgs_font)
* [Notes](#notes)
* [Contributing via git](#contributing)
* [Help](#help)
@ -580,6 +581,12 @@ Example:
A list is composed of three components separated by a colon: group, symlink and target.
i.e `alternatives="vi:/usr/bin/vi:/usr/bin/nvi ex:/usr/bin/ex:/usr/bin/nvi-ex"`.
- `font_dirs` A white space separated list of directories specified by an absolute path where a
font package installs its fonts.
It is used in the `x11-fonts` xbps-trigger to rebuild the font cache during install/removal
of the package.
i.e `font_dirs="/usr/share/fonts/TTF /usr/share/fonts/X11/misc"`
<a id="explain_depends"></a>
#### About the many types of `depends` variable.
@ -1242,6 +1249,18 @@ The following variables influence how Haskell packages are built:
- `make_build_args`: This is passed as-is to `stack build ...`, so
you can add your `--flag ...` parameters there.
<a id="pkgs_font"></a>
### Font packages
Font packages are very straightforward to write, they are always set with the
following variables:
- `noarch=yes`: Font packages don't install arch specific files.
- `depends="font-util"`: because they are required for regenerating the font
cache during the install/removal of the package
- `font_dirs`: which should be set to the directory where the package
installs its fonts
<a id="notes"></a>
### Notes