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

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

Ответы [ 9 ]

6 голосов
/ 11 октября 2008

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

4 голосов
/ 11 октября 2008

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

Кроме того, хотя существует различных эквивалентов JavaDoc , широко распространенного квазистандарта, как для Java, не существует.

3 голосов
/ 05 июля 2011

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

2 голосов
/ 22 октября 2008

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

Если вам нужны рекомендации по написанию документации высокого уровня / API, я советую вам следовать примерам, установленным Эди Вейцем и другими (например, см. Hunchentoot , Vecto ).

Что касается документации по реализации более низкого уровня, я думаю, что встроенный механизм документирования вместе с исходной навигационной системой Slime и средствами автоматического документирования составляют лучшую из существующих сред для исследования кода.

2 голосов
/ 10 октября 2008

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

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

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

2 голосов
/ 10 октября 2008

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

1 голос
/ 17 октября 2008

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

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

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

1 голос
/ 10 октября 2008

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

0 голосов
/ 27 октября 2008

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

...