diff -r d45b74d3fb20 -r d57b86b1867a kernel/eka/include/e32const.h
--- a/kernel/eka/include/e32const.h	Tue Aug 31 11:40:45 2010 +0100
+++ b/kernel/eka/include/e32const.h	Mon Sep 13 15:16:07 2010 +0100
@@ -2409,7 +2409,7 @@
 	
 
 	/**
-	The free memory level has crossed a specified threshold value.
+	The system's free memory level has crossed a specified threshold value.
 	
 	On systems that support data paging, this is also generated where the available swap space
 	crosses one of the specified threshold values.
@@ -2418,13 +2418,20 @@
 
 	
 	/**
-	A memory allocation has failed due to insufficient free memory.
+	A memory allocation has failed due to insufficient free memory somewhere in the system.
+
+	Please note that this notifcation is generated when any memory allocation fails, not just
+	allocations attempted by the current process.
+
+	This is designed to notify a system memory manager component when a memory allocation failed
+	even when the system's memory has not crossed the low-memory threshold.  It should not be used
+	as part of a memory management strategy within a single process.
 	*/
 	EChangesOutOfMemory=0x40,
 	
 
 	/**
-	The free memory level has fallen below the low-memory threshold
+	The system's free memory level has fallen below the low-memory threshold
 	@see UserSvr::SetMemoryThresholds()
 	*/
 	EChangesLowMemory=0x80,