common-lisp
ANSI Common Lisp, de taalstandaard en de bijbehorende documentatie

Gemeenschappelijke Lisp HyperSpec

Common Lisp heeft een standaard, die oorspronkelijk in 1994 werd gepubliceerd als een ANSI-standaard.

De Common Lisp HyperSpec , korte CLHS, geleverd door LispWorks is een vaak gebruikte HTML-documentatie, die is afgeleid van het standaarddocument. De HyperSpec kan ook worden gedownload en lokaal worden gebruikt .

In veel voorkomende Lisp-ontwikkelomgevingen is het meestal mogelijk om de HyperSpec-documentatie op te zoeken voor Lisp-symbolen.

• Voor GNU Emacs is er clhs.el.
• SLIME voor GNU Emacs biedt een versie van hyperspec.el .

Zie ook: cliki op CLHS

EBNF syntaxisverklaringen in documentatie

De ANSI CL-standaard gebruikt een uitgebreide EBNF-syntaxisnotatie. De documentatie die wordt gedupliceerd op Stackoverflow moet dezelfde syntaxisnotatie gebruiken om verwarring te verminderen.

Voorbeeld:

specialized-lambda-list::=
     ({var | (var parameter-specializer-name)}* 
      [&optional {var | (var [initform [supplied-p-parameter] ])}*] 
      [&rest var] 
      [&key{var | ({var | (keywordvar)} [initform [supplied-p-parameter] ])}*
           [&allow-other-keys] ] 
      [&aux {var | (var [initform] )}*] ) 

notatie:

• [foo] -> nul of één foo
• {foo}* -> nul of meer foo
• foo | bar -> foo of bar

Common Lisp the Language, 2nd Edition, door Guy L. Steele Jr.

Dit boek staat bekend als CLtL2.

Dit is de tweede editie van het boek Common Lisp the Language. Het werd gepubliceerd in 1990, voordat de ANSI CL-standaard definitief was. Het nam de oorspronkelijke taaldefinitie van de eerste editie (gepubliceerd in 1984) en beschreef alle wijzigingen in het standaardisatieproces tot 1990 plus enkele uitbreidingen (zoals de iteratiefaciliteit SERIES).

Opmerking: CLTL2 beschrijft een versie van Common Lisp die enigszins verschilt van de gepubliceerde standaard uit 1994. Gebruik dus altijd de standaard en niet CLtL2 als referentie.

CLtL2 kan nog steeds nuttig zijn, omdat het informatie biedt die niet voorkomt in het Common Lisp-specificatiedocument.

Er is een HTML-versie van Common Lisp the Language, 2e editie .

CLiki - Voorgestelde ANSI-revisies en verduidelijkingen

Op CLiki, een Wiki voor Common Lisp en gratis Common Lisp-software, wordt een lijst met voorgestelde ANSI-revisies en verduidelijkingen bijgehouden.

Aangezien de Common Lisp-standaard sinds 1994 niet is gewijzigd, hebben gebruikers verschillende problemen met het specificatiedocument ontdekt. Deze zijn gedocumenteerd op de CLiki-pagina.

Gemeenschappelijke Lisp Quick Reference

De Common Lisp Quick Reference is een document dat kan worden afgedrukt en gebonden als een boekje in verschillende lay-outs om een gedrukte quick reference voor Common Lisp te hebben.

De ANSI Common Lisp-standaard in Texinfo-formaat (vooral handig voor GNU Emacs)

GNU Emacs gebruikt een speciaal formaat voor documentatie: info .

De Common Lisp-standaard is geconverteerd naar het Texinfo-formaat, dat kan worden gebruikt om documentatie te maken die door de info- lezer kan worden doorzocht in GNU Emacs.

Zie hier: dpans2texi.el converteert de TeX-bronnen van de concept ANSI Common Lisp-standaard (dpANS) naar het Texinfo-formaat.

Een andere versie is gedaan voor GCL: gcl.info.tgz .