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

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

источник

2008-10-10 Zoe Gagnon

Примечание: Я просмотрел Github, Sourceforge и CLiki, и ни один из них не имеет того, что я ищу. Вместо случайного ассортимента библиотек без документации или стандартов организации я ищу что-то похожее на библиотеку библиотек. – 2008-10-10 18:54:34

Это, вероятно, не по теме, так как он запрашивает ресурс вне сайта, но в наши дни многие люди используют [Quicklisp] (http://www.quicklisp.org/). – 2013-09-23 18:46:50

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

Кроме того, хотя есть various JavaDoc equivalents, нет общепринятого квазистандартного стандарта, как для Java.

источник

2008-10-10 20:47:34

Downvoters: Я был бы признателен, если бы вы коротко прокомментировали то, что нашли бесполезным в моем ответе, чтобы я мог сделать лучше в следующий раз. Спасибо. – 2008-10-18 17:40:05

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

источник

2008-10-10 18:50:00 dsm

Try cliki или common-lisp.net.

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

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

источник

2008-10-10 18:52:57 Marcin

Я начал читать спецификации, связанные с размещением комментариев здесь, но после того, как я прошел через HTTP и TCP/IP, я полностью забыл, что я собираюсь сказать. ;) – 2008-10-17 10:19:47

Вы должны были использовать макрос для этого. – Marcin 2008-10-17 13:49:39

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

источник

2008-10-10 19:00:12 sanxiyn

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

источник

2008-10-10 23:39:43 fincomus

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

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

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

источник

2008-10-17 13:15:24

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

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

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

источник

2008-10-22 08:49:26 huaiyuan