Альтернатива для Javadoc?

Я использую Java в течение многих лет, мне действительно нравится язык, кроме Javadoc. Документ, сгенерированный javadoc, заставляет меня чувствовать, что я просматриваю сеть в 1990-х. Чтобы сделать красивый документ, вы должны вставить неясные HTML-теги, которые делают ваши комментарии почти нечитаемыми перед созданием HTML-файла.

Я ищу какую-то альтернативу для javadoc, reStructuredText - мой первый выбор, но для него нет доклета. Другим выбором является уценка, но она в основном нацелена на html, поэтому я отношусь к ней как к последнему средству, если не могу найти другого пути.

Я также рассматриваю возможность разделения комментариев из файла Java, но это беспокоит разработчиков, которые просматривают код в IDE.

Есть хорошие идеи?

Источник

1 ответ

Решение

Возможно, вам не нужно использовать альтернативу Javadoc. Если вы используете Java 7, новая версия Javadoc была переработана.

Вот пример вывода: Справочник по Java 7

Источник
Другие вопросы по тегам