From 0e2d0213b5bcf2fcdf5ab81dfdd965b071f30637 Mon Sep 17 00:00:00 2001
From: Ludovic Courtès <ludo@gnu.org>
Date: Mon, 22 Jun 2015 22:44:39 +0200
Subject: doc: Add "Application Setup" section.

* doc/guix.texi (Application Setup): New node.
---
 doc/guix.texi | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

(limited to 'doc/guix.texi')

diff --git a/doc/guix.texi b/doc/guix.texi
index f49ffa4517..b3a77b4311 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -90,6 +90,7 @@ Installation
 * Running the Test Suite::      Testing Guix.
 * Setting Up the Daemon::       Preparing the build daemon's environment.
 * Invoking guix-daemon::        Running the build daemon.
+* Application Setup::           Application-specific setup.
 
 Setting Up the Daemon
 
@@ -271,6 +272,7 @@ instead, you want to install the complete GNU operating system,
 * Running the Test Suite::      Testing Guix.
 * Setting Up the Daemon::       Preparing the build daemon's environment.
 * Invoking guix-daemon::        Running the build daemon.
+* Application Setup::           Application-specific setup.
 @end menu
 
 @node Binary Installation
@@ -865,6 +867,44 @@ daemons on the same machine.
 @end table
 
 
+@node Application Setup
+@section Application Setup
+
+When using Guix on top of GNU/Linux distribution other than GuixSD, a
+few additional steps are needed to get everything in place.  Here are
+some of them.
+
+@subsection Locales
+
+@cindex locales, when not on GuixSD
+Packages installed @i{via} Guix will not use the host system's locale
+data.  Instead, you must first install one of the locale packages
+available with Guix and then define the @code{LOCPATH} environment
+variable (@pxref{Locale Names, @code{LOCPATH},, libc, The GNU C Library
+Reference Manual}):
+
+@example
+$ guix package -i glibc-locales
+$ export LOCPATH=$HOME/.guix-profile/lib/locale
+@end example
+
+Note that the @code{glibc-locales} package contains data for all the
+locales supported by the GNU@tie{}libc and weighs in at around
+110@tie{}MiB.  Alternately, the @code{glibc-utf8-locales} is smaller but
+limited to a few UTF-8 locales.
+
+@subsection X11 Fonts
+
+The majority of graphical applications uses Fontconfig to locate and
+load fonts and perform X11-client-side rendering.  Guix's
+@code{fontconfig} package looks for fonts in @file{$HOME/.guix-profile}
+by default.  Thus, to allow graphical applications installed with Guix
+to display fonts, you will have to install fonts with Guix as well.
+Essential font packages include @code{gs-fonts}, @code{font-dejavu}, and
+@code{font-gnu-freefont}.
+
+@c TODO What else?
+
 @c *********************************************************************
 @node Package Management
 @chapter Package Management
-- 
cgit v1.2.3