真的没有比POD更好的记录Perl代码的方法了吗

真的没有比POD更好的记录Perl代码的方法了吗

本文介绍了真的没有比POD更好的记录Perl代码的方法了吗?的处理方法,对大家解决问题具有一定的参考价值,需要的朋友们下面随着小编来一起学习吧!

问题描述

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

07-28 03:19