Common Lisp是否有文档化的,有组织的库集合?

时间:2008-10-10 18:42:21

标签: lisp common-lisp documentation-generation

我是一所主要以Java教学的学校的大学生。我非常喜欢Java的一个优点,就是大量的库。这些库特别有用的是通过JavaDoc提供的大量文档和组织。 Common Lisp是否有任何具有这些特性的库集合,是否有类似于JavaDoc的工具可以帮助构建,维护或扩展这些库?

9 个答案:

答案 0 :(得分:6)

是的http://www.cl-user.net有广泛的,有文件记录的图书馆馆藏, http://www.cliki.nethttp://clocc.sourceforge.net。以及先进的'asdf'或'mk-defsystem'基础基础设施,以便使用它们。

答案 1 :(得分:4)

不,没有全面的,一致记录的库集合。这种事情的存在是Common Lisp现在最大的问题。如果您有兴趣帮助Lisp社区,那么最好先攻击它。

此外,虽然有various JavaDoc equivalents,但Java并没有广泛接受的准标准。

答案 2 :(得分:3)

现在有了quicklisp,它让一切变得如此简单! http://www.quicklisp.org/

答案 3 :(得分:2)

Github包含许多lisp项目,更不用说Sourceforge

答案 4 :(得分:2)

尝试使用cliki或common-lisp.net。

至于javadoc ......你知道docstrings吗?如果没有,请找出答案。还要了解所有其他自我记录功能。

听起来你没有阅读规范。无论你在做什么,都要阅读规范。

答案 5 :(得分:2)

我推荐clbuild,其中包含一组由经验丰富,有识别力的lisp程序员编写的高质量库(以及下载和安装这些库的脚本)。

如果您需要编写高级/ api文档的指南,我建议您按照Edi Weitz和其他人设置的示例进行操作(例如,请参阅HunchentootVecto)。

对于较低级别的实现文档,我认为内置的docstring机制与Slime的源代码导航和autodoc工具一起构成了代码探索的最佳现有环境。

答案 6 :(得分:1)

Tinna是一个与JavaDoc相当的Lisp文档系统。

答案 7 :(得分:1)

Common Lisp有许多可用的库,其中许多都是完整的文档。根据我自己的经验(或任何像Doxygen for C ++这样的工具),JavaDoc不是一个有价值的工具来记录库,而是更多来记录它的实现。

因此,文档不是这里的工具问题,而是lib的作者写出一本体面的手册的意愿。在这个领域,Common Lisp就像任何其他语言一样:有漂亮的工程设计,精美的文档,快速而脏的代码,没有任何文档标记,以及所有可能的代码和文档质量组合......

总而言之,我个人发现Common Lisp库具有相当高的整体质量。

答案 8 :(得分:0)

如果您习惯使用Java,可以给Clojure一个机会并继续使用您知道的Java库。