Гость
Целевая тема:
Создать новую тему:
Автор:
Форумы / Java [игнор отключен] [закрыт для гостей] / Включение xsd в javadoc / 5 сообщений из 5, страница 1 из 1
05.09.2007, 17:37:37
    #34778786
rublic
Гость
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Включение xsd в javadoc
Доброго времени суток!

Имеется такой вопрос: можно ли в документацию, сгенерированную в javadoc добавить некоторые свои файлы, например используемые в проекте xsd-схемы или просто текстовые файлы.
Неужели инструмент собирает только html из комментариев в коде?

Заранее благодарен за помощь.
...
Рейтинг: 0 / 0
06.09.2007, 11:37:22
    #34780348
wessen
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Включение xsd в javadoc
rublic
Неужели инструмент собирает только html из комментариев в коде?



Так оно и есть. А в чем проблема? Указывай например в комментариях к классу или методу ссылку на xsd и делов то.
...
Рейтинг: 0 / 0
06.09.2007, 14:01:13
    #34781239
Leonidv
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Включение xsd в javadoc
Я думаю, надо вот в эту сторону копать:
http://www.developer.com/java/other/article.php/3085991
...
Рейтинг: 0 / 0
06.09.2007, 14:06:02
    #34781274
TiG
TiG
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Включение xsd в javadoc
Помню что можно было как то. Из доки :
Support FilesA doc-files directory that holds any image, example, source code or other files that you want copied to the destination directory. These files are not processed by the Javadoc tool in any manner -- that is, any javadoc tags in them will be ignored. This directory is not generated unless it exists in the source tree.
...
Рейтинг: 0 / 0
07.09.2007, 13:23:59
    #34784231
rublic
Гость
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Включение xsd в javadoc
2 wessen
Просто документация к коду должна содержать явную ссылку (например в корне) на используемые в проекте xsd-схемы, чтобы пользователь не искал по сгенерированным пакетам и классам (речь, как вы уже наверное догадались, идет о биндинге) то, что надо, а сразу ушел в нужный раздел.

2 TiG
Но ведь из приведенной цитаты следует, что сгенерённые доки не будут иметь отношения с скопированным файлам.

"These files are not processed by the Javadoc tool in any manner -- that is, any javadoc tags in them will be ignored. This directory is not generated unless it exists in the source tree."
...
Рейтинг: 0 / 0
Форумы / Java [игнор отключен] [закрыт для гостей] / Включение xsd в javadoc / 5 сообщений из 5, страница 1 из 1
Найденые пользователи ...
Разблокировать пользователей ...
Читали форум (0):
Пользователи онлайн (0):
x
x
Закрыть


Просмотр
0 / 0
Close
Debug Console [Select Text]