doc: Mention 'guix environment guix'.

* doc/contributing.texi (Building from Git): Mention 'guix environment
guix'.  Remove outdated description of ./bootstrap.  Clarify a few
things.
This commit is contained in:
Ludovic Courtès 2015-11-22 11:24:18 +01:00
parent 82e64fc14e
commit 5fb95cc592
1 changed files with 23 additions and 10 deletions

View File

@ -32,23 +32,36 @@ the installation instructions (@pxref{Requirements}).
@item @url{http://www.gnu.org/software/help2man/, GNU Help2man (optional)}. @item @url{http://www.gnu.org/software/help2man/, GNU Help2man (optional)}.
@end itemize @end itemize
Run @command{./bootstrap} to download the Nix daemon source code and to The easiest way to set up a development environment for Guix is, of
generate the build system infrastructure using autoconf. It reports an course, by using Guix! The following command starts a new shell where
error if an inappropriate version of the above packages is being used. all the dependencies and appropriate environment variables are set up to
hack on Guix:
@noindent @example
If you get an error like this one: guix environment guix
@end example
@xref{Invoking guix environment}, for more information on that command.
Extra dependencies can be added with @option{--ad-hoc}:
@example
guix environment guix --ad-hoc help2man git strace
@end example
Run @command{./bootstrap} to generate the build system infrastructure
using Autoconf and Automake. If you get an error like this one:
@example @example
configure.ac:46: error: possibly undefined macro: PKG_CHECK_MODULES configure.ac:46: error: possibly undefined macro: PKG_CHECK_MODULES
@end example @end example
@noindent
it probably means that Autoconf couldnt find @file{pkg.m4}, which is it probably means that Autoconf couldnt find @file{pkg.m4}, which is
provided by @command{pkg-config}. Make sure that @file{pkg.m4} is provided by pkg-config. Make sure that @file{pkg.m4} is available. The
available. For instance, if you installed Automake in same holds for the @file{guile.m4} set of macros provided by Guile. For
@file{/usr/local}, it wouldnt look for @file{.m4} files in instance, if you installed Automake in @file{/usr/local}, it wouldnt
@file{/usr/share}. So you have to invoke the following command in that look for @file{.m4} files in @file{/usr/share}. In that case, you have
case to invoke the following command:
@example @example
export ACLOCAL_PATH=/usr/share/aclocal export ACLOCAL_PATH=/usr/share/aclocal