记录perl代码真的没有比POD更好的方法吗?
我很长一段时间都是Perl程序员,但我在POD中的文档总是有问题。
当我在代码中使用POD注释时,代码很难阅读。当我在文件末尾使用POD注释时,存在文档与代码不同步的危险。
我想念一个类似于Java的文档样式。
/**
* @description
* ...
*/
我寻找更简单,更直观的文档样式。有这样的事吗?
没有找到相关结果
已邀请:
6 个回复
壤欠攻混
搁手
呈辖玫割善
辩谷变充
与等效的Perl相比。
筷啸够对铅
它使用直接可用于程序的数据结构,而不是在“注释”中使用Java或Perl 5样式的文档。 (注意Perl 6也是这样的。)把它想象成Python文档字符串变得疯狂(或结构化)。 有一些工具可以从元数据(规范)生成POD,文本,HTML。除了文档之外,元数据还可用于其他参数,如参数验证,命令行界面等。 披露:我是开发人员。
漂截嘘
然后,大多数语言都需要双重输入才能记录。