Added javadoc

Hopefully that's a good start... 
That's the exact question here, what should the unit be ?