doc: Add "Application Setup" section.

* doc/guix.texi (Application Setup): New node.
This commit is contained in:
Ludovic Courtès 2015-06-22 22:44:39 +02:00
parent 6248e32635
commit 0e2d0213b5
1 changed files with 40 additions and 0 deletions

View File

@ -90,6 +90,7 @@ Installation
* Running the Test Suite:: Testing Guix. * Running the Test Suite:: Testing Guix.
* Setting Up the Daemon:: Preparing the build daemon's environment. * Setting Up the Daemon:: Preparing the build daemon's environment.
* Invoking guix-daemon:: Running the build daemon. * Invoking guix-daemon:: Running the build daemon.
* Application Setup:: Application-specific setup.
Setting Up the Daemon Setting Up the Daemon
@ -271,6 +272,7 @@ instead, you want to install the complete GNU operating system,
* Running the Test Suite:: Testing Guix. * Running the Test Suite:: Testing Guix.
* Setting Up the Daemon:: Preparing the build daemon's environment. * Setting Up the Daemon:: Preparing the build daemon's environment.
* Invoking guix-daemon:: Running the build daemon. * Invoking guix-daemon:: Running the build daemon.
* Application Setup:: Application-specific setup.
@end menu @end menu
@node Binary Installation @node Binary Installation
@ -865,6 +867,44 @@ daemons on the same machine.
@end table @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 ********************************************************************* @c *********************************************************************
@node Package Management @node Package Management
@chapter Package Management @chapter Package Management