Improve javadoc in protostuff-api

First try to fix https://github.com/protostuff/protostuff/issues/13

Fixed more than hundred warnings of doclint, but it seems that there still is more than thousand other warnings in this module.