문제

저는 주로 Java에서 가르치는 학교에서 대학생입니다. 내가 좋아하는 Java의 강력한 포인트 중 하나는 도서관의 큰 모음입니다. 이러한 라이브러리를 특히 유용하게 만드는 것은 Javadoc을 통해 제공되는 광범위한 문서와 조직입니다. 이러한 특성을 가진 Common LISP 용 라이브러리 컬렉션이 있습니까?이 라이브러리의 건물, 유지 관리 또는 확장을 돕는 Javadoc과 유사한 도구가 있습니까?

도움이 되었습니까?

해결책

아니요, 포괄적이고 일관되게 문서화 된 라이브러리 컬렉션은 없습니다. 그러한 일의 의미는 현재 일반적인 LISP의 가장 큰 문제입니다. LISP 커뮤니티를 돕는 데 관심이 있다면 이것이 먼저 공격해야 할 것입니다.

또한,있는 동안 다양한 Javadoc 등가, Java와 같이 널리 받아 들여지는 준 표준은 없습니다.

다른 팁

예, 광범위하고 문서화 된 도서관 컬렉션이 있습니다 http://www.cl-user.net, http://www.cliki.net 그리고 http://clocc.sourceforge.net. 뿐만 아니라 고급 'ASDF'또는 'MK-DEFSYSTEM'기본 인프라를 사용합니다.

이제 QuickLisp가 있고 모든 것이 훨씬 쉬워졌습니다!http://www.quicklisp.org/

github 말할 것도없이 많은 LISP 프로젝트가 포함되어 있습니다. Sourceforge

cliki 또는 common-lisp.net을 사용해보십시오.

Javadoc에 대해 ... Docstrings에 대해 알고 있습니까? 그렇지 않다면 알아보십시오. 또한 다른 모든 자체 문서화 기능에 대해서도 알아보십시오.

사양을 읽지 않은 것 같습니다. 당신이하는 일이 무엇이든 항상 사양을 읽으십시오.

추천합니다 clbuild, 여기에는 숙련 된 분별력있는 LISP 프로그래머 그룹 (및 해당 라이브러리를 다운로드 및 설치하기위한 스크립트)이 편집 한 품질 라이브러리 모음이 포함되어 있습니다.

High Level/API 문서 작성에 대한 지침을 원한다면 Edi Weitz 및 다른 사람들이 설정 한 예제를 따르는 것이 좋습니다 (예 : 참조, Hunchentoot, 벡토).

하위 레벨 구현 문서의 경우 내장 DOCSTRING 메커니즘을 다음과 함께 생각합니다. 더러운 것소스 내비게이션 및 AutoDoc 시설은 코드 탐색을위한 최고의 기존 환경으로 구성됩니다.

Tinna Javadoc과 비교할 수있는 LISP 문서 시스템입니다.

일반적인 LISP를위한 많은 라이브러리가 있으며 그 중 많은 사람들이 철저히 문서화되어 있습니다. Javadoc은 저의 경험 (또는 C ++ 용 Doxygen과 같은 도구)에서 라이브러리를 문서화하는 데 유용한 도구가 아니라 구현을 문서화하는 데 더 많은 도구입니다.

따라서 문서화는 여기에서 도구의 문제가 아니라 Lib의 저자의 의지가 괜찮은 매뉴얼을 작성할 것입니다. 이 분야에서 Common LISP는 다른 언어와 같습니다. 멋진 문서화, 문서의 작은 징후가없는 빠르고 더러운 코드와 코드 및 문서화 품질의 조합이있는 아름다운 엔지니어링이 있습니다.

대체로, 나는 일반적인 LISP 라이브러리가 전반적인 품질이 상당히 높다는 것을 개인적으로 발견했습니다.

자바에 익숙하다면 Clojure 당신이 아는 Java 라이브러리를 계속 사용하고 있습니다.

라이센스 : CC-BY-SA ~와 함께 속성
제휴하지 않습니다 StackOverflow
scroll top