common-lisp
ANSI Common Lisp, språkstandarden och dess dokumentation

Vanlig Lisp HyperSpec

Common Lisp har en standard som ursprungligen publicerades 1994 som en ANSI-standard.

Common Lisp HyperSpec , kort CLHS, som tillhandahålls av LispWorks är en ofta använda HTML-dokumentation, som härrör från standarddokumentet. HyperSpec kan också laddas ner och användas lokalt .

Vanliga Lisp-utvecklingsmiljöer tillåter vanligtvis uppslagning av HyperSpec-dokumentationen för Lisp-symboler.

• För GNU Emacs finns det clhs.el.
• SLIME för GNU Emacs tillhandahåller en version av hyperspec.el .

Se också: cliki på CLHS

EBNF syntaxdeklarationer i dokumentation

ANSI CL-standarden använder en utökad EBNF-syntaxnotation. Dokumentationen som dupliceras på Stackoverflow bör använda samma syntaxnotation för att minska förvirring.

Exempel:

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] )}*] ) 

Notation:

• [foo] -> noll eller en foo
• {foo}* -> noll eller mer foo
• foo | bar -> foo eller bar

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

Den här boken kallas CLtL2.

Detta är den andra upplagan av boken Common Lisp the Language. Den publicerades 1990, innan ANSI CL-standarden var slutlig. Det tog den ursprungliga språkdefinitionen från den första utgåvan (publicerades 1984) och beskrev alla förändringar i standardiseringsprocessen fram till 1990 plus vissa tillägg (som serier-iterationsanläggningen).

Obs: CLTL2 beskriver en version av Common Lisp som skiljer sig något från den publicerade standarden från 1994. Använd därför alltid standarden och inte CLtL2 som referens.

CLtL2 kan fortfarande vara användbart eftersom det ger information som inte finns i Common Lisp-specifikationsdokumentet.

Det finns en HTML-version av Common Lisp the Language, 2nd Edition .

CLiki - Föreslagna ANSI-revisioner och förtydliganden

På CLiki, en Wiki för Common Lisp och gratis Common Lisp-programvara, upprätthålls en lista över föreslagna ANSI-revisioner och förtydliganden .

Eftersom Common Lisp-standarden inte har ändrats sedan 1994 har användarna hittat flera problem med specifikationsdokumentet. Dessa dokumenteras på CLiki-sidan.

Vanlig Lisp snabbreferens

Common Lisp-snabbreferensen är ett dokument som kan skrivas ut och bindas som en broschyr i olika layouter för att ha en tryckt snabbreferens för Common Lisp.

ANSI Common Lisp-standarden i Texinfo-format (särskilt användbar för GNU Emacs)

GNU Emacs använder ett speciellt format för dokumentation: info .

Common Lisp-standarden har konverterats till Texinfo-formatet, som kan användas för att skapa dokumentation som kan bläddras med informationsläsaren i GNU Emacs.

Se här: dpans2texi.el konverterar TeX-källorna till utkastet till ANSI Common Lisp-standard (dpANS) till Texinfo-format.

En annan version har gjorts för för GCL: gcl.info.tgz .