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

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

Следующее описывает изменения и улучшения, сделанные для Javadoc 7.

Документы HTML, сгенерированные инструментом Javadoc, приспосабливают HTML 4.01 Транзитному DTD (Определение типа документа). Однако, инструмент Javadoc в настоящий момент не гарантирует соответствие этому DTD контент любых фрагментов HTML в комментариях Джейвэдока или значениях опции, определенных пользователем.

Сгенерированные документы HTML также совместимы к Стандартам Доступности Электронной и Информационной технологии (Раздел 508). Точно так же инструмент Javadoc в настоящий момент не гарантирует соответствие к этому стандарту контент любых определенных пользователем фрагментов HTML.

Стиль документов HTML, сгенерированных инструментом Javadoc, был обновлен для этого выпуска. Это выполняется с CSS (Каскадные таблицы стилей) файлы. Следовательно, это позволяет изменить стиль Вашей документации API, изменяя файл CSS. Это делает это также возможным для будущих обновлений и выпусков JDK, чтобы включать дополнительные опции стили через файлы CSS.

Файл таблицы стилей располагается в пределах репозитария кода и копируется во время создавать генерации. Файл, stylesheet.css, находится в com.sun.tools.docslets.internal.toolkit.resources. Можно также получить доступ к Javadoc stylesheet.css онлайн. Файл сгенерирован во время документов API, создают.

Опция -stylesheetfile <path> может использоваться, чтобы определить таблицу стилей кроме значения по умолчанию.

Для получения дополнительной информации см. следующие RFE: 7052425 и 6851834.

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