summary refs log tree commit diff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2020-04-06 10:16:28 +0200
committerLudovic Courtès <ludo@gnu.org>2020-04-06 12:07:49 +0200
commitd636e54c270a3ff427f4f94366b5f2049808c170 (patch)
tree53308420d45ebaf0b92d9ea5bc99b0bef7f6f239
parenta841f8184718a4fa95001761f8c0fea1f4a0ff63 (diff)
downloadguix-d636e54c270a3ff427f4f94366b5f2049808c170.tar.gz
doc: Make 'fc-cache -rv' instructions more prominent.
* doc/guix.texi (Application Setup): Move the "fc-cache" instructions
next to the Fontconfig paragraph and make the command more visible.
-rw-r--r--doc/guix.texi18
1 files changed, 11 insertions, 7 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 12094e0feb..4d1acf1342 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -1685,6 +1685,17 @@ to display fonts, you have to install fonts with Guix as well.
 Essential font packages include @code{gs-fonts}, @code{font-dejavu}, and
 @code{font-gnu-freefont-ttf}.
 
+@cindex @code{fc-cache}
+@cindex font cache
+Once you have installed or removed fonts, or when you notice an
+application that does not find fonts, you may need to install Fontconfig
+and to force an update of its font cache by running:
+
+@example
+guix install fontconfig
+fc-cache -rv
+@end example
+
 To display text written in Chinese languages, Japanese, or Korean in
 graphical applications, consider installing
 @code{font-adobe-source-han-sans} or @code{font-wqy-zenhei}.  The former
@@ -1718,13 +1729,6 @@ xset +fp $(dirname $(readlink -f ~/.guix-profile/share/fonts/truetype/fonts.dir)
 After that, you can run @code{xlsfonts} (from @code{xlsfonts} package)
 to make sure your TrueType fonts are listed there.
 
-@cindex @code{fc-cache}
-@cindex font cache
-After installing fonts you may have to refresh the font cache to use
-them in applications.  The same applies when applications installed via
-Guix do not seem to find fonts.  To force rebuilding of the font cache
-run @code{fc-cache -rv}.  The @code{fc-cache} command is provided by
-the @code{fontconfig} package.
 
 @subsection X.509 Certificates