BS-8505, add javadoc