Javadoc в JDK 8: недопустимый " самозакрывающийся элемент не допускается"


каковы наилучшие обходные пути при запуске javadoc с помощью JDK 8 и один получает эту ошибку.

похоже, что для JDK 8 было решено, что теги вроде <br /> и <p /> должны генерировать ошибки, потому что они являются недопустимыми (строгими) HTML 4. смотрите список рассылки обсуждения JDK здесь

интересно, потому что я просто хотел скомпилировать какой-то проект java с помощью maven и споткнулся об эту проблему. Конечно, я могу подать билет с проектом (и я думаю, я буду), но было бы здорово, если есть способ отключить это поведение (для машины). В противном случае, я ожидаю, что многие проекты должны быть исправлены, прежде чем они могут быть построены на JDK 8 без проблем.

4 51

4 ответа:

для этих двух частных случаев, я думаю, что рекомендуемое действие состоит в том, чтобы заменить их <p>. этой - это ссылка на документацию Oracle.

чтобы удалить ошибки в документации заменить:

  • <p/> с <p>
  • <br/> С <br>

все работает отлично после коррекции в исключенном пути.

"изЧто нового в JDK 8" от oracle.com:

инструмент javac теперь поддерживает проверку содержимого комментариев javadoc на наличие проблем, которые могут привести к различным проблемам, таким как недопустимый HTML или проблемы доступности, в файлах, которые создаются при запуске javadoc. Эта функция включена с помощью опции new-Xdoclint. Для получения дополнительной информации см. выходные данные от запуска "javac-X". Эта функция также доступна в инструмент javadoc, и разрешена по умолчанию.

сейчас я сделал то, что он сказал мне сделать. На JDK 7 выход "javac-X" не упоминает параметр-Xdoclint. Однако на JDK 8 он дает:

 -Xdoclint:(all|none|[-]<group>)[/<access>]
    Enable or disable specific checks for problems in javadoc comments,
    where <group> is one of accessibility, html, missing, reference, or syntax,
    and <access> is one of public, protected, package, or private.

Итак, запустите утилиту Javadoc следующим образом:

javadoc.exe -Xdoclint:none <other options...>

в моем скрипте ошибка, о которой Вы упомянули, исчезла с помощью этой опции.

хотя можно отключить проверку ошибок с помощью опции-Xdoclint, она не устраняет проблему, а просто скрывает проблему. Чтобы сделать допустимыми документы HTML4 следующие замены являются правильными.

  • замените самозакрывающиеся теги br обычными тегами br (
    с
    )
  • замените пустые теги p на теги br (

    с
    )
  • убедитесь, что все теги p имеют содержимое и закрыты (

    ... с ...)