Added javadoc

Hopefully that's a good start... 
shouldn't the time unit be clearly specified ? it seems to be millis for now, see [Ehcache](../../tree/master/core/src/main/java/org/ehcache/Ehcache.java#L63)