diff --git a/doc/guix.texi b/doc/guix.texi index 6964a4e..056518f 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -87,6 +87,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 @@ -246,6 +247,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 @@ -830,6 +832,39 @@ daemons on the same machine. @end table +@node Application Setup +@section Application Setup + +When using Guix on top of another GNU/Linux distribution, you may find +that a few additional steps are needed to get everything in place. Here +are some of them. + +@subsection Locales + +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 the 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 + +FIXME: Anything else? + +@subsection X11 Fonts + +The majority of graphical applications uses Fontconfig to locate and +load font and perform X11-client-side rendering. Guix's +@code{fontconfig} package looks for fonts in the user's profile by +default, so you have to install them there. + +FIXME: but actually Fontconfig's cache will have the host distro's fonts +listed, so maybe this is not a problem? + + @c ********************************************************************* @node Package Management @chapter Package Management