--- a/AbstractTime.st	Tue Mar 22 12:47:08 2016 +0100
+++ b/AbstractTime.st	Tue Mar 22 12:52:45 2016 +0100
@@ -512,6 +512,7 @@
     "
 ! !
 
+
 !AbstractTime methodsFor:'abstract'!
 
 hours
@@ -990,7 +991,10 @@
 !
 
 asSeconds
-    "return the number of seconds elapsed since midnight"
+    "get the seconds since some point of time in the past.
+     For Time instances, this is the number of seconds elapsed since midnight;
+     For TimeDurations, that is the duration in seconds;
+     For TimeStamps, that is the number of seconds since the epoch"
 
     ^ self getSeconds