From 12721a3a9a5b6f64b9150833a2e682daf9c03e4d Mon Sep 17 00:00:00 2001 From: Eelco Dolstra Date: Mon, 16 Aug 2010 12:38:32 +0000 Subject: * Nix 0.16 release notes. --- doc/manual/release-notes.xml | 53 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) (limited to 'doc') diff --git a/doc/manual/release-notes.xml b/doc/manual/release-notes.xml index e79563440416..b3a324c97b8f 100644 --- a/doc/manual/release-notes.xml +++ b/doc/manual/release-notes.xml @@ -6,6 +6,59 @@ + + +
Release 0.16 (August 16, 2010) + +This release has the following improvements: + + + + + The Nix expression evaluator is now much faster in most + cases: typically, 3 + to 8 times compared to the old implementation. It also + uses less memory. It no longer depends on the ATerm + library. + + + + + Support for configurable parallelism inside builders. Build + scripts have always had the ability to perform multiple build + actions in parallel (for instance, by running make -j + 2), but this was not desirable because the number of + actions to be performed in parallel was not configurable. Nix + now has an option as well as a configuration + setting build-cores = + N that causes the + environment variable NIX_BUILD_CORES to be set to + N when the builder is invoked. The + builder can use this at its discretion to perform a parallel + build, e.g., by calling make -j + N. In Nixpkgs, this can be + enabled on a per-package basis by setting + enableParallelBuilding to + true. + + + + + nix-store -q now supports XML output + through the flag. + + + + Several bug fixes. + + + + +
+ +
Release 0.15 (March 17, 2010) -- cgit 1.4.1 From b75e1043a3a4bd72086e4007a53f0a1c3211c9fa Mon Sep 17 00:00:00 2001 From: Eelco Dolstra Date: Mon, 16 Aug 2010 13:23:45 +0000 Subject: * Typo. --- doc/manual/nix-push.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/manual/nix-push.xml b/doc/manual/nix-push.xml index 1435c559496f..d2a7e063e583 100644 --- a/doc/manual/nix-push.xml +++ b/doc/manual/nix-push.xml @@ -120,7 +120,7 @@ dependencies used in the build, such as compilers). dependencies, we can do: -$ nix-push urls $(nix-instantiate $(nix-store -r foo.nix)) +$ nix-push urls $(nix-store -r $(nix-instantiate foo.nix)) -- cgit 1.4.1 From 86f65edf4e519224eaa35ebc6bcf98bffe04b3d6 Mon Sep 17 00:00:00 2001 From: Eelco Dolstra Date: Tue, 17 Aug 2010 07:22:05 +0000 Subject: * Document --cores in the manual. --- doc/manual/conf-file.xml | 19 +++++++++++++++++++ doc/manual/opt-common-syn.xml | 4 ++++ doc/manual/opt-common.xml | 20 +++++++++++++++++++- doc/manual/release-notes.xml | 6 +++--- nix.conf.example | 2 +- 5 files changed, 46 insertions(+), 5 deletions(-) (limited to 'doc') diff --git a/doc/manual/conf-file.xml b/doc/manual/conf-file.xml index 2ee268097066..ec64e8b114f7 100644 --- a/doc/manual/conf-file.xml +++ b/doc/manual/conf-file.xml @@ -97,6 +97,25 @@ env-keep-derivations = false + build-cores + + Sets the value of the + NIX_BUILD_CORES environment variable in the + invocation of builders. Builders can use this variable at their + discretion to control the maximum amount of parallelism. For + instance, in Nixpkgs, if the derivation attribute + enableParallelBuilding is set to + true, the builder passes the + flag to GNU Make. + It can be overriden using the command line switch and + defaults to 1. The value 0 + means that the builder should use all available CPU cores in the + system. + + + + build-max-silent-time diff --git a/doc/manual/opt-common-syn.xml b/doc/manual/opt-common-syn.xml index 0412fcb6abba..da60288b2a19 100644 --- a/doc/manual/opt-common-syn.xml +++ b/doc/manual/opt-common-syn.xml @@ -13,6 +13,10 @@ number + + + number + number diff --git a/doc/manual/opt-common.xml b/doc/manual/opt-common.xml index 3be9f5dd5fc3..2d67162d7cad 100644 --- a/doc/manual/opt-common.xml +++ b/doc/manual/opt-common.xml @@ -98,7 +98,25 @@ linkend='conf-build-max-jobs'>build-max-jobs configuration setting, which itself defaults to 1. A higher value is useful on SMP systems or to - exploit I/O latency. + exploit I/O latency. + + + + + + + Sets the value of the NIX_BUILD_CORES + environment variable in the invocation of builders. Builders can + use this variable at their discretion to control the maximum amount + of parallelism. For instance, in Nixpkgs, if the derivation + attribute enableParallelBuilding is set to + true, the builder passes the + flag to GNU Make. + It defaults to the value of the build-cores + configuration setting, if set, or 1 otherwise. + The value 0 means that the builder should use all + available CPU cores in the system. diff --git a/doc/manual/release-notes.xml b/doc/manual/release-notes.xml index b3a324c97b8f..5b1c30bf8292 100644 --- a/doc/manual/release-notes.xml +++ b/doc/manual/release-notes.xml @@ -8,7 +8,7 @@ -
Release 0.16 (August 16, 2010) +
Release 0.16 (August 17, 2010) This release has the following improvements: @@ -39,8 +39,8 @@ builder can use this at its discretion to perform a parallel build, e.g., by calling make -j N. In Nixpkgs, this can be - enabled on a per-package basis by setting - enableParallelBuilding to + enabled on a per-package basis by setting the derivation + attribute enableParallelBuilding to true. diff --git a/nix.conf.example b/nix.conf.example index 7063bed54c4d..3c55b570e60f 100644 --- a/nix.conf.example +++ b/nix.conf.example @@ -63,7 +63,7 @@ # # This option defines the number of CPU cores to utilize in parallel # within a build job, i.e. by passing an appropriate `-jN' flag to GNU -# make. The default is 1, meaning that parallel building within jobs +# Make. The default is 1, meaning that parallel building within jobs # is disabled. Passing the special value `0' causes Nix to try and # auto-detect the number of available cores on the local host. This # setting can be overridden using the `--cores' command line switch. -- cgit 1.4.1 From 2de17f4edcd7ee66b1094d777cdb62ec4a786a8c Mon Sep 17 00:00:00 2001 From: Eelco Dolstra Date: Tue, 17 Aug 2010 10:06:26 +0000 Subject: * Update date. --- doc/manual/manual.xml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/manual/manual.xml b/doc/manual/manual.xml index df926841aa4a..090a92ce6b3e 100644 --- a/doc/manual/manual.xml +++ b/doc/manual/manual.xml @@ -27,10 +27,11 @@ 2007 2008 2009 + 2010 Eelco Dolstra - September 2009 + August 2010 -- cgit 1.4.1