--- a/userlibandfileserver/fileserver/sfile/sf_utl.cpp	Thu Aug 19 11:14:22 2010 +0300
+++ b/userlibandfileserver/fileserver/sfile/sf_utl.cpp	Tue Aug 31 16:34:26 2010 +0300
@@ -613,9 +613,11 @@
 	}
 
 
-//
-// Returns ETrue if aDes only contains spaces or is zero length
-//
+
+/**
+    @return ETrue if aDes only contains spaces or is zero length
+    Note that _all_ UNICODE space characters are treated as usual spaces
+*/
 static TBool IsSpace(const TDesC& aDes)
 	{
 
@@ -890,38 +892,43 @@
 	return powerGood;
 	}
 
+//---------------------------------------------------------------------------------------------------------------------------------
+/**
+    Decrement mount's lock counter when the mount resource, like a file or directory is opened. 
+    See also: CMountCB::LockStatus()   
+*/
 void AddResource(CMountCB& aMount)
-//
-// Decrement resource counters
-//
 	{
 	__CHECK_DRIVETHREAD(aMount.Drive().DriveNumber());
 	__ASSERT_DEBUG(aMount.LockStatus()<=0,Fault(ERawDiskBadAccessCount2));
 	aMount.DecLock();
 	}
 
+/**
+    Increment mount's lock counter when the mount resource, like a file or directory is closed. 
+    See also: CMountCB::LockStatus()   
+*/
 void RemoveResource(CMountCB& aMount)
-//
-// Increment resource counters
-//
 	{
 	__ASSERT_DEBUG(aMount.LockStatus()<0,Fault(ERawDiskBadAccessCount1));
 	aMount.IncLock();
 	}
 
 
+/**
+    Increment mount's lock counter when the disk access (Format, Raw disk) is opened on the mount
+    See also: CMountCB::LockStatus()   
+*/
 void AddDiskAccess(CMountCB& aMount)
-//
-// Increment resource counters
-//
 	{
 	aMount.IncLock();
 	}
 
+/**
+    Decrement mount's lock counter when the disk access (Format, Raw disk) is closed on the mount
+    See also: CMountCB::LockStatus()   
+*/
 void RemoveDiskAccess(CMountCB& aMount)
-//
-// Decrement resource counters
-//
 	{
 	aMount.DecLock();
 	}