真的没有比POD更好的记录Perl代码的方法了吗? [英] Is there really no better way to document perl code than POD?

问题描述

我很长时间以来都是Perl程序员，但是我在POD中的文档方面总是遇到问题.

I'm a Perl programmer for a long time, but I always have problems with documentation in POD.

当我在代码中使用POD注释时，该代码很难阅读.在文件末尾使用POD注释时，存在文档与代码不同步的危险.

When I use POD comments in the code, the code is difficult to read. When I use POD comments at the end of file, there is the danger that the documentation is not in sync with the code.

我想念一种类似于Java的文档样式.

I miss a documentation style similar to Java.

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

我正在寻找一种更简单，更直观的文档样式.有这样的事吗?

I look for an easier and more intuitive documentation style. Is there such a thing?

推荐答案

找到了快速搜索 Doxygen过滤器旨在允许您使用 Doxygen 样式注释(与Javadoc非常相似)来记录Perl代码.

A quick search found Doxygen Filter which purports to allow you to use Doxygen style comments (which are very close to Javadoc) to document Perl code.

这篇关于真的没有比POD更好的记录Perl代码的方法了吗?的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！