对于如何显示代码正在做什么(C或MATLAB),有什么建议吗?想象一下,如果你的代码真的很长,并且你的程序中有很多函数,那么记录程序的最好方法是什么?我知道Java IDE有一种方法来接收注释,并将它们输出到一个文档中,该文档显示了所有函数及其输入和输出。我不认为C或MATLAB有这个特性。在这一点上,我认为注释是显示代码中发生的事情的唯一方法,但如果读者必须在查看注释的同时查看原始代码,那么注释可能会让读者感到困惑。第二种选择是在文本编辑器(如Microsoft Word )中编写算法。有没有这样做的行业标准?
谢谢!
发布于 2011-11-17 07:49:39
Java使用的是JavaDoc。
对于C语言,你可以使用Doxygen。
我还看到了this,它建议你也可以在matlab中使用Doxygen!
发布于 2011-11-17 07:56:06
所有识字编程之母是http://www-cs-faculty.stanford.edu/~uno/cweb.html cweb。孩子的父亲是Knuth。
发布于 2011-11-17 17:23:50
最近的MATLAB版本确实有一些与此非常相似的功能。如果您在面向对象的类中实现MATLAB代码,MATLAB将只需输入doc myClassName即可为您auto-generate documentation -它真的非常类似于Doxygen。如果您没有使用面向对象的代码,您可以使用MATLAB publishing从您的脚本和函数生成文档。
https://stackoverflow.com/questions/8160367
复制相似问题