Author: eelco
Date: Fri Oct 29 14:44:02 2010
New Revision: 24526
URL: https://svn.nixos.org/websvn/nix/?rev=24526&sc=1
Log:
* Document Boehm GC support.
Modified:
nix/branches/gc/doc/manual/env-common.xml
nix/branches/gc/doc/manual/installation.xml
nix/branches/gc/doc/manual/release-notes.xml
nix/branches/gc/src/libmain/shared.cc
Modified: nix/branches/gc/doc/manual/env-common.xml
==============================================================================
--- nix/branches/gc/doc/manual/env-common.xml Fri Oct 29 14:00:47 2010
(r24525)
+++ nix/branches/gc/doc/manual/env-common.xml Fri Oct 29 14:44:02 2010
(r24526)
@@ -271,6 +271,17 @@
</varlistentry>
+
+<varlistentry><term><envar>GC_INITIAL_HEAP_SIZE</envar></term>
+
+ <listitem><para>If Nix has been configured to use the Boehm garbage
+ collector, this variable sets the initial size of the heap in bytes.
+ It defaults to 384 MiB. Setting it to a low value reduces memory
+ consumption, but will increase runtime due to the overhead of
+ garbage collection.</para></listitem>
+
+</varlistentry>
+
</variablelist>
Modified: nix/branches/gc/doc/manual/installation.xml
==============================================================================
--- nix/branches/gc/doc/manual/installation.xml Fri Oct 29 14:00:47 2010
(r24525)
+++ nix/branches/gc/doc/manual/installation.xml Fri Oct 29 14:44:02 2010
(r24526)
@@ -105,6 +105,13 @@
can use <command>configure</command>'s <option>--with-bzip2</option>
options to point to their respective locations.</para>
+<para>Nix can optionally use the <link
+xlink:href="http://www.hpl.hp.com/personal/Hans_Boehm/gc/";>Boehm
+garbage collector</link> to reduce the evaluator’s memory consumption.
+To enable it, install <literal>pkgconfig</literal> and the Boehm
+garbage collector, and pass the flag <option>--enable-gc</option> to
+<command>configure</command>.</para>
+
</section>
Modified: nix/branches/gc/doc/manual/release-notes.xml
==============================================================================
--- nix/branches/gc/doc/manual/release-notes.xml Fri Oct 29 14:00:47
2010 (r24525)
+++ nix/branches/gc/doc/manual/release-notes.xml Fri Oct 29 14:44:02
2010 (r24526)
@@ -8,6 +8,27 @@
<!--==================================================================-->
+<section xml:id="ssec-relnotes-1.0"><title>Release 1.0 (TBA)</title>
+
+<para>This release has the following improvements:</para>
+
+<itemizedlist>
+
+ <listitem>
+ <para>Nix can now optionally use the Boehm garbage collector.
+ This significantly reduces the Nix evaluator’s memory footprint,
+ especially when evaluating large NixOS system configurations. It
+ can be enabled using the <option>--enable-gc</option> configure
+ option.</para>
+ </listitem>
+
+</itemizedlist>
+
+</section>
+
+
+<!--==================================================================-->
+
<section xml:id="ssec-relnotes-0.16"><title>Release 0.16 (August 17,
2010)</title>
<para>This release has the following improvements:</para>
Modified: nix/branches/gc/src/libmain/shared.cc
==============================================================================
--- nix/branches/gc/src/libmain/shared.cc Fri Oct 29 14:00:47 2010
(r24525)
+++ nix/branches/gc/src/libmain/shared.cc Fri Oct 29 14:44:02 2010
(r24526)
@@ -364,7 +364,7 @@
allocated. This might be a problem on systems that don't
overcommit. */
if (!getenv("GC_INITIAL_HEAP_SIZE"))
- GC_expand_hp(384000000);
+ GC_expand_hp(384 * 1024 * 1024);
#endif
try {
_______________________________________________
nix-commits mailing list
[email protected]
http://mail.cs.uu.nl/mailman/listinfo/nix-commits
