[m-rev.] diff: document how to increase max memory for cygwin

[Peter Ross]

Hi,


===================================================================


Estimated hours taken: 0.25
Branches: main

README.Cygwin:
	Document how to avoid the "GC Warning: Out of Memory!  Returning NIL!"
	runtime error, when running under cygwin.


Index: README.Cygwin
===================================================================
RCS file: /home/mercury1/repository/mercury/README.Cygwin,v
retrieving revision 1.2
diff -U10 -r1.2 README.Cygwin
--- README.Cygwin	7 Mar 2006 06:40:39 -0000	1.2
+++ README.Cygwin	17 Mar 2006 00:21:10 -0000
@@ -150,10 +150,30 @@
 will need a previously installed Mercury compiler (for example, one of
 the recent releases of the day).  You will also need GNU autoconf, which
 can be downloaded from:
 
 	<ftp://ftp.gnu.org/pub/gnu/autoconf/>
 
 Autoconf should configure, build and install directly from the source
 package.
 
 -----------------------------------------------------------------------------
+
+MEMORY ALLOCATION
+
+By default no Cygwin program can allocate more than 384 MB of memory
+(program+data).  It is possible to exceed this limit, especially if one
+is using a debugging grade.  In which case the runtime will report the
+following error
+
+	"GC Warning: Out of Memory!  Returning NIL!"
+
+To increase the maximum amount of memory a cygwin program can consume
+execute the following command, replacing 1024 with a value that makes
+sense for your system.
+
+regtool -i set /HKLM/Software/Cygnus\ Solutions/Cygwin/heap_chunk_in_mb 1024
+
+See <http://cygwin.com/cygwin-ug-net/setup-maxmem.html> for more
+details.
+
+-----------------------------------------------------------------------------

--------------------------------------------------------------------------
mercury-reviews mailing list
post:  mercury-reviews at cs.mu.oz.au
administrative address: owner-mercury-reviews at cs.mu.oz.au
unsubscribe: Address: mercury-reviews-request at cs.mu.oz.au Message: unsubscribe
subscribe:   Address: mercury-reviews-request at cs.mu.oz.au Message: subscribe
--------------------------------------------------------------------------