common-lisp
ANSI Common Lisp, standard językowy i jego dokumentacja

Często Lisp HyperSpec

Common Lisp ma standard, który został pierwotnie opublikowany w 1994 roku jako standard ANSI.

Common Lisp HyperSpec , krótki CLHS, dostarczany przez LispWorks jest często używaną dokumentacją HTML, która pochodzi ze standardowego dokumentu. HyperSpec można również pobrać i używać lokalnie .

Wspólne środowiska programistyczne Lisp zwykle umożliwiają wyszukiwanie w dokumentacji HyperSpec symboli Lisp.

• Dla GNU Emacs istnieje clhs.el.
• SLIME dla GNU Emacs zapewnia wersję pliku hyperspec.el .

Zobacz także: cliki na CLHS

Deklaracje składniowe EBNF w dokumentacji

Standard ANSI CL używa rozszerzonej notacji składni EBNF. Dokumentacja powielona na Stackoverflow powinna używać tej samej notacji składniowej, aby zmniejszyć zamieszanie.

Przykład:

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

Notacja:

• [foo] -> zero lub jeden foo
• {foo}* -> zero lub więcej foo
• foo | bar -> foo lub bar

Common Lisp the Language, wydanie drugie, autor: Guy L. Steele Jr.

Ta książka jest znana jako CLtL2.

To drugie wydanie książki Common Lisp the Language. Został opublikowany w 1990 roku, zanim standard ANSI CL był ostateczny. Wziął oryginalną definicję języka z pierwszego wydania (opublikowaną w 1984 r.) I opisał wszystkie zmiany w procesie standaryzacji do 1990 r. Plus niektóre rozszerzenia (takie jak narzędzie do iteracji SERIES).

Uwaga: CLTL2 opisuje wersję Common Lisp, która nieco różni się od opublikowanego standardu z 1994 roku. Dlatego zawsze używaj standardu, a nie CLtL2, jako odniesienia.

CLtL2 nadal może być przydatny, ponieważ zapewnia informacje, których nie znaleziono w dokumencie specyfikacji Common Lisp.

Istnieje wersja HTML Common Lisp the Language, 2. edycja .

CLiki - proponowane zmiany i wyjaśnienia ANSI

Na CLiki, Wiki dla Common Lisp i darmowego oprogramowania Common Lisp, utrzymywana jest lista proponowanych poprawek i wyjaśnień ANSI .

Ponieważ standard Common Lisp nie zmienił się od 1994 r., Użytkownicy znaleźli kilka problemów z dokumentacją specyfikacji. Są one udokumentowane na stronie CLiki.

Często zadawane pytania dotyczące Lisp

Common Lisp Quick Reference to dokument, który można wydrukować i oprawić jako broszurę w różnych układach w celu wydrukowania szybkiego odniesienia do Common Lisp.

Standard ANSI Common Lisp w formacie Texinfo (szczególnie przydatny dla GNU Emacs)

GNU Emacs używa specjalnego formatu dokumentacji: informacji .

Standard Common Lisp został przekonwertowany do formatu Texinfo, którego można użyć do tworzenia dokumentacji możliwej do przeglądania za pomocą czytnika informacji w GNU Emacs.

Zobacz tutaj: dpans2texi.el konwertuje źródła TeX projektu standardu ANSI Common Lisp (dpANS) do formatu Texinfo.

Dla GCL została przygotowana inna wersja: gcl.info.tgz .