Неужели нет лучшего способа документировать код Perl, чем POD?

Я давно программист на Perl, но у меня всегда возникают проблемы с документацией в POD.

Когда я использую комментарии POD в коде, код трудно читать. Когда я использую комментарии POD в конце файла, существует опасность, что документация не синхронизирована с кодом.

Мне не хватает стиля документации, похожего на Java.

/**
 * @description
 * ...
 */

Я ищу более простую и интуитивно понятную документацию стиль. Есть ли такая вещь?

14
задан laurent 20 February 2012 в 14:29
поделиться