2008-10-10 16 views
8

Soy un estudiante universitario en una escuela que enseña principalmente en Java. Uno de los puntos fuertes de Java, que disfruto bastante, es la gran colección de bibliotecas. Lo que hace que estas bibliotecas sean especialmente útiles es la extensa documentación y organización presentada a través de JavaDoc. ¿Hay colecciones de bibliotecas para Common Lisp que también tienen estas cualidades, y existe una herramienta similar a la que JavaDoc que contribuiría a la construcción, mantenimiento, o la ampliación de estas bibliotecas?¿Existen colecciones documentadas y organizadas de bibliotecas para Common Lisp?

+0

Nota: He consultado Github, Sourceforge y CLiki, y ninguno de estos tiene lo que estoy buscando. En lugar de una variedad aleatoria de bibliotecas sin documentación ni estándares de organización, estoy buscando algo parecido a una biblioteca de bibliotecas. –

+1

Esto probablemente no esté relacionado con el tema, ya que está solicitando un recurso externo, pero en la actualidad mucha gente está utilizando [Quicklisp] (http://www.quicklisp.org/). –

Respuesta

4

No, no hay ninguna colección completa biblioteca, documentado consistentemente. La inexistencia de tal cosa es el mayor problema de Common Lisp en este momento. Si estás interesado en ayudar a la comunidad Lisp, puede que sea lo primero que atacar.

Además, si bien hay various JavaDoc equivalents, no existe un cuasi-estándar ampliamente aceptado como para Java.

+0

Downvoters: Agradecería si pudieras comentar brevemente sobre lo que encontraste inútil sobre mi respuesta, para que pueda hacerlo mejor la próxima vez. Gracias. –

2

cliki try o common-lisp.net.

En cuanto a javadoc ... ¿sabes de docstrings? Si no, averígualo. También averigüe sobre todas las otras características de auto-documentación.

Parece que usted no ha leído la especificación. Siempre lea las especificaciones, lo que sea que esté haciendo.

+0

Comencé a leer las especificaciones relacionadas con la publicación de un comentario aquí, pero después de haber pasado por HTTP y TCP/IP, olvidé por completo lo que iba a decir. ;) –

+0

Deberías haber usado una macro para hacerlo. – Marcin

1

Tinna es un sistema de documentación Lisp que es comparable a JavaDoc.

1

Hay muchas librerías disponibles para Common Lisp y muchos de ellos están documentados a fondo. JavaDoc, en mi propia experiencia (o cualquier otra herramienta como Doxygen para C++), no es una herramienta valiosa para documentar una biblioteca pero más para documentar su implementación.

Así que la documentación no es una cuestión de herramientas aquí, sino de voluntad del autor de la lib para escribir un manual decente. En esta área, Common Lisp es como cualquier otro idioma: hay hermosas piezas de ingeniería con documentación maravillosa, código rápido y sucio sin la menor señal de documentación, así como todas las combinaciones posibles de códigos y cualidades de documentación ...

En general, personalmente encontré que las bibliotecas Common Lisp tienen una calidad general bastante alta.

2

Recomiendo clbuild, que contiene una colección de bibliotecas de calidad compiladas por un grupo de experimentados y exigentes programadores de lisp (así como un script para descargar e instalar esas bibliotecas).

Si desea instrucciones para escribir documentación de alto nivel/api, le sugiero que siga los ejemplos establecidos por Edi Weitz y otros (por ejemplo, consulte Hunchentoot, Vecto).

Para la documentación de implementación de nivel inferior, creo que el mecanismo de docstring integrado junto con las instalaciones de navegación de origen y autodoc de Slime constituyen el mejor entorno existente para la exploración de código.

0

Si está acostumbrado a Java, puede dar una oportunidad al Clojure y seguir usando las bibliotecas de Java que conoce.

3

¡Ahora hay quicklisp e hizo todo mucho más fácil! http://www.quicklisp.org/

+0

También me gustaría señalar quickdocs.org, que organiza la documentación para todas las bibliotecas en quicklisp. – djeis