问题描述
我很长时间以来都是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代码的方法了吗?的文章就介绍到这了,希望我们推荐的答案对大家有所帮助,也希望大家多多支持!