              <!-- -*- sgml -*- -->
  <!ENTITY % cl-entities SYSTEM "cl-ent.xml">
  %cl-entities;
  <!ENTITY % imp-entities SYSTEM "impent.xml">
  %imp-entities;
  <!ENTITY imp-body SYSTEM "impbody.xml">
  <!ENTITY imp-issues SYSTEM "impissue.xml">
  <!ENTITY imp-ext SYSTEM "impext.xml">
  <!ENTITY imp-byte SYSTEM "impbyte.xml">
  <!ENTITY regexp SYSTEM "../modules/regexp/regexp.xml">
  <!-- ENTITY gfdl-text SYSTEM "http://www.gnu.org/licenses/fdl.sgml" -->
  <!ENTITY gfdl-text SYSTEM "/usr/share/sgml/gnu/fdl.sgml">
]>

<!-- *** Conventions: ***
 * function (car)      == function
 * variable (t)        == varname
 * formal arg (x)      == replaceable
 * keyword (:eof)      == constant
 * number (1.0)        == literal
 * char (#\a)          == keysym
 * class/type (t)      == classname (?type?)
 * format (~S)         == literal
 * lambda-key (&amp;)  == literal
 * declaration (ftype) == literal
 * package (CL-USER)   == quote
 -->

<book id="impnotes-top"><title>Implementation Notes for &gnu; &clisp;.</title>

<bookinfo>
 <legalnotice><para>These notes are covered by the &gnu; &gfdl;:</para>

 <para>Permission is granted to copy, distribute and/or modify this
  document under the terms of the GNU Free Documentation License
  (&gfdl;), Version 1.1 or any later version published by the &fsf;;
  with no Invariant Sections,
  with Front-Cover Text being this section, and
  with no Back-Cover Texts.
  A copy of the license is included in the section entitled
  <link linkend="gfdl">"GNU Free Documentation License."</link></para>

 </legalnotice>
 <authorgroup>
  <author>
   <authorblurb><para>Bugs in both these notes and &clisp; itself should
    be sent to <email>clisp-list@lists.sourceforge.net</email>
   </para></authorblurb>
  </author>
  <author><honorific>Dr</honorific> <firstname>Bruno</firstname>
   <surname>Haible</surname></author>
  <author><honorific>Dr</honorific> <firstname>Sam</firstname>
   <surname>Steingold</surname></author>
 </authorgroup>
 <keywordset>
  <keyword>Lisp</keyword>
  <keyword>Common Lisp</keyword>
  <keyword>CLISP</keyword>
 </keywordset>
</bookinfo>

<preface id="preface"><title><inlinemediaobject>
 <imageobject>
  <imagedata fileref="clisp.png" width="48" depth="48"/>
 </imageobject>
 <textobject><phrase>[CLISP icon]</phrase></textobject>
</inlinemediaobject></title>

<subtitle>Last modified: 2002-02-13</subtitle>

<para>These notes discuss the &clisp; implementation of &cl; by
<blockquote><address><honorific>Dr</honorific> <firstname>Bruno</firstname> <surname>Haible</surname>
 <street>Louisenstra&szlig;e 103</street>
 <city>Bad Homburg</city>
 <postcode>D-61348</postcode> <country>Germany</country>
 <otheraddr><ulink url="http://clisp.cons.org/~haible">http://clisp.cons.org/~haible</ulink></otheraddr>
</address></blockquote>
 and
<blockquote><address><honorific>Dr</honorific> <firstname>Michael</firstname> <surname>Stoll</surname>
 <street>Westerwaldweg 22</street>
 <city>Remagen-Oberwinter</city>
 <postcode>D-53424</postcode> <country>Germany</country>
 <otheraddr><ulink url="http://www.math.uni-duesseldorf.de/home/stoll">http://www.math.uni-duesseldorf.de/home/stoll</ulink></otheraddr>
</address></blockquote>
 The current maintainers are
 <blockquote><address><honorific>Dr</honorific> <firstname>Bruno</firstname> <surname>Haible</surname></address></blockquote>
 and
 <blockquote><address><honorific>Dr</honorific> <firstname>Sam</firstname> <surname>Steingold</surname>
 <email>sds@clisp.cons.org</email>
 <otheraddr><ulink url="http://clisp.cons.org/~sds">http://clisp.cons.org/~sds</ulink></otheraddr></address></blockquote>
</para>

<para>This implementation is mostly conforming to the &ansi-cl;
 available on-line as the &hyperspec; (but the printed ANSI document
 remains the authoritative source of information).  &ansi-cl; supersedes
 the earlier specifications &cltl1; and &cltl2;.</para>

<para>The first part of these notes is indexed in parallel to the
 &hyperspec; and documents the differences between the &clisp;
 implementation of &cl; and the &ansi-cl;.</para>

<para>The second part documents the &clisp; &gc;ion (for developers
 only) and the bytecodes generated by the compiler (i.e., what is
 printer by &disassemble;).</para>

<para>The third part documents the &clisp; extensions.</para>

</preface>

<toc>
<tocpart><tocentry linkend="clhs-chapters">Chapters of the &hyperspec;
  <ulink url="&clhs;/FrontMatter/Chapter-Index.html">[CLHS]</ulink></tocentry>
 <tocentry linkend="intro">Introduction
   <ulink url="&clhs;/Body/chap-1.html">[CLHS-1]</ulink></tocentry>
 <tocentry linkend="syntax">Syntax
   <ulink url="&clhs;/Body/chap-2.html">[CLHS-2]</ulink></tocentry>
 <tocentry linkend="eval">Evaluation and Compilation
   <ulink url="&clhs;/Body/chap-3.html">[CLHS-3]</ulink></tocentry>
 <tocentry linkend="types-classes">Types and Classes
   <ulink url="&clhs;/Body/chap-4.html">[CLHS-4]</ulink></tocentry>
 <tocentry linkend="data">Data and Control Flow
   <ulink url="&clhs;/Body/chap-5.html">[CLHS-5]</ulink></tocentry>
 <tocentry linkend="iteration">Iteration
   <ulink url="&clhs;/Body/chap-6.html">[CLHS-6]</ulink></tocentry>
 <tocentry linkend="objects">Objects
   <ulink url="&clhs;/Body/chap-7.html">[CLHS-7]</ulink></tocentry>
 <tocentry linkend="structures">Structures
   <ulink url="&clhs;/Body/chap-8.html">[CLHS-8]</ulink></tocentry>
 <tocentry linkend="conditions">Conditions
   <ulink url="&clhs;/Body/chap-9.html">[CLHS-9]</ulink></tocentry>
 <tocentry linkend="symbols">Symbols
   <ulink url="&clhs;/Body/chap-10.html">[CLHS-10]</ulink></tocentry>
 <tocentry linkend="packages">Packages
   <ulink url="&clhs;/Body/chap-11.html">[CLHS-11]</ulink></tocentry>
 <tocentry linkend="numbers">Numbers
   <ulink url="&clhs;/Body/chap-12.html">[CLHS-12]</ulink></tocentry>
 <tocentry linkend="characters">Characters
   <ulink url="&clhs;/Body/chap-13.html">[CLHS-13]</ulink></tocentry>
 <tocentry linkend="conses">Conses
   <ulink url="&clhs;/Body/chap-14.html">[CLHS-14]</ulink></tocentry>
 <tocentry linkend="arrays">Arrays
   <ulink url="&clhs;/Body/chap-15.html">[CLHS-15]</ulink></tocentry>
 <tocentry linkend="strings">Strings
   <ulink url="&clhs;/Body/chap-16.html">[CLHS-16]</ulink></tocentry>
 <tocentry linkend="sequences">Sequences
   <ulink url="&clhs;/Body/chap-17.html">[CLHS-17]</ulink></tocentry>
 <tocentry linkend="hash">Hash Tables
   <ulink url="&clhs;/Body/chap-18.html">[CLHS-18]</ulink></tocentry>
 <tocentry linkend="filenames">Filenames
   <ulink url="&clhs;/Body/chap-19.html">[CLHS-19]</ulink></tocentry>
 <tocentry linkend="files">Files
   <ulink url="&clhs;/Body/chap-20.html">[CLHS-20]</ulink></tocentry>
 <tocentry linkend="streams">Streams
   <ulink url="&clhs;/Body/chap-21.html">[CLHS-21]</ulink></tocentry>
 <tocentry linkend="printer">Printer
   <ulink url="&clhs;/Body/chap-22.html">[CLHS-22]</ulink></tocentry>
 <tocentry linkend="reader">Reader
   <ulink url="&clhs;/Body/chap-23.html">[CLHS-23]</ulink></tocentry>
 <tocentry linkend="system">System Construction
   <ulink url="&clhs;/Body/chap-24.html">[CLHS-24]</ulink></tocentry>
 <tocentry linkend="environment">Environment
   <ulink url="&clhs;/Body/chap-25.html">[CLHS-25]</ulink></tocentry>
 <tocentry linkend="glossary">Glossary
   <ulink url="&clhs;/Body/chap-26.html">[CLHS-26]</ulink></tocentry>
 <tocentry linkend="appendix">Appendix
   <ulink url="&clhs;/Body/chap-a.html">[CLHS-a]</ulink></tocentry>
 <tocentry linkend="issues">X3J13 Issue Index
   <ulink url="&clhs;/Issues/Issues-Categorized.html">[CLHS-ic]</ulink></tocentry>
</tocpart>

<tocpart><tocentry linkend="internals">Internals of the
 &clisp; Implementation</tocentry>
<!-- filling this in would require some work and it is ignored anyway! -->
</tocpart>

<tocpart><tocentry linkend="extensions">Extensions</tocentry>
 <tocchap><tocentry linkend="p-indep">
   [Platform-independent Extensions]</tocentry>
   <tocentry linkend="image">[Saving an Image]</tocentry>
   <tocentry linkend="quit">[Quitting Lisp]</tocentry>
   <tocentry linkend="i18n">[Internationalization]</tocentry>
   <tocentry linkend="encoding">[Encodings]</tocentry>
   <tocentry linkend="clos-stream">[Defining new kinds of Streams]</tocentry>
   <tocentry linkend="weak">[Weak Pointers]</tocentry>
   <tocentry linkend="final">[Finalization]</tocentry>
   <tocentry linkend="prompt">[The Prompt]</tocentry>
   <tocentry linkend="ansi">[Maximum ANSI CL compliance]</tocentry>
   <tocentry linkend="macros3">[Additional Fancy Macros]</tocentry>
 </tocchap>
 <tocchap><tocentry linkend="platform">
   [Platform-specific Extensions]</tocentry>
   <tocentry linkend="screen">[Random Screen Access]</tocentry>
   <tocentry linkend="modules">[External Modules]</tocentry>
   <tocentry linkend="dffi">[The Foreign Function Call Facility]</tocentry>
   <tocentry linkend="affi">[The Amiga Foreign Function Facility]</tocentry>
   <tocentry linkend="rexx">[ARexx]</tocentry>
   <tocentry linkend="socket">[Socket Streams]</tocentry>
   <tocentry linkend="syscalls">[System Calls]</tocentry>
   <tocentry linkend="quickstart">[Quickstarting CLISP programs]</tocentry>
   <tocentry linkend="app-dev">[Application delivery with CLISP]</tocentry>
   <tocentry linkend="shell">[Shell, Pipes and Printing]</tocentry>
   <tocentry linkend="dir-key">[Directory Access]</tocentry>
   <tocentry linkend="other">[Other]</tocentry>
 </tocchap>
</tocpart>
<tocpart><tocentry>Appendices</tocentry>
<tocentry linkend="gfdl">GNU Free Documentation License</tocentry>
</tocpart>
</toc>

<part id="clhs-chapters"><title>Chapters or the &hyperspec;</title>

&imp-body;

&imp-issues;

</part>

&imp-byte;

&imp-ext;

&gfdl-text;

<bibliography id="references">
 <title>References</title>
 <bibliodiv><title>Books</title>
  &cltl1-bib;
  &cltl2-bib;
 </bibliodiv>
 <bibliodiv><title>ANSI standard documents</title>
  &ansi-cl-bib;
  &hyperspec-bib;
 </bibliodiv>
</bibliography>

</book>

<!--
Local Variables:
time-stamp-start: "<subtitle>Last modified: "
time-stamp-end: "</subtitle>"
time-stamp-format: "%:y-%02m-%02d"
time-stamp-line-limit: 0
eval: (add-hook 'write-file-hooks 'time-stamp)
end:
-->
