diff options
author | Ludovic Courtès <ludo@gnu.org> | 2013-07-19 00:07:03 +0200 |
---|---|---|
committer | Ludovic Courtès <ludo@gnu.org> | 2013-07-19 00:07:03 +0200 |
commit | 8b2d9e5d44691110aa34d768d3aae4a4d862011a (patch) | |
tree | 08cbb11b18cf8f57c94ef83bc5d1f225494d5010 | |
parent | 3253830d46cc55dd6b946468edd6a6f72944ef48 (diff) | |
download | patches-8b2d9e5d44691110aa34d768d3aae4a4d862011a.tar patches-8b2d9e5d44691110aa34d768d3aae4a4d862011a.tar.gz |
doc: Improve build instructions in README and HACKING.
* README (Requirements): Remove Nixpkgs. Remove mentions of building
from Git.
(Installation): Refer to the manual.
* HACKING: List requirements for when building from Git.
Remove the `dot: Command not found' error.
-rw-r--r-- | HACKING | 29 | ||||
-rw-r--r-- | README | 19 |
2 files changed, 22 insertions, 26 deletions
@@ -12,14 +12,25 @@ Copyright © 2013 Nikita Karetnikov <nikita@karetnikov.org> * Building from Git -First, make sure that Autoconf (>= 2.69), Automake, and pkg-config are -installed. Run ‘./bootstrap’ that, among other things, invokes ‘git submodule -update’, or you might get the following error +When building Guix from a checkout, the following packages are required in +addition to those mentioned in the installation instructions: + + - [[http://www.gnu.org/software/autoconf/][GNU Autoconf]] + - [[http://www.gnu.org/software/automake/][GNU Automake]] + - [[http://www.gnu.org/software/gettext/][GNU Gettext]] + - [[http://www.graphviz.org/][Graphviz]] + +Run ‘./bootstrap’ to download the Nix daemon source code and to generate the +build system infrastructure using autoconf. It reports an error if an +inappropriate version of the above packages is being used. + +The ‘bootstrap’ script, among other things, invokes ‘git submodule update’; if +you didn’t run it, you may get the following error: make: *** No rule to make target `nix/libstore/schema.sql', needed by `nix/libstore/schema.sql.hh' -Then, as always, run ‘./configure’. If you get an error like this one +Then, as always, run ‘./configure’. If you get an error like this one: ./configure: line 6755: `PKG_CHECK_MODULES(GUILE, guile-2.0 >= 2.0.5)' @@ -32,17 +43,9 @@ installed Automake in ‘/usr/local’, it wouldn’t look for ‘.m4’ files i See “info '(automake) Macro Search Path'” for more information. -After that you should proceed with ‘make’. You might also get this error - - /bin/bash: dot: command not found - make[2]: *** [doc/images/bootstrap-graph.png] Error 127 - -This one is easy to handle; just install Graphviz. It is not listed as a -requirement because the resulting images should come with a tarball. - Finally, you have to invoke ‘make check’ to run tests. If anything fails, take a look at “info '(guix) Installation'” or send a message to -<bug-guix@gnu.org>. +<guix-devel@gnu.org>. * Running Guix before it is installed @@ -33,23 +33,16 @@ When `--disable-daemon' was passed, you instead need the following: - [[http://nixos.org/nix/][Nix]] -Optionally, packages from Nixpkgs may be transparently reused from Guix. -For this to work, you need to have a checkout of the Nixpkgs repository; -the `--with-nixpkgs' option allows you to let `configure' know where the -Nixpkgs checkout is. +* Installation - - [[http://nixos.org/nixpkgs/][Nixpkgs]] +See the manual for the installation instructions, either by running -When building Guix from a checkout, the following packages are also -required: + info -f doc/guix.info "(guix) Installation" - - [[http://www.gnu.org/software/autoconf/][GNU Autoconf]] - - [[http://www.gnu.org/software/automake/][GNU Automake]] - - [[http://www.gnu.org/software/gettext/][GNU Gettext]] +or by checking the [[http://www.gnu.org/software/guix/manual/guix.html#Installation][web copy of the manual]]. -Run the "bootstrap" script to download the Nix daemon and to generate the -build system infrastructure using autoconf. It reports an error if an -inappropriate version of the above packages is being used. +For information on installation from a Git checkout, please see the ‘HACKING’ +file. * Installing Guix from Guix |