#44: some update to javadocs