是否有用于 Common Lisp 的文档化、有组织的库集合？答案

【问题标题】：Are there documented, organized collections of libraries for Common Lisp?是否有用于 Common Lisp 的文档化、有组织的库集合？
【发布时间】：2008-10-10 18:42:20
【问题描述】：

我是一所主要用 Java 授课的学校的大学生。我非常喜欢 Java 的优势之一，就是大量的库集合。使这些库特别有用的是通过 JavaDoc 提供的大量文档和组织。是否有任何 Common Lisp 库集合也具有这些品质，是否有类似于 JavaDoc 的工具可以帮助构建、维护或扩展这些库？

【问题讨论】：

注意：我浏览过 Github、Sourceforge 和 CLiki，但没有一个是我想要的。我正在寻找类似于图书馆库的东西，而不是没有文档或组织标准的随机库。
这可能是题外话，因为它要求一个场外资源，但现在很多人都在使用Quicklisp。

标签： lisp common-lisp documentation-generation

【解决方案1】：

是的，http://www.cl-user.net 有大量的、记录在案的图书馆馆藏， http://www.cliki.net 和 http://clocc.sourceforge.net。以及使用它们的高级“asdf”或“mk-defsystem”基础架构。

【讨论】：

嘿，虽然我不会称 ASDF 为高级... :)

【解决方案2】：

不，没有全面、一致记录的图书馆收藏。不存在这样的东西是 Common Lisp 目前最大的问题。如果你有兴趣帮助 Lisp 社区，这很可能是首先要攻击的东西。

此外，虽然有 various JavaDoc equivalents，但没有像 Java 那样被广泛接受的准标准。

【讨论】：

Downvoters：如果您能简要评论一下您认为我的回答没有帮助的地方，我将不胜感激，这样我下次可以做得更好。谢谢。

【解决方案3】：

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

【讨论】：

我还想指出 quickdocs.org，它组织了 quicklisp 中所有库的文档。

【解决方案4】：

Github包含很多lisp项目，更何况Sourceforge

【讨论】：

【解决方案5】：

试试 cliki 或 common-lisp.net。

至于 javadoc...你知道 docstrings 吗？如果没有，找出来。还可以了解所有其他自记录功能。

听起来您还没有阅读规范。无论您在做什么，请务必阅读规范。

【讨论】：

我开始阅读与在这里发表评论相关的规范，但是在我通过 HTTP 和 TCP/IP 之后，我完全忘记了我要说什么。 ;)
你应该使用宏来做到这一点。

【解决方案6】：

我推荐clbuild，它包含一组由一群经验丰富、有眼光的 lisp 程序员编译的高质量库（以及下载和安装这些库的脚本）。

如果您需要编写高级/api 文档的指南，我建议您遵循 Edi Weitz 和其他人设置的示例（例如，请参阅 Hunchentoot、Vecto）。

对于较低级别的实现文档，我认为内置的文档字符串机制以及Slime 的源导航和自动文档工具构成了代码探索的最佳现有环境。

【讨论】：

【解决方案7】：

Tinna 是一个可与 JavaDoc 相媲美的 Lisp 文档系统。

【讨论】：

【解决方案8】：

Common Lisp 有许多可用的库，其中许多都有完整的文档记录。 JavaDoc，以我自己的经验（或任何此类工具，如用于 C++ 的 Doxygen），不是记录库的有价值的工具，而是记录其实现的更多工具。

因此，这里的文档不是工具问题，而是 lib 作者编写体面手册的意愿。在这方面，Common Lisp 就像任何其他语言一样：有漂亮的工程和精彩的文档，快速而肮脏的代码，没有丝毫的文档迹象，以及代码和文档质量的所有可能组合......

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

【讨论】：

【解决方案9】：

如果你习惯了Java，你可以给Clojure一个机会，继续使用你知道的Java库。

【讨论】：