added transition javadoc