[dotgnu-pnet-commits] [SCM] DotGNU Portable.NET engine, compilers and tools (pnet) branch, master, updated. 230009e41bc8cf94ddde661912077eb56c7b53fb

[Klaus Treichel]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "DotGNU Portable.NET engine, compilers and tools (pnet)".

The branch, master has been updated
       via  230009e41bc8cf94ddde661912077eb56c7b53fb (commit)
      from  a04e057b5b034e20efebe577146072bed4655f0a (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
http://git.savannah.gnu.org/cgit/pnet.git/commit/?id=230009e41bc8cf94ddde661912077eb56c7b53fb

commit 230009e41bc8cf94ddde661912077eb56c7b53fb
Author: Klaus Treichel <address@hidden>
Date:   Wed Sep 2 16:23:44 2009 +0200

    Improve comments for ILGCAlloc and ILGCAllocAtomic.

diff --git a/ChangeLog b/ChangeLog
index 930eef6..f8bbc11 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -14,6 +14,8 @@
        (ThreadStart): Simply store the current thread in _myThread if
        compiler tls is used instead of calling pthread_setspecific.
 
+       * include/il_gc.h: Improve comments for ILGCAlloc and ILGCAllocAtomic.
+
 2009-09-01  Klaus Treichel  <address@hidden>
 
        * configure.in: Add checks for availability of pthread_mutex_timedlock,
diff --git a/include/il_gc.h b/include/il_gc.h
index f66f917..d71fff4 100644
--- a/include/il_gc.h
+++ b/include/il_gc.h
@@ -40,15 +40,24 @@ void ILGCDeinit();
 
 /*
  * Allocate a block of memory from the garbage collector.
- * The block may contain pointers to other blocks.  The
- * block is guaranteed to be zero'ed.
+ * The block may contain pointers to other blocks allocated brom the
+ * garbage that have to be kept alive while referenced in this block.
+ * That means the block is scanned for pointers during garbage collection.
+ * The block is guaranteed to be zero'ed.
  */
 void *ILGCAlloc(unsigned long size);
 
 /*
  * Allocate a block of memory from the garbage collector
- * that will never contain pointers.  Use this for allocating
- * arrays of atomic numeric types.  The block is zero'ed.
+ * that will never contain pointers to blocks that have to be kept alive
+ * while being referenced from this block.
+ * Use this for allocating arrays of atomic numeric types or blocks that
+ * contain only pointers to other blocks which are kept alive through other
+ * references. For example to avoid circular references which are not easy
+ * to be broken by the garbage collector.
+ * That means blocks allocated this way are not scanned for pointers during
+ * garbage collection.
+ * The block is guaranteed to be zero'ed.
  */
 void *ILGCAllocAtomic(unsigned long size);
 

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog       |    2 ++
 include/il_gc.h |   17 +++++++++++++----
 2 files changed, 15 insertions(+), 4 deletions(-)


hooks/post-receive
-- 
DotGNU Portable.NET engine, compilers and tools (pnet)