thanks for this explanation. Could you please put it into the javadoc section?