Там документируются, организованные наборы библиотек для языка Common LISP?
Хорошо, понял проблему. Я использовал этот макрос на моей операционной системе Windows в Excel. Затем я получил доступ к тому же файлу, используя мой linux os (ubuntu) в dropbox, через libre office calc csv версию, кое-как, получив доступ к нему через libre, он автоматически внес некоторые изменения, и я сохранил его. Поэтому урок заключается в том, что libre может изменять изменения из файла excel / csv.
8 ответов
Нет, нет никакого всестороннего, последовательно документировавшего набора библиотеки. Неотъемлемость такой вещи является самой большой проблемой языка Common LISP прямо сейчас. Если Вы интересуетесь помощью сообществу Lisp, это может быть вещью напасть сначала.
Кроме того, в то время как существуют различные эквиваленты JavaDoc, нет никакого широко принятого квазистандарта что касается Java.
Попробуйте cliki или common-lisp.net.
Относительно javadoc... Вы знаете о docstrings? В противном случае узнайте. Также узнайте обо всех других функциях самодокументирования.
Это кажется, что Вы не считали спецификацию. Всегда читайте спецификацию, независимо от того, что Вы делаете.
Да существуют обширные, зарегистрированные наборы библиотеки по http://www.cl-user.net, http://www.cliki.net и http://clocc.sourceforge.net. А также усовершенствованный 'asdf' или 'знак-defsystem' основывают инфраструктуры для использования их.
GitHub содержит много проектов шепелявости, не говоря уже о SourceForge
Tinna является системой документации Lisp, которая сопоставима с JavaDoc.
Я рекомендую clbuild, который содержит набор качественных библиотек, скомпилированных группой опытных, проницательных программистов шепелявости (а также сценарий, чтобы загрузить и установить те библиотеки).
Если Вы хотите инструкции для записи высокого уровня/документации API, я предлагаю, чтобы Вы последовали примерам, установленным Edi Weitz и другими (например, посмотрите Hunchentoot, Vecto).
Для более низкой документации реализации уровня я думаю, встроенный docstring механизм вместе с исходной навигацией Слизи и средства автодокумента включают лучшую существующую среду для исследования кода.
Если Вы привыкли к Java, можно дать Clojure шанс и продолжать пользоваться библиотеками Java, которые Вы знаете.
Существуют многие доступные библиотеки для языка Common LISP, и многие из них полностью документируются. JavaDoc, в моем собственном опыте (или любой такой инструмент как Doxygen для C++), не является ценным инструментом, чтобы зарегистрировать библиотеку, но больше зарегистрировать ее реализацию.
Таким образом, документация не является вопросом инструментов здесь, но желания автора lib записать достойное руководство. В этой области язык Common LISP похож на любой другой язык: существуют красивые части разработки с замечательной документацией, быстрым и грязным кодом без малейшего знака документации, а также всех возможных комбинаций качеств кода и документации...
В целом, я лично нашел, что библиотеки языка Common LISP имеют довольно высокое общее качество.