1.2.2-9 (Add notes and javadocs)

Add notes and javadocs