Go to file
Ludovic Courtès 0afdc48532 Add a preliminary `guix-package' command-line tool.
* guix-package.in, tests/guix-package.sh: New files.
* configure.ac: Output `guix-package'.
* Makefile.am (TESTS): Add `tests/guix-package.sh'.
  (bin_SCRIPTS): Add `guix-package'.
2012-11-01 01:46:15 +01:00
build-aux distro: Use our own pre-built Guile to bootstrap. 2012-10-17 23:25:25 +02:00
distro/packages distro: Build Bash sequentially. 2012-10-28 01:59:33 +02:00
doc doc: Add the stub of a manual. 2012-10-13 16:05:01 +02:00
guix store: Add `store-path-package-name'. 2012-11-01 01:39:23 +01:00
po Add (guix ui). 2012-11-01 00:52:44 +01:00
srfi SRFI-64: Remove use of (ice-9 syntax-case). 2012-06-05 11:21:13 +02:00
tests Add a preliminary `guix-package' command-line tool. 2012-11-01 01:46:15 +01:00
.dir-locals.el Add (guix ui). 2012-11-01 00:52:44 +01:00
.gitignore Add a preliminary `guix-package' command-line tool. 2012-11-01 01:46:15 +01:00
AUTHORS Add the usual top-level files. 2012-06-03 23:46:56 +02:00
COPYING Add the usual top-level files. 2012-06-03 23:46:56 +02:00
ChangeLog build: Use Automake's `gnu' option. 2012-07-07 22:53:01 +02:00
HACKING doc: Add `HACKING'. 2012-10-25 23:44:27 +02:00
Makefile.am Add a preliminary `guix-package' command-line tool. 2012-11-01 01:46:15 +01:00
NEWS build: Use Automake's `gnu' option. 2012-07-07 22:53:01 +02:00
README Augment `README'. 2012-10-05 00:19:29 +02:00
THANKS Add `THANKS'. 2012-07-07 22:39:57 +02:00
configure.ac Add a preliminary `guix-package' command-line tool. 2012-11-01 01:46:15 +01:00
distro.scm distro: Change $DISTRO_{PATCH,BOOTSTRAP}_DIRECTORY to search paths. 2012-10-27 22:30:42 +02:00
guix-build.in Add (guix ui). 2012-11-01 00:52:44 +01:00
guix-download.in Add (guix ui). 2012-11-01 00:52:44 +01:00
guix-package.in Add a preliminary `guix-package' command-line tool. 2012-11-01 01:46:15 +01:00
guix.scm Remove non-existent module from (guix). 2012-10-08 23:13:51 +02:00
pre-inst-env.in build: Fix out-of-source-tree builds. 2012-10-27 22:37:49 +02:00
release.nix release.nix: Use `--no-substitutes' in `distro.hello'. 2012-10-31 00:22:39 +01:00

README

-*- mode: org -*-

Guix is Nix[0] from Guile[1]!

Concretely, it allows Nix package management to be done entirely in
Scheme. The goal is to investigate whether Scheme, and in particular
the ability to define EDSLs, would allow it to fulfill the role of the
Nix language.

[0] http://nixos.org/nix/
[1] http://gnu.org/software/guile/


* Hacking

Guix currently depends on the following packages:

  - [[http://gnu.org/software/guile/][GNU Guile 2.0.x]]
  - [[http://nixos.org/nix/][Nix]]
  - [[http://gnupg.org/][GNU libgcrypt]], or [[http://nongnu.org/libchop/][libchop]]

For bootstrapping purposes, it is useful to reuse packages from Nixpkgs.
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.

  - [[http://nixos.org/nixpkgs/][Nixpkgs]]

When building Guix from a checkout, the following packages are also
required:

  - [[http://www.gnu.org/software/autoconf/][GNU Autoconf]]
  - [[http://www.gnu.org/software/automake/][GNU Automake]]
  - [[http://www.gnu.org/software/gettext/][GNU Gettext]]

The "autoreconf -vi" command can be used to generate the build system
infrastructure; it reports an error if an inappropriate version of the
above packages is being used.

* How It Works

Guix does the high-level preparation of a /derivation/.  A derivation is
the promise of a build; it is stored as a text file under
=/nix/store/xxx.drv=.  The (guix derivations) module provides the
`derivation' primitive, as well as higher-level wrappers such as
`build-expression->derivation'.

Guix does remote procedure calls (RPCs) to the Nix daemon (the
=nix-worker --daemon= command), which in turn performs builds and
accesses to the Nix store on its behalf.  The RPCs are implemented in
the (guix store) module.

* Contact

The repository is at <https://gitorious.org/guix/>.

Please email <ludo@gnu.org> or <nix-dev@lists.science.uu.nl>, or
join #guile or #nixos on irc.freenode.net or `civodul'.