diff -r c30940f6d922 -r e880629062dd halservices/hal/inc/hal_data.h
--- a/halservices/hal/inc/hal_data.h	Tue May 04 09:44:26 2010 +0100
+++ b/halservices/hal/inc/hal_data.h	Wed May 05 05:11:16 2010 +0100
@@ -1,4 +1,4 @@
-// Copyright (c) 1995-2009 Nokia Corporation and/or its subsidiary(-ies).
+// Copyright (c) 1995-2010 Nokia Corporation and/or its subsidiary(-ies).
 // All rights reserved.
 // This component and the accompanying materials are made available
 // under the terms of the License "Eclipse Public License v1.0"
@@ -35,6 +35,11 @@
     
     They are also used by the HAL accessor functions.
     
+    Note: It is not recommended to use HAL attributes to pass handles from the  
+	kernel to user-side clients due to resource overhead's that will affect 
+	existing clients of HAL. HAL is designed to allow simply hardware parameters
+	to be shared with user-side clients without resource allocation overheads.
+    
     @see HAL::Get()
     @see HAL::Set()
     */
@@ -1080,6 +1085,9 @@
 		
 		/**
 		A Handle to the display memory.
+		This attribute opens a chunk, the client is responsible for closing it.
+		Using HAL attribtues to open handles is not recommended and this 
+		attribute may be removed in the future. 
 
 		@prototype 9.5
 		*/