Decided to add some Javadoc after all to help clarify what is going on.

Good for me too as I've fixed some (potential) bugs by simplifying some stuff because I've had to think about it again....