05/11: doc: Describe how to make X server find TrueType fonts.

[Alex Kost]

alezost pushed a commit to branch master
in repository guix.

commit 1a3e6b15badbd227516c7527e8cdb6095a39031b
Author: Alex Kost <address@hidden>
Date:   Fri Jul 1 11:12:33 2016 +0300

    doc: Describe how to make X server find TrueType fonts.
    
    * 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 393efab..9703c72 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
@@ -1208,6 +1209,24 @@ for Chinese languages:
 guix package -i font-adobe-source-han-sans:cn
 @end example
 
+Older programs such as @command{xterm} do not use Fontconfig and instead
+rely on server-side font rendering.  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.
+
 @subsection X.509 Certificates
 
 The @code{nss-certs} package provides X.509 certificates, which allow