--- a/UnixOperatingSystem.st	Fri Apr 29 13:58:04 2016 +0200
+++ b/UnixOperatingSystem.st	Fri Apr 29 13:59:05 2016 +0200
@@ -3785,11 +3785,13 @@
 !
 
 createFileForReadWrite:pathName
+    "open a file for reading and writing, return an os specific fileHandle."
 
     ^ self open:pathName attributes:#(O_RDWR O_CREAT O_TRUNC) mode:nil
 !
 
 createFileForWrite:pathName
+    "create a file for writing, return an os specific fileHandle."
 
     ^ self open:pathName attributes:#(O_WRONLY O_CREAT O_TRUNC) mode:nil
 !
@@ -3990,12 +3992,14 @@
 !
 
 openFileForAppend:pathName
+    "open a file for appending, return an os specific fileHandle."
 
     ^ self open:pathName attributes:#(O_RDWR O_APPEND) mode:nil
 !
 
 openFileForRead:pathName
-
+    "open a file for reading, return an os specific fileHandle."
+    
     ^ self open:pathName attributes:#(O_RDONLY) mode:nil
 !
 
@@ -4005,11 +4009,13 @@
 !
 
 openFileForReadWrite:pathName
+    "open a file for reading and writing, return an os specific fileHandle."
 
     ^ self open:pathName attributes:#(O_RDWR)  mode:nil
 !
 
 openFileForWrite:pathName
+    "open a file for writing, return an os specific fileHandle."
 
     ^ self open:pathName attributes:#(O_WRONLY)  mode:nil
 !