Я был вдохновлен обсуждением выше и расширил мой обертка JSLint сценарий соответственно. Это довольно примитивно, но, кажется, делает задание.
Я использовал PlDoc и считаю его действительно хорошим. Другими инструментами я не пользовался, поэтому сравнивать не могу. Я обнаружил, что PlDoc хорошо справляется с основами. Мне нужны были более продвинутые функции, поэтому я создал наш собственный инструмент, который добавил в PlDoc расширения для большего количества тегов. Кроме того, я не просто создаю с ним документацию, я также генерирую заголовки наших пакетов, используя некоторые теги PlDoc (например, @private).
Я рекомендую вам попробовать PlDoc, а затем настроить все, что не соответствует вашим потребностям. Установка не занимает так много времени, поэтому не нужно много времени, чтобы попробовать это.
Я использую NaturalDocs уже несколько лет и обнаружил, что его легко установить и использовать. Он очень похож на JavaDocs и поддерживает несколько языков, хотя я использовал его только с PL / SQL. Очень легко настраивается, хотя я не считаю необходимым возиться с этим.