0
ответов

Как лучше всего обрабатывать / форматировать документацию Javadoc и аннотации в коде? [дубликат]

Я просмотрел этот форум, погуглил и не знаю, как лучше всего обрабатывать документацию Javadoc и аннотации, которые появляются вместе в одном классе. Судя по тому, что я вижу от Sun / ...
вопрос задан: 8 August 2011 14:11
0
ответов

Проектирование API-интерфейсов на Java с использованием нисходящего подхода. Является ли составление документации Javadoc лучшей отправной точкой?

Когда мне нужно создать API на Java, я обычно начинаю с открытие моей IDE и создание пакетов, классов и интерфейсов. Реализации методов все фиктивные, но ...
вопрос задан: 5 August 2011 10:45
0
ответов

Дата создания в JavaDoc

Я разрабатываю библиотеку Java и пытаюсь определить хороший заголовок через JAutoDoc. Он работает нормально, но я не могу понять, как автоматически определять дату создания файла. Существует ...
вопрос задан: 27 July 2011 08:23
0
ответов

Автоматическое распространение javadoc частных полей на геттеры / сеттеры?

Я задокументировал частные поля bean-компонентов с помощью Javadoc, объясняя, для чего предназначено каждое поле. Могу ли я каким-то образом распространить эту документацию на соответствующие геттеры / сеттеры, чтобы уменьшить дублирование ...
вопрос задан: 12 July 2011 23:41
0
ответов

Копировать javadocs с сайта документации в локальный zip-файл

Мне интересно, есть ли какой-нибудь инструмент для "загрузки" javadocs с онлайн-хоста в локальный файл. Онлайн-документы, которые я использую, обычно отклоняют клиентов, таких как eclipse, что затрудняет работу, поэтому мне нужно ...
вопрос задан: 11 July 2011 20:30
0
ответов

Интерфейс Java API

С тех пор, как я начал экспериментировать со Scala, у меня возник один большой вопрос, касающийся Java API: почему Oracle сохраняет ту же старую HTML-страницу с тегами "frameset" и вообще без функции поиска? Это ...
вопрос задан: 5 July 2011 20:20
0
ответов

Документирование yaml [закрыто]

Есть ли что-то вроде javadoc или rdoc для документирования файлов YAML, чтобы мы могли его извлечь в HTML-документацию? В идеале с синтаксисом уценки.
вопрос задан: 5 July 2011 07:50
0
ответов

Как создать Javadoc для отдельных перечислений класса

Я пишу javadoc для класса, который содержит его собственные перечисления. Есть ли способ создать javadoc для отдельных перечислений? Например, прямо сейчас у меня есть что-то вроде этого: / ** * This ...
вопрос задан: 1 July 2011 15:13
0
ответов

Объедините Javadoc для нескольких модулей в единую коллекцию

У меня есть приложение Java, состоящее из нескольких модулей. Я хотел бы сгенерировать Javadoc для них всех вместе: то есть из этих нескольких модулей мне нужен единый набор файлов HTML ...
вопрос задан: 28 June 2011 16:10
0
ответов

Как создать несколько уровней отступа в Javadoc?

Предположим, это как часть документируя свой код (Javadoc), вы хотите указать, что отношения между элементами используют глубокие отступы. Как я могу создать вложенный список как: some element some ...
вопрос задан: 26 June 2011 22:06
0
ответов

Документация Javadoc для проектной документации [закрыто]

Я хочу задокументировать проект Java, над которым я работаю. В прошлом я обычно документировал дизайн и программный API в вики. Однако после недавнего использования Mockito для имитационных тестов я был впечатлен ...
вопрос задан: 23 June 2011 19:03
0
ответов

Как добавить javadoc к статическому инициализатору в Java?

Я провел рефакторинг класса и переместил некоторый код из конструктора в статический инициализатор. Что мне делать с javadoc, который был в конструкторе? Можно ли добавить javadoc в статический ...
вопрос задан: 23 June 2011 13:06
0
ответов

Как просматривать документацию Javadoc в Eclipse?

Я использую стороннюю библиотеку, у меня есть входит в мой проект. Он содержит классы для приложения, но не содержит исходников или Javadoc. Как и ожидалось, при наведении курсора мыши на импортированный объект не отображается документация javadoc. П
вопрос задан: 20 June 2011 02:20
0
ответов

Как мне изменить Javadoc, когда я изменяю чужой код?

Я работаю над чужим кодом и вношу значительные изменения. (Я конвертирую его для использования другой базы данных, чем та, которую он использовал изначально.) Как мне указать в комментариях Javadoc ...
вопрос задан: 17 June 2011 00:05
0
ответов

Следует ли использовать комментарий «не из документации Javadoc»?

Я реализовал свой собственный метод, определенный в интерфейсе. Однако, когда я пытаюсь добавить Javadoc к этому методу, Eclipse дал мне такой комментарий: / * (non-Javadoc) * @see javax.servlet ....
вопрос задан: 14 June 2011 01:54
0
ответов

