diff options
| -rw-r--r-- | doc/guix.texi | 40 |
1 files changed, 40 insertions, 0 deletions
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 |