# HG changeset patch
# User Me@portablequad
# Date 1329167080 28800
# Node ID bddabc0956b9ee01f593b5e2862d95a683367aec
# Parent  06640b616b6d60694789663b3d5d66bbb03bfa46
added  pure C brch

diff -r 06640b616b6d -r bddabc0956b9 __brch__default
--- a/__brch__default	Mon Feb 13 10:34:32 2012 -0800
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,1 +0,0 @@
-The default branch is for use with normal C code.  Other branches specialize the library for use with VMS..  they may need VMS header files, and the working directory may be located at various different positions relative to the VMS implementation.
\ No newline at end of file
diff -r 06640b616b6d -r bddabc0956b9 __brch__pure_C
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/__brch__pure_C	Mon Feb 13 13:04:40 2012 -0800
@@ -0,0 +1,6 @@
+
+This branch is for use in pure C code (*not* inside VMS-based language application code)
+
+There are two versions of the library -- one for pure C use, the other for use inside VMS or within applications written in a VMS-based language (IE, inside a top-level function or a call descendant of a top-level function) -- but only when the VMS is the "MC_shared" version.
+
+The reason is that VMS that uses shared memory on multicores moves the SlaveVPs around among cores.  But, the libC and glibC malloc stores info at the top of the stack (a "clever" hack), for a speed improvement.  So, when VMS manipulates the stack pointer, and/or moves Slaves to different cores, the "free" seg faults (that was FUN to figure out ; )  So, this version of VMS implements its own malloc. 
\ No newline at end of file