Как включить javadoc кода Scala при распространении библиотечных Jar-файлов?

Этот вопрос связан с вызовом кода Scala из кода java. Когда я включаю некоторую библиотеку scala (в формате jar), возвращаемые типы часто имеют тип scala.collection и другие типы Scala. Когда ...
вопрос задан: 7 June 2011 08:07
0
ответов

Комментарии к методам @Override

Мой вопрос на самом деле не является проблемой программирования .. Я должен прокомментировать свой код для JavaDoc, но я думаю, что это немного странно повторно комментировать существующие методы (Я думаю о методах @Override). Например, ...
вопрос задан: 6 June 2011 07:25
0
ответов

Существуют ли «официальные» документы Javadoc для MySQL JDBC Connector? [закрыто]

Доступны ли документы javadoc для соединителя MySQL JDBC? Если да, то где их найти? Погуглил, я наткнулся на такие ссылки, как Class MysqlDataSource. Но это что официальное? Думаю, я ...
вопрос задан: 31 May 2011 15:16
0
ответов

Почему Javadoc не заставляет мои подклассы унаследовать документацию от классов Java?

Я искал ответ в течение нескольких месяцев и пробовал несколько вещей, включая распаковку сжатой папки src.zip и используя его в качестве параметра для Javadoc (например: javadoc -...
вопрос задан: 28 May 2011 20:41
0
ответов

Хороший справочник по популярным тегам javadoc?

Я хотел бы использовать настраиваемые теги в своих документах javadoc, но придерживаюсь каких-то условием, чтобы другим людям было легче понять их. На официальной странице документации Oracle по javadoc они «...
вопрос задан: 24 May 2011 17:13
0
ответов

Как мне сделать так, чтобы класс Ant Javadoc исключал два файла?

Я документирую некоторые веб-службы Java и поддерживающие типы данных. Есть две службы, которые я не хочу документировать. Как правильно исключить небольшое количество файлов из Ant ...
вопрос задан: 20 May 2011 09:57
0
ответов

Где можно загрузить исходный код стандартного документа JavaDoc для текущих выпусков (1.5 или 1.6)

Я заинтересован в изменении стандартного JavaDoc Doclet, чтобы создать дополнительную документацию перед обычным выводом тегов. Глядя на код (с помощью декомпилятора), я вижу, что мой единственный настоящий ...
вопрос задан: 18 May 2011 18:57
0
ответов

Любой способ встроить javadoc в jar

Есть ли способ встроить javadoc (папку / doc, созданную JavaDoc Ant Task) в мою библиотеку jar, которая содержит мои файлы .class? Я бы предпочел не отправлять исходный код и хотел бы, чтобы пользователи могли ...
вопрос задан: 5 May 2011 07:12
0
ответов

Генерация латексной документации Javadoc

Есть ли способ сгенерировать латексный документ из документации моего исходного файла java? Я не хочу включать элементы LaTeX в свои комментарии к документации, я просто хочу создавать файлы LaTeX вместо ...
вопрос задан: 3 May 2011 13:20
0
ответов

Можно ли создавать классы Java из JavaDoc?

Вот проблема: в настоящее время моя команда работает на поставщика, который предоставил нам огромную спецификацию JavaDoc из своей библиотеки, но не предоставить файл .jar с заглушками или реализацией. Мы уже говорили с ...
вопрос задан: 3 May 2011 03:53
0
ответов

Eclipse не имеет java-документа для отображения информации о классах и методах. как их прикрепить? + android

Я работаю над android в среде eclipse holies. но мое затмение не помогает мне найти подробности о классе или методе при написании кода. как их прикрепить? + android Я работаю над android в среде eclipse holies. но мое затмение не помогае
вопрос задан: 28 April 2011 07:14
0
ответов

Doclet- Получить обобщенные шаблоны списка

Я пишу доклет, расширяющий com.sun.javadoc.Doclet. Когда я хочу задокументировать ArrayList как поле метода, я хочу получить тип универсального (например, при документировании ArrayList <...
вопрос задан: 26 April 2011 11:51
0
ответов

Удалите комментарий «Создано Javadoc на <дата> <время>» в сгенерированном Javadoc

Javadoc команда автоматически вставляет комментарий, например: в каждый сгенерированный файл HTML. Это ...
вопрос задан: 10 April 2011 18:31
0
ответов

Плюсы и минусы управления версиями javadoc

Мне интересно, или не фиксировать файлы Javadoc в репозитории SVN моего проекта. Я читал о передовых методах использования SVN, включая несколько интересных вопросов по SO, но ни один из них еще не был ...
вопрос задан: 7 April 2011 21:59
0
ответов

Проблема с добавлением строкового значения в реестр с помощью файла .reg

Я использую машину win2k3. Я написал файл .reg, как показано ниже: Редактор реестра Windows версии 5.00 [HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \ Services \ KalleService \ Parameters] isEmpty ()) {стек возврата [позиция]; } else {throw new ...
вопрос задан: 1 April 2011 07:07