Spec-Zone .ru
спецификации, руководства, описания, API
Содержание документации

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

Этот документ описывает изменения, произведенные в инструменте Javadoc между версиями 1.4.0 и 1.4.1. Можно также видеть краткий список выдающихся ошибок, перечисленных в важных новых ошибках и регрессах, и можно просмотреть списки от нашей базы данных в Важных Исправлениях ошибок и Изменениях.

Упомянутые ниже изменения включают число ошибки и была ли фиксация во фронтэнде инструмента Javadoc ("инструмент") или стандарт doclet ("stddoclet"). Термин "регресс" появляется для функций, которые работали в 1.3.x, ворвались 1.4.0, и были фиксированы в 1.4.1.

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

Добавленный пакет и имена классов как ключевые слова в <META> теги. Это должно улучшить результаты поиска для поисковых систем тот взгляд на <META> теги. (4034096, stddoclet)

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

Выполнение Javadoc:

Регресс: Исправленная ошибка, где это по ошибке задокументировало.class файлы, найденные на пути к классу (если они принадлежат пакетам, которые передают в на командной строке). (4548768, инструмент)

Регресс: Фиксированный, чтобы обработать пакеты, названные *.java. (4507380, инструмент)

Добавленный лучше проверка, чтобы принять только допустимый исходный файл и имена пакета. (4434834, инструмент)

Ошибка/Предупреждающие сообщения

Фиксированный com.sun.tools.javadoc. Main.execute, чтобы не проигнорировать PrintWriters. (4587487, инструмент)

Добавленные кавычки вокруг пакета называют в сообщении об ошибке, когда "\" (наклонная черта влево, пространство) передал в. (4370719, инструмент)

Параметры командной строки:

Регресс: Фиксированный - используют опцию, которая была строго повреждена. (4496290, stddoclet)

Регресс: Фиксированный - кодирование опции для того, чтобы считать исходные файлы. (4661481, stddoclet)

Регресс: Фиксированный - соединяют опцию, чтобы обработать абсолютные пути. (4640745, stddoclet)

Фиксированный зависают, когда-subpackages передают на самое верхнее имя пакета. (4628237, инструмент)

Измененная диагностика - помогает к 'Опциям строки команды отображения и выходу'. (4501697, инструмент)

Теги:

Регресс: Фиксированный, чтобы должным образом вставить </DD> при использовании многократных тегов @author. (4651598, stddoclet)

Регресс: Фиксированный {@docRoot}, который вставлял дополнительную наклонную черту "/". (4524350, stddoclet)

Регресс: Фиксированный @throws в классе с реализацией, чтобы переопределить @throws в интерфейсе. (4633969, stddoclet)

Регресс: Фиксированный, чтобы позволить тегам @throws иметь двойные ошибочные имена классов. (4525364, stddoclet)

Регресс: Фиксированный {@inheritDoc}, который не работал. (4618686, stddoclet)

Добавленное предупреждение, когда нижний регистр {@docroot} используется вместо {@docRoot}. (4662945, stddoclet)

Разное

Добавленные интерфейсные константы к Постоянному списку Значений полей. (4526070, stddoclet)

Исправленные булевы постоянные поля, чтобы использовать истину/ложь, а не 0/1. (4587494, инструмент)

Удаленное дополнительное пространство добавления отступа для комментариев, которые опускают ведущую звездочку. (4587562, инструмент)

Регресс: Фиксированный StringIndexOutOfBoundsException, вызванный многократным <a href> теги. (4638015, stddoclet)

Измененный, таким образом, ничто не сериализуемо когда Сериализуемый, не находится на-bootclasspath. (4644960, инструмент)

Удаленный" ()" из заголовка окна, когда фреймы выключены. (4530730, stddoclet)

Примечания для doclet программистов:

- опция использования была повреждена, потому что объекты Документа больше не уникальны в 1.4.0. Чтобы отследить класс и использование пакета, стандарт doclet создает хэш-таблицы Документа/Списка, где ключом является ClassDoc или PackageDoc, и Список является списком объектов Документа, которые используют ключ. Этот способ определить класс и использование пакета хорошо работал с предыдущими версиями инструмента Javadoc, но это, кажется, не работает с 1.4.x. Объект Документа не должен использоваться в качестве ключа в хэш-таблице. Они не уникальны - то есть, инструмент Javadoc, кажется, способен к созданию двух различных объектов ClassDoc, которые представляют тот же самый класс. Чтобы исправить эту ошибку, мы использовали полностью определенное имя в качестве ключа в хэш-таблице. Мы планируем сделать объекты Документа уникальными снова в некоторый момент.


Oracle и/или его филиалы Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.
Свяжитесь с Нами