01/03: doc: Add "Application Setup" section.

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository guix.

commit 0e2d0213b5bcf2fcdf5ab81dfdd965b071f30637
Author: Ludovic Courtès <address@hidden>
Date:   Mon Jun 22 22:44:39 2015 +0200

    doc: Add "Application Setup" section.
    
    * doc/guix.texi (Application Setup): New node.
---
 doc/guix.texi |   40 ++++++++++++++++++++++++++++++++++++++++
 1 files changed, 40 insertions(+), 0 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index f49ffa4..b3a77b4 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
 
 
address@hidden Application Setup
address@hidden 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.
+
address@hidden Locales
+
address@hidden 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}):
+
address@hidden
+$ guix package -i glibc-locales
+$ export LOCPATH=$HOME/.guix-profile/lib/locale
address@hidden example
+
+Note that the @code{glibc-locales} package contains data for all the
+locales supported by the address@hidden and weighs in at around
address@hidden  Alternately, the @code{glibc-utf8-locales} is smaller but
+limited to a few UTF-8 locales.
+
address@hidden X11 Fonts
+
+The majority of graphical applications uses Fontconfig to locate and
+load fonts and perform X11-client-side rendering.  Guix's
address@hidden 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
address@hidden
+
address@hidden TODO What else?
+
 @c *********************************************************************
 @node Package Management
 @chapter Package Management