--- a/Time.st	Mon May 16 09:54:03 2016 +0200
+++ b/Time.st	Mon May 16 12:23:17 2016 +0200
@@ -627,13 +627,16 @@
 milliseconds
     "get the milliseconds part
      (notice: that is NOT the total number of millis (since midnight),
-     but the fractional part only. Use this only for printing"
+     but the fractional part only. Use this only for printing.
+     asMilliseconds or getMilliseconds is probably what you want"
 
     ^ timeEncoding \\ 1000
 !
 
 minutes
-    "return the number of minutes within the hour (i.e. 0..59)"
+    "return the number of minutes within the hour (i.e. 0..59).
+     (notice: that is NOT the total number of minutes (since midnight),
+     but the fractional part only. Use this only for printing."
 
     ^ (self getSeconds \\ 3600) // 60
 
@@ -643,7 +646,10 @@
 !
 
 seconds
-    "return the number of seconds within the minute (i.e. 0..59)"
+    "return the number of seconds within the minute (i.e. 0..59).
+     (notice: that is NOT the total number of seconds (since midnight),
+     but the fractional part only. Use this only for printing.
+     asSeconds or getSeconds give you the nr of seconds since midnight"
 
     ^ self getSeconds \\ 60
 
@@ -1077,10 +1083,10 @@
 !Time class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libbasic/Time.st,v 1.104 2015-06-06 12:57:19 cg Exp $'
+    ^ '$Header$'
 !
 
 version_CVS
-    ^ '$Header: /cvs/stx/stx/libbasic/Time.st,v 1.104 2015-06-06 12:57:19 cg Exp $'
+    ^ '$Header$'
 ! !