спецификации, руководства, описания, API

Новые функции и возможности в Javadoc 1.3

Этот документ описывает изменения, произведенные в инструменте Javadoc между версиями 1.2.2 и 1.3.

Новые Функции

Добавленный {@docRoot} - Это - новый тег Javadoc, который представляет путь от любой страницы класса до корневого каталога сгенерированной иерархии документации. Цель этого тега состоит в том, чтобы позволить Вам делать ссылку к единственной веб-странице от всех сгенерированных страниц, такой относительно страницы авторского права или корпоративного логотипа от нижних колонтитулов всех сгенерированных страниц. (Этот тег был поврежден в 1.3 Бетах) (Запрос #4197510).

MIF doclet. Это добавляет возможность генерировать вывод MIF, для того, чтобы импортировать в FrameMaker и возможное преобразование в PDF, PS, RTF, Word, или WordPerfect.
ВАЖНЫЙ - MIF doclet не включается в Java 2 SDK. Следует получить это отдельно из: MIF Doclet домашняя страница

Исправления ошибок

4260169: Добавленный <код> HTML-тэг к "Переопределениям", "Указанный" и "Теги, скопированные с".

4276757: Фиксированный Javadoc, чтобы задокументировать наследованные общедоступные элементы частных на пакет классов.

4214932: Исправленная ошибка, где частные поля/методы были задокументированы как наследовано.

4216836: "Указанный:" ссылка была добавлена для метода в интерфейсе, реализовывая метод от суперинтерфейса.

4227539: Мы теперь перечисляем найденный обход интерфейсов полностью дерево иерархии. Для интерфейсов, добавленных "Все суперинтерфейсы: A, B, C". Для классов, добавленных "Все реализованные интерфейсы: A, B, C".

4233601: Во внутренней сводке класса, исправленная ошибка, где Исключения были по ошибке перечислены как Интерфейсы.

4216434: Фиксированные Javadoc - помогают опции, которая не печатала все опции (-helpfile,-stylesheetfile).

4235271: Исправленная ошибка, где переопределение метода в Интерфейсе теперь показывают как "Указанное".

4231274: Добавленный недостающее пространство перед вводной фразой" (также расширяется...)",

4285930: Измененный второй параметр -linkoffline так, чтобы, предоставляя относительный путь, Вы сделали это относительно целевого каталога (предоставленный -d) а не относительно текущего каталога от того, куда javadoc выполняется.

Будущие Улучшения

Возможно сделать в выпуске после 1.3

XML Doclet - для стандартизированного представления статической информации о программе ряда пакетов. Это могло бы возможно позволить разработчикам с приращением создавать единственный документ из отдельных выполнений Javadoc. Сохраняя промежуточное представление от каждого Javadoc работает, это позволило бы объединяться тех в полный документ, с полностью обновленным индексом, деревом, иерархией классов, списком подклассов, и т.д.

Свяжитесь с Нами