[commit: ghc] master: Note infinite stack default in release notes. (c798a8c)

[git at git.haskell.org]

Repository : ssh://git@git.haskell.org/ghc

On branch  : master
Link       : http://ghc.haskell.org/trac/ghc/changeset/c798a8c6c66d826efdc0201fa56d45337eecc2af/ghc

>---------------------------------------------------------------

commit c798a8c6c66d826efdc0201fa56d45337eecc2af
Author: Austin Seipp <aseipp at pobox.com>
Date:   Sun Sep 8 04:07:23 2013 -0500

    Note infinite stack default in release notes.
    
    Signed-off-by: Austin Seipp <aseipp at pobox.com>


>---------------------------------------------------------------

c798a8c6c66d826efdc0201fa56d45337eecc2af
 docs/users_guide/7.8.1-notes.xml |   21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/users_guide/7.8.1-notes.xml b/docs/users_guide/7.8.1-notes.xml
index 15bf82b..2021fc6 100644
--- a/docs/users_guide/7.8.1-notes.xml
+++ b/docs/users_guide/7.8.1-notes.xml
@@ -346,6 +346,27 @@
 
             <listitem>
                 <para>
+                     By default, the maximum stack size in the runtime
+                     system is now infinite. This is controlled by the
+                     <literal>+RTS -K</literal> flag, which was
+                     previously defaulted to 8MB. In general, this
+                     will allow more programs to run as they will no
+                     longer stack overflow as quickly, although they
+                     may use much more memory.
+               </para>
+
+                <para>
+                     Note that you will still eventually encounter a
+                     stack overflow - when the heap is completely
+                     exhausted, as stacks are serviced from the
+                     storage manager. This will cause a runtime abort
+                     after invoking
+                     <literal>StackOverflowHook</literal>.
+               </para>
+           </listitem>
+
+            <listitem>
+                <para>
                     The performance of <literal>StablePtr</literal>s and
                     <literal>StableName</literal>s has been improved.
                </para>