added some javadocs and xml for future support