[PATCH 3/3] doc: Describe how to make X server find TrueType fonts.

[Alex Kost]

* doc/guix.texi (Application Setup): Document how to add TrueType fonts
installed in a Guix profile to the X server font path.
---
 doc/guix.texi | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 62c0d34..0e7b698 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -13,6 +13,7 @@
 Copyright @copyright{} 2012, 2013, 2014, 2015, 2016 Ludovic address@hidden
 Copyright @copyright{} 2013, 2014, 2016 Andreas address@hidden
 Copyright @copyright{} 2013 Nikita address@hidden
+Copyright @copyright{} 2014, 2015, 2016 Alex address@hidden
 Copyright @copyright{} 2015, 2016 Mathieu address@hidden
 Copyright @copyright{} 2014 Pierre-Antoine address@hidden
 Copyright @copyright{} 2015 Taylan Ulrich Bayırlı/address@hidden
@@ -1192,6 +1193,24 @@ 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}.
 
+However, some programs do not support Fontconfig and rely on the X
+server to recognize a font.  Such programs require to specify a full
+name of a font using XLFD (X Logical Font Description), like this:
+
address@hidden
+-*-dejavu sans-medium-r-normal-*-*-100-*-*-*-*-*-1
address@hidden example
+
+To be able to use such full names for the TrueType fonts installed in
+your Guix profile, you need to extend the font path of the X server:
+
address@hidden
+xset +fp ~/.guix-profile/share/fonts/truetype
address@hidden example
+
+After that, you can run @code{xlsfonts} (from @code{xlsfonts} package)
+to make sure your TrueType fonts are listed there.
+
 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
-- 
2.8.3