Куда следует поместить XSD-документацию, чтобы JAXB мог подобрать ее и поместить в Javadoc?

Я разрабатываю первый веб-сервис контракта и хочу включить соответствующую документацию в схему, чтобы она была как можно более информативной.

Как лучше всего размещать аннотации и документацию XSD таким образом, чтобы JAXB подбирал их и включал в сгенерированные файлы Java как Javadoc? Я заметил, что некоторые элементы и перечисление получают документацию, а некоторые нет. Есть ли конкретное место, где я должен помещать их после каждого элемента, определения сложного типа или операции WSDL, чтобы он описывал каждый класс, элемент или метод?


person jbx    schedule 13.05.2010    source источник