Существуют ли документированные, организованные коллекции библиотек для Common Lisp?

Я студент колледжа в школе, которая преподает в основном на Java. Одной из сильных сторон Java, которая мне очень нравится, является большая коллекция библиотек. Что делает эти библиотеки особенно полезными, так это обширная документация и организация, представленная через JavaDoc. Существуют ли какие-либо библиотечные коллекции для Common Lisp, которые также имеют эти качества, и есть ли инструмент, подобный JavaDoc, который помог бы в создании, обслуживании или расширении этих библиотек?

8
common-lisp documentation-generation lisp

9 ответов

нет, нет всеобъемлющей, последовательно документированной коллекции библиотек. Отсутствие такой вещи-самая большая проблема Common Lisp прямо сейчас. Если вы заинтересованы в том, чтобы помочь сообществу Lisp, это вполне может быть первой атакой.

также, пока есть различные эквиваленты JavaDoc, нет широко принятого квази-стандарта, как для Java.

4

Да есть обширная, документально библиотечных фондов в http://www.cl-user.net, http://www.cliki.net и http://clocc.sourceforge.net. А также расширенные базовые инфраструктуры "asdf" или "MK-defsystem" для их использования.

6

теперь есть quicklisp, и это сделало все намного проще! http://www.quicklisp.org/

3

Github содержит много проектов lisp, не говоря уже о Sourceforge

2

попробуйте cliki или common-lisp.net.

Что касается javadoc...вы знаете о комментарии? Если нет, выясните. Также узнайте обо всех других функциях самостоятельного документирования.

похоже, вы не читали спецификации. Всегда читайте спецификацию, что бы вы ни делали.

2

рекомендую clbuild, который содержит коллекцию качественных библиотек, составленных группой опытных, проницательных программистов lisp (а также скрипт для загрузки и установки этих библиотек).

Если вам нужны рекомендации по написанию документации highlevel / api, я предлагаю вам следовать примерам, установленным Edi Weitz и другими (например, см. Hunchentoot, Vecto).

для документации по реализации нижнего уровня I подумайте о встроенном механизме docstring вместе с мутьисходная навигация и средства autodoc составляют лучшую существующую среду для исследования кода.

2

Tinna - это система документации Lisp, которая сопоставима с JavaDoc.

1

есть много доступных библиотек для Common Lisp и многие из них тщательно документированы. JavaDoc, по моему собственному опыту (или любой такой инструмент, как Doxygen для C++), не является ценным инструментом для документирования библиотеки, но больше для документирования ее реализации.

таким образом, документация здесь не вопрос инструментов, а воли автора lib написать достойное руководство. В этой области Common Lisp похож на любой другой язык: есть красивые части техники с замечательными документация, быстрый и грязный код без малейших признаков документации, а также все возможные комбинации качества кода и документации...

в целом, я лично обнаружил, что общие библиотеки Lisp имеют довольно высокое общее качество.

1

Если вы привыкли к Java, вы можете дать Clojure шанс и продолжать использовать библиотеки Java, которые вы знаете.

0