Pergunta

Eu sou um estudante universitário em uma escola que ensina principalmente em Java. Um dos pontos fortes do Java, que gosto muito, é a grande coleção de bibliotecas. O que torna essas bibliotecas especialmente útil é a extensa documentação e organização apresentadas via JavaDoc. Existem quaisquer coleções de bibliotecas para Common Lisp que também tem essas qualidades, e há uma ferramenta similar para JavaDoc, que poderiam ajudar na construção, manutenção ou expansão dessas bibliotecas?

Foi útil?

Solução

Não, não há nenhuma abrangente consistentemente documentado coleção, biblioteca. A inexistência de tal coisa uma é o maior problema de Common Lisp agora. Se você estiver interessado em ajudar a comunidade Lisp, este pode muito bem ser a coisa para atacar primeiro.

Além disso, enquanto há vários equivalentes JavaDoc , não há amplamente aceito quasi-padrão como para Java.

Outras dicas

Sim, existem extensas coleções de bibliotecas documentadas em http://www.cl-user.net , http://www.cliki.net e http://clocc.sourceforge.net . Bem como 'asdf' avançado ou infra-estruturas de base 'mk-defsystem' para usá-los.

Agora há quicklisp e fez tudo muito mais fácil! http://www.quicklisp.org/

Github contém uma grande quantidade de projetos Lisp, para não mencionar Sourceforge

Tente cliki ou common-lisp.net.

Quanto ao javadoc ... você sabe sobre docstrings? Se não, descubra. Também descobrir sobre todas as outras características de auto-documentação.

Parece que você ainda não leu o spec. Sempre leia a especificação, o que você está fazendo.

Eu recomendo clbuild , que contém uma coleção de bibliotecas de qualidade compilado por um grupo de experientes , discernindo os programadores Lisp (bem como script para baixar e instalar essas bibliotecas).

Se você quiser diretrizes para escrever documentação de alto nível / api, eu sugiro que você siga os exemplos dados por Edi Weitz e outros (por exemplo, ver Hunchentoot , Vecto ).

Para mais baixa documentação de implementação nível, acho que o mecanismo interno de DocString juntamente com Slime facilidades de navegação fonte e AutoDoc 's compreendem o melhor ambiente existente para a exploração de código.

Tinna é um sistema de documentação Lisp que é comparável à JavaDoc.

Existem muitas bibliotecas disponíveis para Common Lisp e muitos deles são completamente documentado. JavaDoc, na minha própria experiência (ou qualquer ferramenta como o Doxygen para C ++), não é uma valiosa ferramenta para documentar uma biblioteca, mas mais para documentar a sua implementação.

documentação Então não é uma questão de ferramentas aqui, mas da vontade do autor do lib para escrever um manual decente. Nesta área, Common Lisp é como qualquer outra língua: há belas peças de engenharia com documentação maravilhoso, rápido e código sujo, sem o menor sinal de documentação, bem como todas as combinações possíveis de qualidades de código e documentação ...

Ao todo, I personnally descobriram que as bibliotecas Lisp Comum tem uma muito alta qualidade global.

Se você está acostumado a Java, você pode dar- Clojure uma chance e continuar usando as bibliotecas Java que você conhece.

Licenciado em: CC-BY-SA com atribuição
Não afiliado a StackOverflow
scroll top