[Openmcl-cvs-notifications] r9209 - /trunk/source/doc/ccl-documentation.html
gb at clozure.com
gb at clozure.com
Sun Apr 20 06:50:43 EDT 2008
Author: gb
Date: Sun Apr 20 06:50:43 2008
New Revision: 9209
Log:
built from 9206
Modified:
trunk/source/doc/ccl-documentation.html
Modified: trunk/source/doc/ccl-documentation.html
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D
--- trunk/source/doc/ccl-documentation.html (original)
+++ trunk/source/doc/ccl-documentation.html Sun Apr 20 06:50:43 2008
@@ -4,16 +4,16 @@
<head>
<meta http-equiv=3D"Content-Type" content=3D"text/html; charset=3DUTF-=
8" />
<title>Clozure CL Documentation</title>
- <meta name=3D"generator" content=3D"DocBook XSL Stylesheets V1.72.0" />
- <link rel=3D"start" href=3D"#id312246" title=3D"Clozure CL Documentati=
on" />
- <link rel=3D"next" href=3D"#id469589" title=3D"Chapter=C3=82=C2=A01.=
=C3=82=C2=A0About Clozure CL" />
+ <meta name=3D"generator" content=3D"DocBook XSL Stylesheets V1.73.2" />
+ <link rel=3D"start" href=3D"#id301106" title=3D"Clozure CL Documentati=
on" />
+ <link rel=3D"next" href=3D"#id322476" title=3D"Chapter=C3=82=C2=A01.=
=C3=82=C2=A0About Clozure CL" />
</head>
<body>
<div class=3D"book" lang=3D"en" xml:lang=3D"en">
<div class=3D"titlepage">
<div>
<div>
- <h1 class=3D"title"><a id=3D"id312246"></a>Clozure CL Document=
ation</h1>
+ <h1 class=3D"title"><a id=3D"id301106"></a>Clozure CL Document=
ation</h1>
</div>
</div>
<hr />
@@ -22,38 +22,38 @@
<dl>
<dt>
<span class=3D"chapter">
- <a href=3D"#id469589">1. About Clozure CL</a>
+ <a href=3D"#id322476">1. About Clozure CL</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class=3D"sect1">
- <a href=3D"#id461338">1.1. Introduction to Clozure CL</a>
+ <a href=3D"#id378260">1.1. Introduction to Clozure CL</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class=3D"chapter">
- <a href=3D"#id457672">2. Obtaining, Installing, and Running =
Clozure CL</a>
+ <a href=3D"#id335115">2. Obtaining, Installing, and Running =
Clozure CL</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class=3D"sect1">
- <a href=3D"#id452608">2.1. Releases and System Requireme=
nts</a>
+ <a href=3D"#id360672">2.1. Releases and System Requireme=
nts</a>
</span>
</dt>
<dt>
<span class=3D"sect1">
- <a href=3D"#id485386">2.2. Obtaining Clozure CL</a>
+ <a href=3D"#id364310">2.2. Obtaining Clozure CL</a>
</span>
</dt>
<dt>
<span class=3D"sect1">
- <a href=3D"#id478754">2.3. Command Line Set Up</a>
+ <a href=3D"#id308181">2.3. Command Line Set Up</a>
</span>
</dt>
<dt>
@@ -80,7 +80,7 @@
</dd>
<dt>
<span class=3D"chapter">
- <a href=3D"#id459555">3. Building Clozure CL from its Source=
Code</a>
+ <a href=3D"#id321732">3. Building Clozure CL from its Source=
Code</a>
</span>
</dt>
<dd>
@@ -114,14 +114,14 @@
</dd>
<dt>
<span class=3D"chapter">
- <a href=3D"#id462094">4. Using Clozure CL</a>
+ <a href=3D"#id322946">4. Using Clozure CL</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class=3D"sect1">
- <a href=3D"#id482055">4.1. Introduction</a>
+ <a href=3D"#id370264">4.1. Introduction</a>
</span>
</dt>
<dt>
@@ -158,39 +158,39 @@
</dd>
<dt>
<span class=3D"chapter">
- <a href=3D"#id471096">5. The Clozure CL IDE</a>
+ <a href=3D"#id351866">5. The Clozure CL IDE</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class=3D"sect1">
- <a href=3D"#id447378">5.1. Introduction</a>
+ <a href=3D"#id391992">5.1. Introduction</a>
</span>
</dt>
<dt>
<span class=3D"sect1">
- <a href=3D"#id461540">5.2. Building the IDE</a>
+ <a href=3D"#id388704">5.2. Building the IDE</a>
</span>
</dt>
<dt>
<span class=3D"sect1">
- <a href=3D"#id460360">5.3. Running the IDE</a>
+ <a href=3D"#id352336">5.3. Running the IDE</a>
</span>
</dt>
<dt>
<span class=3D"sect1">
- <a href=3D"#id443840">5.4. IDE Features</a>
+ <a href=3D"#id349170">5.4. IDE Features</a>
</span>
</dt>
<dt>
<span class=3D"sect1">
- <a href=3D"#id495865">5.5. IDE Sources</a>
+ <a href=3D"#id394341">5.5. IDE Sources</a>
</span>
</dt>
<dt>
<span class=3D"sect1">
- <a href=3D"#id464104">5.6. The Application Builder</a>
+ <a href=3D"#id394374">5.6. The Application Builder</a>
</span>
</dt>
</dl>
@@ -420,7 +420,7 @@
</dt>
<dt>
<span class=3D"sect1">
- <a href=3D"#id523636">12.12. The Foreign-Function-Interf=
ace Dictionary</a>
+ <a href=3D"#id430545">12.12. The Foreign-Function-Interf=
ace Dictionary</a>
</span>
</dt>
</dl>
@@ -655,7 +655,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title"><a id=3D"id469589"></a>Chapter=C3=82=C2=
=A01.=C3=82=C2=A0About Clozure CL</h2>
+ <h2 class=3D"title"><a id=3D"id322476"></a>Chapter=C3=82=C2=
=A01.=C3=82=C2=A0About Clozure CL</h2>
</div>
</div>
</div>
@@ -663,7 +663,7 @@
<dl>
<dt>
<span class=3D"sect1">
- <a href=3D"#id461338">1.1. Introduction to Clozure CL</a>
+ <a href=3D"#id378260">1.1. Introduction to Clozure CL</a>
</span>
</dt>
</dl>
@@ -672,7 +672,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title" style=3D"clear: both"><a id=3D"id46133=
8"></a>1.1.=C3=82=C2=A0Introduction to Clozure CL</h2>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"id37826=
0"></a>1.1.=C3=82=C2=A0Introduction to Clozure CL</h2>
</div>
</div>
</div>
@@ -781,7 +781,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title"><a id=3D"id457672"></a>Chapter=C3=82=C2=
=A02.=C3=82=C2=A0Obtaining, Installing, and Running Clozure CL</h2>
+ <h2 class=3D"title"><a id=3D"id335115"></a>Chapter=C3=82=C2=
=A02.=C3=82=C2=A0Obtaining, Installing, and Running Clozure CL</h2>
</div>
</div>
</div>
@@ -789,65 +789,65 @@
<dl>
<dt>
<span class=3D"sect1">
- <a href=3D"#id452608">2.1. Releases and System Requirement=
s</a>
+ <a href=3D"#id360672">2.1. Releases and System Requirement=
s</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class=3D"sect2">
- <a href=3D"#id483238">2.1.1. LinuxPPC</a>
+ <a href=3D"#id369379">2.1.1. LinuxPPC</a>
</span>
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id485826">2.1.2. Linux X8664</a>
+ <a href=3D"#id349897">2.1.2. Linux X8664</a>
</span>
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id454012">2.1.3. FreeBSD-amd64</a>
+ <a href=3D"#id347997">2.1.3. FreeBSD-amd64</a>
</span>
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id463497">2.1.4. DarwinPPC-MacOS-X</a>
+ <a href=3D"#id366253">2.1.4. DarwinPPC-MacOS-X</a>
</span>
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id463405">2.1.5. Darwinx8664-MacOS-X</a>
+ <a href=3D"#id364292">2.1.5. Darwinx8664-MacOS-X</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class=3D"sect1">
- <a href=3D"#id485386">2.2. Obtaining Clozure CL</a>
+ <a href=3D"#id364310">2.2. Obtaining Clozure CL</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class=3D"sect2">
- <a href=3D"#id484245">2.2.1. The Mac Way</a>
+ <a href=3D"#id364330">2.2.1. The Mac Way</a>
</span>
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id487280">2.2.2. Getting Clozure CL with S=
ubversion</a>
+ <a href=3D"#id397955">2.2.2. Getting Clozure CL with S=
ubversion</a>
</span>
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id458292">2.2.3. Tarballs</a>
+ <a href=3D"#id308156">2.2.3. Tarballs</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class=3D"sect1">
- <a href=3D"#id478754">2.3. Command Line Set Up</a>
+ <a href=3D"#id308181">2.3. Command Line Set Up</a>
</span>
</dt>
<dd>
@@ -893,7 +893,7 @@
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id491137">2.6.3. Installing SLIME</a>
+ <a href=3D"#id371816">2.6.3. Installing SLIME</a>
</span>
</dt>
<dt>
@@ -929,7 +929,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title" style=3D"clear: both"><a id=3D"id45260=
8"></a>2.1.=C3=82=C2=A0Releases and System Requirements</h2>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"id36067=
2"></a>2.1.=C3=82=C2=A0Releases and System Requirements</h2>
</div>
</div>
</div>
@@ -976,7 +976,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id483238"></a>2.1.1.=C3=82=
=C2=A0LinuxPPC</h3>
+ <h3 class=3D"title"><a id=3D"id369379"></a>2.1.1.=C3=82=
=C2=A0LinuxPPC</h3>
</div>
</div>
</div>
@@ -988,7 +988,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id485826"></a>2.1.2.=C3=82=
=C2=A0Linux X8664</h3>
+ <h3 class=3D"title"><a id=3D"id349897"></a>2.1.2.=C3=82=
=C2=A0Linux X8664</h3>
</div>
</div>
</div>
@@ -1014,7 +1014,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id454012"></a>2.1.3.=C3=82=
=C2=A0FreeBSD-amd64</h3>
+ <h3 class=3D"title"><a id=3D"id347997"></a>2.1.3.=C3=82=
=C2=A0FreeBSD-amd64</h3>
</div>
</div>
</div>
@@ -1029,7 +1029,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id463497"></a>2.1.4.=C3=82=
=C2=A0DarwinPPC-MacOS-X</h3>
+ <h3 class=3D"title"><a id=3D"id366253"></a>2.1.4.=C3=82=
=C2=A0DarwinPPC-MacOS-X</h3>
</div>
</div>
</div>
@@ -1049,7 +1049,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id463405"></a>2.1.5.=C3=82=
=C2=A0Darwinx8664-MacOS-X</h3>
+ <h3 class=3D"title"><a id=3D"id364292"></a>2.1.5.=C3=82=
=C2=A0Darwinx8664-MacOS-X</h3>
</div>
</div>
</div>
@@ -1068,7 +1068,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title" style=3D"clear: both"><a id=3D"id48538=
6"></a>2.2.=C3=82=C2=A0Obtaining Clozure CL</h2>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"id36431=
0"></a>2.2.=C3=82=C2=A0Obtaining Clozure CL</h2>
</div>
</div>
</div>
@@ -1091,7 +1091,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id484245"></a>2.2.1.=C3=82=
=C2=A0The Mac Way</h3>
+ <h3 class=3D"title"><a id=3D"id364330"></a>2.2.1.=C3=82=
=C2=A0The Mac Way</h3>
</div>
</div>
</div>
@@ -1100,10 +1100,10 @@
disk image, then drag Clozure CL to the Applications folder.
After that you can double-click the Clozure CL application to
run it. The disk images are available at
- <a href=3D"ftp://clozure.com/pub/testing/" target=3D"_top">ftp://=
clozure.com/pub/testing/</a> </p>
+ <a class=3D"ulink" href=3D"ftp://clozure.com/pub/testing/" target=
=3D"_top">ftp://clozure.com/pub/testing/</a> </p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">So that Clozure CL c=
an locate its source code, and for other
reasons explained in
- <a href=3D"#Predefined-Logical-Hosts" title=3D"4.4.2.=C3=82=C2=A0P=
redefined Logical Hosts">Section=C3=82=C2=A04.4.2, =C3=A2=C2=80=C2=9CPredef=
ined Logical Hosts=C3=A2=C2=80=C2=9D</a>, you should either put the
+ <a class=3D"xref" href=3D"#Predefined-Logical-Hosts" title=3D"4.4.=
2.=C3=82=C2=A0Predefined Logical Hosts">Section=C3=82=C2=A04.4.2, =C3=A2=C2=
=80=C2=9CPredefined Logical Hosts=C3=A2=C2=80=C2=9D</a>, you should either =
put the
<code class=3D"literal">ccl</code> directory in the same directory=
as the
Clozure CL application, or else put the Clozure CL application
in the <code class=3D"literal">ccl</code> directory. If you use a=
shell,
@@ -1119,7 +1119,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id487280"></a>2.2.2.=C3=82=
=C2=A0Getting Clozure CL with Subversion</h3>
+ <h3 class=3D"title"><a id=3D"id397955"></a>2.2.2.=C3=82=
=C2=A0Getting Clozure CL with Subversion</h3>
</div>
</div>
</div>
@@ -1219,7 +1219,7 @@
If Subversion is not installed, you'll need to figure out how
to install it on your OS. You can find information about
obtaining and installing Subversion at
- the <a href=3D"http://subversion.tigris.org/project_packages.html"=
target=3D"_top">Subversion
+ the <a class=3D"ulink" href=3D"http://subversion.tigris.org/projec=
t_packages.html" target=3D"_top">Subversion
Packages page</a>.</p>
</div>
</div>
@@ -1227,14 +1227,14 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id458292"></a>2.2.3.=C3=82=
=C2=A0Tarballs</h3>
+ <h3 class=3D"title"><a id=3D"id308156"></a>2.2.3.=C3=82=
=C2=A0Tarballs</h3>
</div>
</div>
</div>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">Tarballs are availab=
le at <a href=3D"ftp://clozure.com/pub/testing/" target=3D"_top">ftp://cloz=
ure.com/pub/testing/</a>. Download and extract
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">Tarballs are availab=
le at <a class=3D"ulink" href=3D"ftp://clozure.com/pub/testing/" target=3D"=
_top">ftp://clozure.com/pub/testing/</a>. Download and extract
one on your local disk. Then edit the Clozure CL shell script to set
the value of <em class=3D"varname">CCL_DEFAULT_DIRECTORY</em> and st=
art
- up the appropriate Clozure CL kernel. See <a href=3D"#The-ccl-Shell-=
Script" title=3D"2.3.1.=C3=82=C2=A0The ccl Shell Script">Section=C3=82=C2=
=A02.3.1, =C3=A2=C2=80=C2=9CThe ccl Shell Script=C3=A2=C2=80=C2=9D</a> for =
more information about the
+ up the appropriate Clozure CL kernel. See <a class=3D"xref" href=3D"=
#The-ccl-Shell-Script" title=3D"2.3.1.=C3=82=C2=A0The ccl Shell Script">Sec=
tion=C3=82=C2=A02.3.1, =C3=A2=C2=80=C2=9CThe ccl Shell Script=C3=A2=C2=80=
=C2=9D</a> for more information about the
Clozure CL shell scripts.</p>
</div>
</div>
@@ -1242,7 +1242,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title" style=3D"clear: both"><a id=3D"id47875=
4"></a>2.3.=C3=82=C2=A0Command Line Set Up</h2>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"id30818=
1"></a>2.3.=C3=82=C2=A0Command Line Set Up</h2>
</div>
</div>
</div>
@@ -1261,9 +1261,9 @@
<code class=3D"literal">ccl</code> directory in order to support f=
eatures
such as <code class=3D"literal">require</code> and
<code class=3D"literal">provide</code>, access to foreign interface
- information (see <a href=3D"#The-Interface-Database" title=3D"12.4=
.=C3=82=C2=A0The Interface Database">The
+ information (see <a class=3D"link" href=3D"#The-Interface-Database=
" title=3D"12.4.=C3=82=C2=A0The Interface Database">The
Interface Database</a>) and the Lisp build process (see
- <a href=3D"#Building-CCL">Building Clozure CL from its Source
+ <a class=3D"link" href=3D"#Building-CCL">Building Clozure CL from =
its Source
Code</a>). Specifically, it needs to set up logical
pathname translations for the <code class=3D"literal">"ccl:"</code>
logical host. If this logical host isn't defined (or isn't
@@ -1357,7 +1357,7 @@
?
</pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The ccl shell script=
passes all of its arguments to the
- Clozure CL kernel. See <a href=3D"#Invocation" title=3D"2.3.2.=C3=
=82=C2=A0Invocation">Section=C3=82=C2=A02.3.2, =C3=A2=C2=80=C2=9CInvocation=
=C3=A2=C2=80=C2=9D</a> for more
+ Clozure CL kernel. See <a class=3D"xref" href=3D"#Invocation" title=
=3D"2.3.2.=C3=82=C2=A0Invocation">Section=C3=82=C2=A02.3.2, =C3=A2=C2=80=C2=
=9CInvocation=C3=A2=C2=80=C2=9D</a> for more
information about these arguments. When invoked this way, the
Lisp should be able to initialize the <code class=3D"literal">"ccl:"=
</code>
logical host so that its translations refer to the
@@ -1446,7 +1446,7 @@
<code class=3D"literal">--version</code>). Prints the version of
Clozure CL then exits. This is the same thing that is
returned by
- <span><strong class=3D"function">LISP-APPLICATION-VERSION</strong><=
/span>.</p>
+ <span class=3D"function"><strong>LISP-APPLICATION-VERSION</strong><=
/span>.</p>
</li>
<li>
<p><code class=3D"literal">-K</code>
@@ -1454,7 +1454,7 @@
<code class=3D"literal">--terminal-encoding</code>
<em class=3D"parameter"><code>character-encoding-name</code></em>).
Specifies the character encoding to use for
- <em class=3D"varname">*TERMINAL-IO*</em> (see <a href=3D"#Character=
-Encodings" title=3D"4.3.4.=C3=82=C2=A0Character Encodings">Section=C3=82=
=C2=A04.3.4, =C3=A2=C2=80=C2=9CCharacter Encodings=C3=A2=C2=80=C2=9D</a>). =
Specifically, the
+ <em class=3D"varname">*TERMINAL-IO*</em> (see <a class=3D"xref" hre=
f=3D"#Character-Encodings" title=3D"4.3.4.=C3=82=C2=A0Character Encodings">=
Section=C3=82=C2=A04.3.4, =C3=A2=C2=80=C2=9CCharacter Encodings=C3=A2=C2=80=
=C2=9D</a>). Specifically, the
<em class=3D"parameter"><code>character-encoding-name</code></em> s=
tring
is uppercased and interned in the KEYWORD package. If an
encoding named by that keyword exists,
@@ -1482,7 +1482,7 @@
<li>
<p><code class=3D"literal">-e</code> <em class=3D"paramete=
r"><code>form</code></em>
(or <code class=3D"literal">--eval</code>). An expression is read (=
via
- <span><strong class=3D"function">READ-FROM-STRING</strong></span>) =
from the string
+ <span class=3D"function"><strong>READ-FROM-STRING</strong></span>) =
from the string
<em class=3D"parameter"><code>form</code></em> and evaluated. If
<em class=3D"parameter"><code>form</code></em> contains shell metac=
haracters,
it may be necessary to escape or quote them to prevent the
@@ -1498,7 +1498,7 @@
<p><code class=3D"literal">-T</code> <em class=3D"paramete=
r"><code>n</code></em> (or
<code class=3D"literal">--set-lisp-heap-gc-threshold</code>
<em class=3D"parameter"><code>n</code></em>). Sets the Lisp gc thr=
eshold to
- <em class=3D"parameter"><code>n</code></em>. (see <a href=3D"#GC-Pa=
ge-reclamation-policy" title=3D"15.3.=C3=82=C2=A0GC Page reclamation policy=
">Section=C3=82=C2=A015.3, =C3=A2=C2=80=C2=9CGC Page reclamation policy=C3=
=A2=C2=80=C2=9D</a></p>
+ <em class=3D"parameter"><code>n</code></em>. (see <a class=3D"xref"=
href=3D"#GC-Page-reclamation-policy" title=3D"15.3.=C3=82=C2=A0GC Page rec=
lamation policy">Section=C3=82=C2=A015.3, =C3=A2=C2=80=C2=9CGC Page reclama=
tion policy=C3=A2=C2=80=C2=9D</a></p>
</li>
<li>
<p><code class=3D"literal">-Q</code> (or
@@ -1510,18 +1510,18 @@
<p><code class=3D"literal">-R</code> <em class=3D"paramete=
r"><code>n</code></em> (or
<code class=3D"literal">--heap-reserve</code>). Reserves
<em class=3D"parameter"><code>n</code></em> bytes for heap expansio=
n. The
- default is <code class=3D"literal"> 549755813888</code>. (see <a h=
ref=3D"#Heap-space-allocation" title=3D"15.1.=C3=82=C2=A0Heap space allocat=
ion">Section=C3=82=C2=A015.1, =C3=A2=C2=80=C2=9CHeap space allocation=C3=A2=
=C2=80=C2=9D</a>)</p>
+ default is <code class=3D"literal"> 549755813888</code>. (see <a c=
lass=3D"xref" href=3D"#Heap-space-allocation" title=3D"15.1.=C3=82=C2=A0Hea=
p space allocation">Section=C3=82=C2=A015.1, =C3=A2=C2=80=C2=9CHeap space a=
llocation=C3=A2=C2=80=C2=9D</a>)</p>
</li>
<li>
<p><code class=3D"literal">-S</code> <em class=3D"paramete=
r"><code>n</code></em> (or
<code class=3D"literal">--stack-size</code> <em class=3D"parameter"=
><code>n</code></em>). Sets the size of the
- initial control stack to <em class=3D"parameter"><code>n</code></em=
>. (see <a href=3D"#Thread-Stack-Sizes" title=3D"7.3.1.=C3=82=C2=A0Thread S=
tack Sizes">Section=C3=82=C2=A07.3.1, =C3=A2=C2=80=C2=9CThread Stack Sizes=
=C3=A2=C2=80=C2=9D</a>)</p>
+ initial control stack to <em class=3D"parameter"><code>n</code></em=
>. (see <a class=3D"xref" href=3D"#Thread-Stack-Sizes" title=3D"7.3.1.=C3=
=82=C2=A0Thread Stack Sizes">Section=C3=82=C2=A07.3.1, =C3=A2=C2=80=C2=9CTh=
read Stack Sizes=C3=A2=C2=80=C2=9D</a>)</p>
</li>
<li>
<p><code class=3D"literal">-Z</code> <em class=3D"paramete=
r"><code>n</code></em> (or
<code class=3D"literal">--thread-stack-size</code>
<em class=3D"parameter"><code>n</code></em>). Sets the size of the =
first
- thread's stack to <em class=3D"parameter"><code>n</code></em>. (see=
<a href=3D"#Thread-Stack-Sizes" title=3D"7.3.1.=C3=82=C2=A0Thread Stack Si=
zes">Section=C3=82=C2=A07.3.1, =C3=A2=C2=80=C2=9CThread Stack Sizes=C3=A2=
=C2=80=C2=9D</a>)</p>
+ thread's stack to <em class=3D"parameter"><code>n</code></em>. (see=
<a class=3D"xref" href=3D"#Thread-Stack-Sizes" title=3D"7.3.1.=C3=82=C2=A0=
Thread Stack Sizes">Section=C3=82=C2=A07.3.1, =C3=A2=C2=80=C2=9CThread Stac=
k Sizes=C3=A2=C2=80=C2=9D</a>)</p>
</li>
<li>
<p><code class=3D"literal">-b</code> (or <code class=3D"li=
teral">--batch</code>). Execute in "batch mode". End-of-file
@@ -1592,7 +1592,7 @@
</ul>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">For complete informati=
on about SLIME, see the
- SLIME <a href=3D"http://common-lisp.net/project/slime/" target=3D"_t=
op">home
+ SLIME <a class=3D"ulink" href=3D"http://common-lisp.net/project/slim=
e/" target=3D"_top">home
page</a>. The SLIME home page provides up-to-date downloads,
plus documentation, tutorials, and instructional
screencasts.</p>
@@ -1676,7 +1676,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id491137"></a>2.6.3.=C3=82=
=C2=A0Installing SLIME</h3>
+ <h3 class=3D"title"><a id=3D"id371816"></a>2.6.3.=C3=82=
=C2=A0Installing SLIME</h3>
</div>
</div>
</div>
@@ -1792,7 +1792,7 @@
<p xmlns=3D"http://www.w3.org/1999/xhtml">For more help with C=
lozure CL on Mac OS X, consult the Clozure CL
mailing lists. You can find information about the mailing
lists on the
- Clozure CL <a href=3D"http://trac.clozure.com/openmcl" target=3D"_=
top">wiki</a>.</p>
+ Clozure CL <a class=3D"ulink" href=3D"http://trac.clozure.com/open=
mcl" target=3D"_top">wiki</a>.</p>
</div>
</div>
<div class=3D"sect1" lang=3D"en" xml:lang=3D"en">
@@ -1829,7 +1829,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title"><a id=3D"id459555"></a>Chapter=C3=82=C2=
=A03.=C3=82=C2=A0Building Clozure CL from its Source Code</h2>
+ <h2 class=3D"title"><a id=3D"id321732"></a>Chapter=C3=82=C2=
=A03.=C3=82=C2=A0Building Clozure CL from its Source Code</h2>
</div>
</div>
</div>
@@ -1940,8 +1940,8 @@
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The following terms ar=
e used in subsequent sections; it
may be helpful to refer to these definitions.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml"><a id=3D"id452942" cla=
ss=3D"indexterm"></a><a href=3D"#fasl-file"><em class=3D"glossterm">fasl
- files</em></a> are the object files produced
+ <p xmlns=3D"http://www.w3.org/1999/xhtml"><a id=3D"id352854" cla=
ss=3D"indexterm"></a><a class=3D"glossterm" href=3D"#fasl-file"><em class=
=3D"glossterm">fasl
+ files</em></a> are the object files produced
by <code class=3D"literal">compile-file</code>. fasl files store the
machine code associated with function definitions and the
external representation of other lisp objects in a compact,
@@ -1950,9 +1950,9 @@
<code class=3D"literal">L</code>oading=C3=A2=C2=80=C2=9D. Clozure CL=
uses different pathname
types (extensions) to name fasl files on different platforms;
see
- <a href=3D"#Platform-specific-filename-conventions" title=3D"Table=
=C3=82=C2=A03.1.=C3=82=C2=A0Platform-specific filename conventions">Table=
=C3=82=C2=A03.1, =C3=A2=C2=80=C2=9CPlatform-specific filename conventions=
=C3=A2=C2=80=C2=9D</a> </p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">The <a id=3D"id483934"=
class=3D"indexterm"></a> <a href=3D"#lisp_kernel"><em class=3D"glossterm">=
Lisp
- kernel</em></a> is a C program with a fair amount of
+ <a class=3D"xref" href=3D"#Platform-specific-filename-conventions" t=
itle=3D"Table=C3=82=C2=A03.1.=C3=82=C2=A0Platform-specific filename convent=
ions">Table=C3=82=C2=A03.1, =C3=A2=C2=80=C2=9CPlatform-specific filename co=
nventions=C3=A2=C2=80=C2=9D</a> </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">The <a id=3D"id361301"=
class=3D"indexterm"></a> <a class=3D"glossterm" href=3D"#lisp_kernel"><em =
class=3D"glossterm">Lisp
+ kernel</em></a> is a C program with a fair amount of
platform-specific assembly language code. Its basic job is to
map a lisp heap image into memory, transfer control to some
compiled lisp code that the image contains, handle any
@@ -1960,9 +1960,9 @@
and provide various other forms of runtime support for that
code. Clozure CL uses different filenames to name the lisp kernel
files on different platforms; see
- <a href=3D"#Platform-specific-filename-conventions" title=3D"Table=
=C3=82=C2=A03.1.=C3=82=C2=A0Platform-specific filename conventions">Table=
=C3=82=C2=A03.1, =C3=A2=C2=80=C2=9CPlatform-specific filename conventions=
=C3=A2=C2=80=C2=9D</a>.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">A <a id=3D"id476697" c=
lass=3D"indexterm"></a> <a href=3D"#lisp_image"><em class=3D"glossterm">heap
- image</em></a> is a file that can be quickly mapped into a
+ <a class=3D"xref" href=3D"#Platform-specific-filename-conventions" t=
itle=3D"Table=C3=82=C2=A03.1.=C3=82=C2=A0Platform-specific filename convent=
ions">Table=C3=82=C2=A03.1, =C3=A2=C2=80=C2=9CPlatform-specific filename co=
nventions=C3=A2=C2=80=C2=9D</a>.</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">A <a id=3D"id374738" c=
lass=3D"indexterm"></a> <a class=3D"glossterm" href=3D"#lisp_image"><em cla=
ss=3D"glossterm">heap
+ image</em></a> is a file that can be quickly mapped into a
process' address space. Conceptually, it's not too different
from an executable file or shared library in the OS's native
format (ELF orMach-O/dyld format); for historical reasons,
@@ -1971,25 +1971,25 @@
heap image file that contains all of the code and data that
comprise Clozure CL. Clozure CL uses different filenames to name the
standard full heap image files on different platforms; see
- <a href=3D"#Platform-specific-filename-conventions" title=3D"Table=
=C3=82=C2=A03.1.=C3=82=C2=A0Platform-specific filename conventions">Table=
=C3=82=C2=A03.1, =C3=A2=C2=80=C2=9CPlatform-specific filename conventions=
=C3=A2=C2=80=C2=9D</a>.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">A <a id=3D"id464058" c=
lass=3D"indexterm"></a> bootstrapping image is a minimal
+ <a class=3D"xref" href=3D"#Platform-specific-filename-conventions" t=
itle=3D"Table=C3=82=C2=A03.1.=C3=82=C2=A0Platform-specific filename convent=
ions">Table=C3=82=C2=A03.1, =C3=A2=C2=80=C2=9CPlatform-specific filename co=
nventions=C3=A2=C2=80=C2=9D</a>.</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">A <a id=3D"id366185" c=
lass=3D"indexterm"></a> bootstrapping image is a minimal
heap image used in the process of building Clozure CL itself. The
bootstrapping image contains just enough code to load the rest
of Clozure CL from fasl files. It may help to think of the
bootstrapping image as the egg and the full heap image as the
chicken. Clozure CL uses different filenames to name the standard
bootstrapping image files on different platforms; see
- <a href=3D"#Platform-specific-filename-conventions" title=3D"Table=
=C3=82=C2=A03.1.=C3=82=C2=A0Platform-specific filename conventions">Table=
=C3=82=C2=A03.1, =C3=A2=C2=80=C2=9CPlatform-specific filename conventions=
=C3=A2=C2=80=C2=9D</a>
+ <a class=3D"xref" href=3D"#Platform-specific-filename-conventions" t=
itle=3D"Table=C3=82=C2=A03.1.=C3=82=C2=A0Platform-specific filename convent=
ions">Table=C3=82=C2=A03.1, =C3=A2=C2=80=C2=9CPlatform-specific filename co=
nventions=C3=A2=C2=80=C2=9D</a>
.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Each supported platfor=
m (and possibly a few
as-yet-unsupported ones) has a uniquely named subdirectory of
<code class=3D"literal">ccl/lisp-kernel/</code>; each such
- <a id=3D"id474934" class=3D"indexterm"></a>
+ <a id=3D"id366211" class=3D"indexterm"></a>
contains a Makefile and may contain some auxiliary files (linker
scripts, etc.) that are used to build the lisp kernel on a
particular platform.The platform-specific name of the kernel
build directory is described in
- <a href=3D"#Platform-specific-filename-conventions" title=3D"Table=
=C3=82=C2=A03.1.=C3=82=C2=A0Platform-specific filename conventions">Table=
=C3=82=C2=A03.1, =C3=A2=C2=80=C2=9CPlatform-specific filename conventions=
=C3=A2=C2=80=C2=9D</a>.</p>
+ <a class=3D"xref" href=3D"#Platform-specific-filename-conventions" t=
itle=3D"Table=C3=82=C2=A03.1.=C3=82=C2=A0Platform-specific filename convent=
ions">Table=C3=82=C2=A03.1, =C3=A2=C2=80=C2=9CPlatform-specific filename co=
nventions=C3=A2=C2=80=C2=9D</a>.</p>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
@@ -2105,13 +2105,13 @@
</li>
<li>
<p>Version 1.1 - the more recent version, which
- runs on more platforms (including x86-64 platforms) and
- supports Unicode</p>
+ runs on more platforms (including x86-64 platforms) and
+ supports Unicode</p>
</li>
<li>
<p>Version 1.2 - supports (at least) all of the
- features and platforms as 1.1, but is distributed and updated
- differently</p>
+ features and platforms as 1.1, but is distributed and updated
+ differently</p>
</li>
</ul>
</div>
@@ -2146,17 +2146,17 @@
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programlist=
ing">
$ cd ccl
$ cvs login # password is "cvs"
- # this step only needs to be done once,
- # that'll store the trivially encrypted
- # password in ~/.cvspas
+# this step only needs to be done once,
+# that'll store the trivially encrypted
+# password in ~/.cvspas
$ cvs update
- </pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Unless you tell it to,=
cvs won't delete ("prune") empty
directories or create new ones when the repository changes.
It's generally a good habit to use</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programlist=
ing">
$ cvs update -d -P # create dirs as needed, prune empty ones
- </pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Version 1.2 archives f=
ollow naming conventions that are
similar to those used by 1.0 (though more platforms are supported.)
However, rather than containing CVS working-copy information, the
@@ -2164,7 +2164,7 @@
by the Subversion (svn) source-code control system.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Subversion client prog=
rams are pre-installed on OSX 10.5 and
later and are typically either pre-installed or readily available
- on Linux and FreeBSD platforms. The <a href=3D"http://subversion.ti=
gris.org" target=3D"_top">Subversion web page</a> contains links to subvers=
ion client programs
+ on Linux and FreeBSD platforms. The <a class=3D"ulink" href=3D"http=
://subversion.tigris.org" target=3D"_top">Subversion web page</a> contains =
links to subversion client programs
for many platforms; users of OSX versions 10.4 and earlier can also
install Subversion clients via Fink or MacPorts.</p>
</div>
@@ -2181,38 +2181,38 @@
completely up to date.</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programlist=
ing">
? (ccl:rebuild-ccl :full t)
- </pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">That call to the funct=
ion <code class=3D"literal">rebuild-ccl</code>
- will perform the following steps:</p>
+ performs the following steps:</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"itemizedlis=
t">
<ul type=3D"disc">
<li>
<p>Deletes all fasl files and other object files in the
- <code class=3D"literal">ccl</code>directory tree</p>
+ <code class=3D"literal">ccl</code> directory tree</p>
</li>
<li>
- <p>Runs an external process which does a
- <code class=3D"literal">make</code> in the currentplatform's kernel
- build directory to create a new kernel</p>
+ <p>Runs an external process that does a
+ <code class=3D"literal">make</code> in the current platform's kernel
+ build directory to create a new kernel</p>
</li>
<li>
<p>Does <code class=3D"literal">(compile-ccl t)</code> in =
the running
- lisp, to produce aset of fasl files from the =C3=A2=C2=80=C2=9Chigher
- level=C3=A2=C2=80=C2=9D lisp sources.</p>
+ lisp, to produce a set of fasl files from the =C3=A2=C2=80=C2=9Chig=
her
+ level=C3=A2=C2=80=C2=9D lisp sources.</p>
</li>
<li>
<p>Does <code class=3D"literal">(xload-level-0 :force)</co=
de> in the
- running lisp, to compile thelisp sources in the
- =C3=A2=C2=80=C2=9Cccl:level-0;=C3=A2=C2=80=C2=9D directory into fasl fi=
les and
- then createa bootstrapping image from those fasl
- files.</p>
+ running lisp, to compile the lisp sources in the
+ =C3=A2=C2=80=C2=9Cccl:level-0;=C3=A2=C2=80=C2=9D directory into fas=
l files and
+ then create a bootstrapping image from those fasl
+ files.</p>
</li>
<li>
<p>Runs another external process, which causes the newly
- compiled lispkernel to load the new bootstrapping image.
- The bootsrtrapping image then loadsthe =C3=A2=C2=80=C2=9Chigher
- level=C3=A2=C2=80=C2=9D fasl files and a new copy of the platform's
- full heap imageis then saved.</p>
+ compiled lisp kernel to load the new bootstrapping image.
+ The bootsrtrapping image then loads the =C3=A2=C2=80=C2=9Chigher
+ level=C3=A2=C2=80=C2=9D fasl files and a new copy of the platform's
+ full heap image is then saved.</p>
</li>
</ul>
</div>
@@ -2234,15 +2234,17 @@
</div>
</div>
</div>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">The Lisp kernel is the=
executable which you run to use
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">The Lisp kernel is the=
executable that you run to use
Lisp. It doesn't actually contain the entire Lisp
implementation; rather, it loads a heap image which contains the
- specifics - the "library", as it might be called if this was a C
+ specifics=C3=A2=C2=80=C2=94the "library", as it might be called if t=
his was a C
program. The kernel also provides runtime support to the heap
image, such as garbage collection, memory allocation, exception
handling, and the OS interface.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The Lisp kernel file h=
as different names on different
- platforms. See FIXTHIS . On all platforms the lisp kernel sources re=
side
+ platforms. See
+ <a class=3D"xref" href=3D"#Platform-specific-filename-conventions" t=
itle=3D"Table=C3=82=C2=A03.1.=C3=82=C2=A0Platform-specific filename convent=
ions">Table=C3=82=C2=A03.1, =C3=A2=C2=80=C2=9CPlatform-specific filename co=
nventions=C3=A2=C2=80=C2=9D</a>. On all
+ platforms the lisp kernel sources reside
in <code class=3D"literal">ccl/lisp-kernel</code>.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">This section gives dir=
ections on how to rebuild the Lisp
kernel from its source code. Most Clozure CL users will rarely
@@ -2255,7 +2257,7 @@
? (rebuild-ccl :full t)
</pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- </p>
+ </p>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
@@ -2265,7 +2267,7 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The Clozure CL kerne=
l can be bult with the following widely
- available tools:</p>
+ available tools:</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"itemizedl=
ist">
<ul type=3D"disc">
<li>
@@ -2286,19 +2288,19 @@
</ul>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml"> In general, the mor=
e recent the versions of those
- tools, the better; some versions of gcc 3.x on Linux have
- difficulty compiling some of the kernel source code correctly
- (so gcc 4.0 should be used, if possible.) On OSX, the
- versions of the tools distributed with XCode should work fine;
- on Linux, the versions of the tools installed with the OS (or
- available through its package management system) should work
- fine if they're "recent enough". On FreeBSD, the installed
- version of the <code class=3D"literal">m4</code> program doesn't support
- some features that the kernel build process depends on; the
- GNU version of the m4 macroprocessor (called
- <code class=3D"literal">gm4</code> on FreeBSD) should be installed
+ tools, the better; some versions of gcc 3.x on Linux have
+ difficulty compiling some of the kernel source code correctly
+ (so gcc 4.0 should be used, if possible.) On OSX, the
+ versions of the tools distributed with XCode should work fine;
+ on Linux, the versions of the tools installed with the OS (or
+ available through its package management system) should work
+ fine if they're "recent enough". On FreeBSD, the installed
+ version of the <code class=3D"literal">m4</code> program doesn't supp=
ort
+ some features that the kernel build process depends on; the
+ GNU version of the m4 macroprocessor (called
+ <code class=3D"literal">gm4</code> on FreeBSD) should be installed.
=
- </p>
+ </p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -2313,13 +2315,13 @@
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programli=
sting">
shell> cd ccl/lisp-kernel/<em class=3D"replaceable"><code>PLATFORM</cod=
e></em>
shell> make
- </pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- </p>
+ </p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">That'll assemble sev=
eral assembly language source files,
compile several C source files, and link
../../<em class=3D"replaceable"><code>the kernel</code></em>.
- </p>
+ </p>
</div>
</div>
<div class=3D"sect1" lang=3D"en" xml:lang=3D"en">
@@ -2331,7 +2333,7 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The initial heap image=
is loaded by the Lisp kernel, and
- provides most all of the language implementation The heap image
+ provides most of the language implementation The heap image
captures the entire state of a running Lisp (except for external
resources, such as open files and TCP sockets). After it is
loaded, the contents of the new Lisp process's memory are
@@ -2346,7 +2348,7 @@
<p xmlns=3D"http://www.w3.org/1999/xhtml">If you're building a n=
ew version of Clozure CL, you need to
build a new heap image.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">(You might also wish t=
o build a heap image if you have a
- large program which it is very complicated or time-consuming to
+ large program that is very complicated or time-consuming to
load, so that you will be able to load it once, save an image,
and thenceforth never have to load it again. At any time, a heap
image capturing the entire memory state of a running Lisp can be
@@ -2366,44 +2368,44 @@
<ol type=3D"1">
<li>
<p>Using your existing Clozure CL, create a
- bootstrapping image</p>
+ bootstrapping image</p>
</li>
<li>
<p>Using your existing Clozure CL, recompile your
- updated Clozure CL sources</p>
+ updated Clozure CL sources</p>
</li>
<li>
<p>Invoke Clozure CL with the bootstrapping image
- you just created (rather than with the existing full heap
- image).</p>
+ you just created (rather than with the existing full heap
+ image).</p>
</li>
</ol>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">When you invoke Cloz=
ure CL with the bootstrapping image, it
- will start up, load al of the Clozure CL fasl files, and save out
- a new full heap image. Voila. You've created a new heap
- image.</p>
+ starts up, loads all of the Clozure CL fasl files, and saves out a
+ new full heap image. Voila. You've created a new heap
+ image.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A few points worth n=
oting:</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"itemizedl=
ist">
<ul type=3D"disc">
<li>
<p>There's a circular dependency between the full heap
- image and thebootstrapping image, in that each is used to
- build the other.</p>
+ image and the bootstrapping image, in that each is used to
+ build the other.</p>
</li>
<li>
<p>There are some minor implementation
- differences, but the environment in effect after the
- bootstrapping image has loaded its fasl files is essentially
- equivalent to the environment provided by the full heap
- image; the latter loads a lot faster and is easier to
- distribute, of course.</p>
+ differences, but the environment in effect after the
+ bootstrapping image has loaded its fasl files is essentially
+ equivalent to the environment provided by the full heap
+ image; the latter loads a lot faster and is easier to
+ distribute, of course.</p>
</li>
<li>
<p>If the full heap image doesn't work (because
- of an OScompatibilty problem or other bug), it's very likely
- that thebootstrapping image will suffer the same
- problems.</p>
+ of an OS compatibilty problem or other bug), it's very likely
+ that the bootstrapping image will suffer the same
+ problems.</p>
</li>
</ul>
</div>
@@ -2433,23 +2435,23 @@
it's done so, it saves a heap image via
<code class=3D"literal">save-application</code>. This process is c=
alled
"cross-dumping".</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">Given a source distr=
ibution, a lisp kernel, and aheap
- image, one can produce a bootstapping image by first invoking
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">Given a source distr=
ibution, a lisp kernel, and a heap
+ image, one can produce a bootstrapping image by first invoking
Clozure CL from the shell:</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programli=
sting">
shell> openmcl
Welcome to Clozure CL .... !
?
- </pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">then calling <code c=
lass=3D"literal">ccl:xload-level-0</code> at the
- lisp prompt</p>
+ lisp prompt</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programli=
sting">
? (ccl:xload-level-0)
- </pre>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">This will compile th=
e lisp sources in the ccl/level-0
+ </pre>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">This function compil=
es the lisp sources in the ccl/level-0
directory if they're newer than the corresponding fasl files
- and will then load the resulting fasl files into a simulated
- lisp heap contained inside data structures inside the running
+ and then loads the resulting fasl files into a simulated lisp
+ heap contained in data structures inside the running
lisp. That simulated heap image is then written to
disk.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml"><code class=3D"liter=
al">xload-level-0</code> should be called
@@ -2458,8 +2460,8 @@
:</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programli=
sting">
? (ccl:xload-level-0 :force)
-</pre>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">will force recompila=
tion of the level-0 sources.</p>
+ </pre>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">forces recompilation=
of the level-0 sources.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -2472,16 +2474,16 @@
<p xmlns=3D"http://www.w3.org/1999/xhtml"> Calling:</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programli=
sting">
? (ccl:compile-ccl)
- </pre>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">at the lisp prompt w=
ill compile any fasl files that are
- out-of-date with respect to the corresponding lisp sources;
- <code class=3D"literal">(ccl:compile-ccl t)</code> will force
- recompilation. <code class=3D"literal">ccl:compile-ccl</code> will reload
- newly-compiled versions of some files;
- <code class=3D"literal">ccl:xcompile-ccl</code> is analogous, but skips
- this reloading step.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">Unless there are boo=
tstrapping considerations involved,
- it usually doesn't matter whether these files reloaded after
+ </pre>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">at the lisp prompt c=
ompiles any fasl files that are
+ out-of-date with respect to the corresponding lisp sources;
+ <code class=3D"literal">(ccl:compile-ccl t)</code> forces
+ recompilation. <code class=3D"literal">ccl:compile-ccl</code> reloads
+ newly-compiled versions of some files;
+ <code class=3D"literal">ccl:xcompile-ccl</code> is analogous, but ski=
ps
+ this reloading step.</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">Unless there are boo=
tstrapping considerations involved, it
+ usually doesn't matter whether these files are reloaded after
they're recompiled.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Calling <code class=
=3D"literal">compile-ccl</code> or
<code class=3D"literal">xcompile-ccl</code> in an environment wher=
e fasl
@@ -2503,16 +2505,16 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">To build a full imag=
e from a bootstrapping image, just
- invoke the kernel with the bootstrapping image is an
- argument</p>
+ invoke the kernel with the bootstrapping image as an
+ argument</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programli=
sting">
$ cd ccl # wherever your ccl directory is
$ ./KERNEL BOOT_IMAGE
- </pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Where <em class=3D"r=
eplaceable"><code>KERNEL</code></em> and
<em class=3D"replaceable"><code>BOOT_IMAGE</code></em> are the nam=
es of
the kernel and boot image appropriate to the platform you are
- running on. See FIXTHIS</p>
+ running on. See <a class=3D"xref" href=3D"#Platform-specific-file=
name-conventions" title=3D"Table=C3=82=C2=A03.1.=C3=82=C2=A0Platform-specif=
ic filename conventions">Table=C3=82=C2=A03.1, =C3=A2=C2=80=C2=9CPlatform-s=
pecific filename conventions=C3=A2=C2=80=C2=9D</a></p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">That should load a f=
ew dozen fasl files (printing a
message as each file is loaded.) If all of these files
successfully load, the lisp will print a prompt. You should be
@@ -2522,9 +2524,10 @@
image.</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programli=
sting">
? (ccl:save-application "<em class=3D"replaceable"><code>image_name</code>=
</em>") ; Overwiting the existing heap image
- </pre>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">Where <em class=3D"r=
eplaceable"><code>image_name</code></em> is the name
- of the full heap image for your platform. See FIXTHIS.</p>
+ </pre>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">Where <em class=3D"r=
eplaceable"><code>image_name</code></em> is the name of
+ the full heap image for your platform. See
+ <a class=3D"xref" href=3D"#Platform-specific-filename-conventions"=
title=3D"Table=C3=82=C2=A03.1.=C3=82=C2=A0Platform-specific filename conve=
ntions">Table=C3=82=C2=A03.1, =C3=A2=C2=80=C2=9CPlatform-specific filename =
conventions=C3=A2=C2=80=C2=9D</a>.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If things go wrong i=
n the early stages of the loading
sequence, errors are often difficult to debug; until a fair
amount of code (CLOS, the CL condition system, streams, the
@@ -2540,7 +2543,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title"><a id=3D"id462094"></a>Chapter=C3=82=C2=
=A04.=C3=82=C2=A0Using Clozure CL</h2>
+ <h2 class=3D"title"><a id=3D"id322946"></a>Chapter=C3=82=C2=
=A04.=C3=82=C2=A0Using Clozure CL</h2>
</div>
</div>
</div>
@@ -2548,7 +2551,7 @@
<dl>
<dt>
<span class=3D"sect1">
- <a href=3D"#id482055">4.1. Introduction</a>
+ <a href=3D"#id370264">4.1. Introduction</a>
</span>
</dt>
<dt>
@@ -2565,7 +2568,7 @@
<dl>
<dt>
<span class=3D"sect2">
- <a href=3D"#id496233">4.3.1. Characters</a>
+ <a href=3D"#id388381">4.3.1. Characters</a>
</span>
</dt>
<dt>
@@ -2594,7 +2597,7 @@
<dl>
<dt>
<span class=3D"sect2">
- <a href=3D"#id497617">4.4.1. Pathname Expansion</a>
+ <a href=3D"#id383711">4.4.1. Pathname Expansion</a>
</span>
</dt>
<dt>
@@ -2604,17 +2607,17 @@
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id497696">4.4.3. OS X (Darwin)</a>
+ <a href=3D"#id383814">4.4.3. OS X (Darwin)</a>
</span>
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id497707">4.4.4. Linux</a>
+ <a href=3D"#id383826">4.4.4. Linux</a>
</span>
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id497718">4.4.5. FreeBSD</a>
+ <a href=3D"#id383838">4.4.5. FreeBSD</a>
</span>
</dt>
</dl>
@@ -2640,7 +2643,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title" style=3D"clear: both"><a id=3D"id48205=
5"></a>4.1.=C3=82=C2=A0Introduction</h2>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"id37026=
4"></a>4.1.=C3=82=C2=A0Introduction</h2>
</div>
</div>
</div>
@@ -2668,8 +2671,8 @@
over tracing actions.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id460839" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"trace=
"></a>TRACE</em> {<em class=3D"replaceable"><code>keyword</code></em>
+ <a id=3D"id358756" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"trace=
"></a>TRACE</em> {<em class=3D"replaceable"><code>keyword</code></em>
<em class=3D"replaceable"><code>global-value</code></em>}* {<em cl=
ass=3D"replaceable"><code>spec</code></em> |
(<em class=3D"replaceable"><code>spec</code></em> {<em class=3D"re=
placeable"><code>keyword</code></em>
<em class=3D"replaceable"><code>local-value</code></em>}*)}* [Macr=
o]</strong></span>
@@ -3112,42 +3115,42 @@
</dl>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id438298" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"trace=
-level"></a>CCL:*TRACE-LEVEL*</em> [Variable]</strong></span>
+ <a id=3D"id388151" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"trace=
-level"></a>CCL:*TRACE-LEVEL*</em> [Variable]</strong></span>
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Variable bound to the =
current nesting level during execution of before and after trace actions. =
The default printing actions use it to determine the amount of indentation.=
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id425701" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"trace=
-max-indent"></a>CCL:*TRACE-MAX-INDENT*</em> [Variable]</strong></span>
+ <a id=3D"id388178" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"trace=
-max-indent"></a>CCL:*TRACE-MAX-INDENT*</em> [Variable]</strong></span>
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The default before and=
after print actions will not indent by more than the value of <em class=3D=
"varname">ccl:*trace-max-indent*</em> regardless of the current trace level=
.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id496099" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"trace=
-function"></a>CCL:TRACE-FUNCTION</em> <em class=3D"replaceable"><code>spec=
</code></em> <em class=3D"varname">&key</em> {<em class=3D"replaceable"=
><code>keyword</code></em> <em class=3D"replaceable"><code>value</code></em=
>}* [Function]</strong></span>
+ <a id=3D"id388207" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"trace=
-function"></a>CCL:TRACE-FUNCTION</em> <em class=3D"replaceable"><code>spec=
</code></em> <em class=3D"varname">&key</em> {<em class=3D"replaceable"=
><code>keyword</code></em> <em class=3D"replaceable"><code>value</code></em=
>}* [Function]</strong></span>
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
This is a functional version of the TRACE macro. <em class=3D"repla=
ceable"><code>spec</code></em> and
<em class=3D"replaceable"><code>keyword</code></em>s are as for TRAC=
E, except that all arguments are evaluated.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id496137" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"trace=
-print-level"></a>CCL:*TRACE-PRINT-LEVEL*</em> [Variable]</strong></span>
+ <a id=3D"id388256" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"trace=
-print-level"></a>CCL:*TRACE-PRINT-LEVEL*</em> [Variable]</strong></span>
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The default print acti=
ons bind <em class=3D"varname">CL:*PRINT-LEVEL*</em> to this value while
printing. Note that this rebinding is only in effect during the defa=
ult entry and exit messages.
It does not apply to printing of <em class=3D"varname">:print-before=
/:print-after</em> forms or any
explicit printing done by user code.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id496163" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"trace=
-print-length"></a>CCL:*TRACE-PRINT-LENGTH*</em> [Variable]</strong></sp=
an>
+ <a id=3D"id388290" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"trace=
-print-length"></a>CCL:*TRACE-PRINT-LENGTH*</em> [Variable]</strong></sp=
an>
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The default print acti=
ons bind <em class=3D"varname">CL:*PRINT-LENGTH*</em> to this value while
printing. Note that this rebinding is only in effect during the defa=
ult entry and exit messages.
It does not apply to printing of <em class=3D"varname">:print-before=
/:print-after</em> forms or any
explicit printing done by user code.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id496190" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"trace=
-bar-frequency"></a>CCL:*TRACE-BAR-FREQUENCY*</em> [Variable]</strong></=
span>
+ <a id=3D"id388325" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"trace=
-bar-frequency"></a>CCL:*TRACE-BAR-FREQUENCY*</em> [Variable]</strong></=
span>
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">By default, this is ni=
l. If non-nil it should be a integer,
and the default entry and exit messages will print a | instead of
@@ -3165,14 +3168,14 @@
using UTF-32. There is only one <code class=3D"literal">CHARACTER</cod=
e> type
and one <code class=3D"literal">STRING</code> type in Clozure CL. The=
re has been a
lot of discussion about this decision which can be found by
- searching the openmcl-devel archives at <a href=3D"http://clozure.com/=
pipermail/openmcl-devel/" target=3D"_top">http://clozure.com/pipermail/open=
mcl-devel/</a>. Suffice it
+ searching the openmcl-devel archives at <a class=3D"ulink" href=3D"htt=
p://clozure.com/pipermail/openmcl-devel/" target=3D"_top">http://clozure.co=
m/pipermail/openmcl-devel/</a>. Suffice it
to say that we decided that the simplicity and speed advantages of
only supporting UTF-32 outweigh the space disadvantage.</p>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id496233"></a>4.3.1.=C3=82=
=C2=A0Characters</h3>
+ <h3 class=3D"title"><a id=3D"id388381"></a>4.3.1.=C3=82=
=C2=A0Characters</h3>
</div>
</div>
</div>
@@ -3182,7 +3185,7 @@
is now <code class=3D"literal">#x110000</code>, which means that all U=
nicode
characters can be directly represented. As of Unicode 5.0, only
about 100,000 of 1,114,112 possible <code class=3D"literal">CHAR-CODE<=
/code>s
- are actually defined. The function <span><strong class=3D"function">CO=
DE-CHAR</strong></span>
+ are actually defined. The function <span class=3D"function"><strong>CO=
DE-CHAR</strong></span>
knows that certain ranges of code values (notably
<code class=3D"literal">#xd800</code>-<code class=3D"literal">#xddff</=
code>) will never be
valid character codes and will return <code class=3D"literal">NIL</cod=
e> for
@@ -3191,7 +3194,7 @@
<code class=3D"literal">CHARACTER</code> object) for other unassigned =
code
values.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL supports =
character names of the form
- <code class=3D"literal">u+xxxx</code> - where <code class=3D"literal">=
x</code> is a
+ <code class=3D"literal">u+xxxx</code>=C3=A2=C2=80=C2=94where <code cla=
ss=3D"literal">x</code> is a
sequence of one or more hex digits. The value of the hex digits
denotes the code of the character. The <code class=3D"literal">+</cod=
e>
character is optional, so <code class=3D"literal">#\u+0020</code>,
@@ -3202,12 +3205,11 @@
symbolic names These are the names from the Unicode standard with
spaces replaced by underscores. So
<code class=3D"literal">#\Greek_Capital_Letter_Epsilon</code> can be u=
sed to
- refer to the character whose <span><strong class=3D"function">CHAR-COD=
E</strong></span> is
+ refer to the character whose <span class=3D"function"><strong>CHAR-COD=
E</strong></span> is
<code class=3D"literal">#x395</code>. To see the complete list of sup=
ported
character names, look just below the definition for
- <span><strong class=3D"function">register-character-name</strong></spa=
n> in
- <code class=3D"literal">ccl:level-1;l1-reader.lisp</code> see the comp=
lete
- list of char</p>
+ <span class=3D"function"><strong>register-character-name</strong></spa=
n> in
+ <code class=3D"literal">ccl:level-1;l1-reader.lisp</code>.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -3217,15 +3219,15 @@
</div>
</div>
</div>
- <p xmlns=3D"http://www.w3.org/1999/xhtml"><span><strong class=
=3D"function">OPEN</strong></span>, <span><strong class=3D"function">LOAD</=
strong></span>, and
- <span><strong class=3D"function">COMPILE-FILE</strong></span> all take=
an
+ <p xmlns=3D"http://www.w3.org/1999/xhtml"><span class=3D"funct=
ion"><strong>OPEN</strong></span>, <span class=3D"function"><strong>LOAD</s=
trong></span>, and
+ <span class=3D"function"><strong>COMPILE-FILE</strong></span> all take=
an
<code class=3D"literal">:EXTERNAL-FORMAT</code> keyword argument. The=
value
of <code class=3D"literal">:EXTERNAL-FORMAT</code> can be
<code class=3D"literal">:DEFAULT</code> (the default value), a line
- termination keyword (see <a href=3D"#Line-Termination-Keywords" title=
=3D"4.3.3.=C3=82=C2=A0Line Termination Keywords">Section=C3=82=C2=A04.3.3, =
=C3=A2=C2=80=C2=9CLine Termination Keywords=C3=A2=C2=80=C2=9D</a>), a chara=
cter encoding
- keyword (see <a href=3D"#Character-Encodings" title=3D"4.3.4.=C3=82=C2=
=A0Character Encodings">Section=C3=82=C2=A04.3.4, =C3=A2=C2=80=C2=9CCharact=
er Encodings=C3=A2=C2=80=C2=9D</a>), an
+ termination keyword (see <a class=3D"xref" href=3D"#Line-Termination-K=
eywords" title=3D"4.3.3.=C3=82=C2=A0Line Termination Keywords">Section=C3=
=82=C2=A04.3.3, =C3=A2=C2=80=C2=9CLine Termination Keywords=C3=A2=C2=80=C2=
=9D</a>), a character encoding
+ keyword (see <a class=3D"xref" href=3D"#Character-Encodings" title=3D"=
4.3.4.=C3=82=C2=A0Character Encodings">Section=C3=82=C2=A04.3.4, =C3=A2=C2=
=80=C2=9CCharacter Encodings=C3=A2=C2=80=C2=9D</a>), an
external-format object created using
- <span><strong class=3D"function">CCL::MAKE-EXTERNAL-FORMAT</strong></s=
pan>(see <a href=3D"#f_make-external-format" title=3D"Function MAKE-EXTERNA=
L-FORMAT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-extern=
al-format</b></a>), or a plist with keys:
+ <span class=3D"function"><strong>CCL::MAKE-EXTERNAL-FORMAT</strong></s=
pan> (see <a class=3D"xref" href=3D"#f_make-external-format" title=3D"Funct=
ion MAKE-EXTERNAL-FORMAT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitio=
nal">make-external-format</b></a>), or a plist with keys:
<code class=3D"literal">:DOMAIN</code>, <code class=3D"literal">:CHARA=
CTER-ENCODING</code>
and <code class=3D"literal">:LINE-TERMINATION</code>. If
<em class=3D"parameter"><code>argument</code></em> is a plist, the res=
ult of
@@ -3250,16 +3252,16 @@
never both.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">EXTERNAL-FORMATs are=
objects (structures) with three
read-only fields that can be accessed via the functions:
- <span><strong class=3D"function">EXTERNAL-FORMAT-DOMAIN</strong></span=
>,
- <span><strong class=3D"function">EXTERNAL-FORMAT-LINE-TERMINATION</str=
ong></span> and
- <span><strong class=3D"function">EXTERNAL-FORMAT-CHARACTER-ENCODING</s=
trong></span>.</p>
+ <span class=3D"function"><strong>EXTERNAL-FORMAT-DOMAIN</strong></span=
>,
+ <span class=3D"function"><strong>EXTERNAL-FORMAT-LINE-TERMINATION</str=
ong></span> and
+ <span class=3D"function"><strong>EXTERNAL-FORMAT-CHARACTER-ENCODING</s=
trong></span>.</p>
<p>
<div class=3D"refentrytitle">
<a id=3D"f_make-external-format"></a>
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"function"=
>make-external-format</strong></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><strong=
>make-external-format</strong></span>
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&key</=
em> domain character-encoding line-termination
=3D> external-format
</code>
@@ -3271,7 +3273,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id496501=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id382341=
"></a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">domain</span></i>---This is used to indicate where the external
format is to be used. Its value can be almost
@@ -3285,7 +3287,7 @@
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"parameter"><cod=
e>character-encoding</code></em> and
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"parameter"><cod=
e>line-termination</code></em>.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">character-encoding</span></i>---A keyword that specifies the char=
acter encoding
- for the external format. <a xmlns=3D"http://www.w3.org/1999/xhtml" =
href=3D"#Character-Encodings" title=3D"4.3.4.=C3=82=C2=A0Character Encoding=
s">Section=C3=82=C2=A04.3.4, =C3=A2=C2=80=C2=9CCharacter Encodings=C3=A2=C2=
=80=C2=9D</a>. Defaults to
+ for the external format. <a xmlns=3D"http://www.w3.org/1999/xhtml" =
class=3D"xref" href=3D"#Character-Encodings" title=3D"4.3.4.=C3=82=C2=A0Cha=
racter Encodings">Section=C3=82=C2=A04.3.4, =C3=A2=C2=80=C2=9CCharacter Enc=
odings=C3=A2=C2=80=C2=9D</a>. Defaults to
<code xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"literal">:DEF=
AULT</code> which means if
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"parameter"><cod=
e>domain</code></em> is
<code xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"literal">:FIL=
E</code> use the value of the variable
@@ -3298,19 +3300,19 @@
<code xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"literal">NIL<=
/code>, which means the
<code xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"literal">:ISO=
-8859-1</code> encoding.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">line-termination</span></i>---A keyword that indicates a line ter=
mination
- keyword <a xmlns=3D"http://www.w3.org/1999/xhtml" href=3D"#Line-Ter=
mination-Keywords" title=3D"4.3.3.=C3=82=C2=A0Line Termination Keywords">Se=
ction=C3=82=C2=A04.3.3, =C3=A2=C2=80=C2=9CLine Termination Keywords=C3=A2=
=C2=80=C2=9D</a>.
+ keyword <a xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"xref" hr=
ef=3D"#Line-Termination-Keywords" title=3D"4.3.3.=C3=82=C2=A0Line Terminati=
on Keywords">Section=C3=82=C2=A04.3.3, =C3=A2=C2=80=C2=9CLine Termination K=
eywords=C3=A2=C2=80=C2=9D</a>.
Defaults to <code xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"l=
iteral">:DEFAULT</code> which means
use the value of the variable
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">CCL:*D=
EFAULT-LINE-TERMINATION*</em>.</p>
- <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">[result]</span></i>---[description]</p>
+ <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">external-format</span></i>---An external-format object as describ=
ed above.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id496634=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id382520=
"></a>
<div class=3D"header">Description:</div>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">Despite the fu=
nction's name, it doesn't necessarily
- create a new, unique EXTERNAL-FORMAT object: two calls to
- MAKE-EXTERNAL-FORMAT with the same arguments made in the
- same dynamic environment will return the same (eq) object.
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">Despite the fu=
nction's name, it doesn't necessarily create a
+ new, unique EXTERNAL-FORMAT object: two calls to
+ MAKE-EXTERNAL-FORMAT with the same arguments made in the same
+ dynamic environment return the same (eq) object.
</p>
</div>
</div>
@@ -3454,7 +3456,7 @@
Standardization, widely known as ISO, defines many of these
character encodings. Clozure CL implements some of these encodings as
detailed below. These encodings are part of the specification of
- external formats <a href=3D"#External-Formats" title=3D"4.3.2.=C3=82=
=C2=A0External Formats">Section=C3=82=C2=A04.3.2, =C3=A2=C2=80=C2=9CExterna=
l Formats=C3=A2=C2=80=C2=9D</a>. When reading
+ external formats <a class=3D"xref" href=3D"#External-Formats" title=3D=
"4.3.2.=C3=82=C2=A0External Formats">Section=C3=82=C2=A04.3.2, =C3=A2=C2=80=
=C2=9CExternal Formats=C3=A2=C2=80=C2=9D</a>. When reading
from a stream, characters are converted from the specified
external character encoding to UTF-32. When writing to a stream,
characters are converted from UTF-32 to the specified character
@@ -3473,15 +3475,15 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id496886"></a>4.3.4.1.=C3=
=82=C2=A0Encoding Problems</h4>
+ <h4 class=3D"title"><a id=3D"id382864"></a>4.3.4.1.=C3=
=82=C2=A0Encoding Problems</h4>
</div>
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On output to strea=
ms with character encodings that can
- encode the full range of Unicode - and on input from any stream
- - "unencodable characters" are represented using the Unicode
- #\Replacement_Character (=3D #\U+fffd); the presence of such a
- character usually indicates that something got lost in
+ encode the full range of Unicode=C3=A2=C2=80=C2=94and on input from =
any
+ stream=C3=A2=C2=80=C2=94"unencodable characters" are represented usi=
ng the
+ Unicode #\Replacement_Character (=3D #\U+fffd); the presence of
+ such a character usually indicates that something got lost in
translation. Either data wasn't encoded properly or there was a
bug in the decoding process.</p>
</div>
@@ -3489,7 +3491,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id496902"></a>4.3.4.2.=C3=
=82=C2=A0Byte Order Marks</h4>
+ <h4 class=3D"title"><a id=3D"id382877"></a>4.3.4.2.=C3=
=82=C2=A0Byte Order Marks</h4>
</div>
</div>
</div>
@@ -3502,35 +3504,35 @@
endianness of a multi-byte character encoding. (It may also be
used with UTF-8 character encodings, where it is simply used to
indicate that the encoding is UTF-8.)</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL will wr=
ite a byte order mark as the first
- character of a file or socket stream when the endianness of the
- character encoding is not explicit. Clozure CL also expects a
- byte order mark on input from streams where the endianness is
- not explicit. If a byte order mark is missing from input data,
- that data is assumed to be in big-endian order.</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL writes =
a byte order mark as the first character
+ of a file or socket stream when the endianness of the character
+ encoding is not explicit. Clozure CL also expects a byte order
+ mark on input from streams where the endianness is not
+ explicit. If a byte order mark is missing from input data, that
+ data is assumed to be in big-endian order.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A byte order mark =
from a UTF-8 encoded input stream is not
- treated specially and and will just appear as normal character
- from the input stream. It is probably a good idea to skip over
- this character.</p>
+ treated specially and just appears as a normal character from
+ the input stream. It is probably a good idea to skip over this
+ character.</p>
</div>
<div class=3D"sect3" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id496941"></a>4.3.4.3.=C3=
=82=C2=A0<span><strong class=3D"function">DESCRIBE-CHARACTER-ENCODINGS</str=
ong></span></h4>
+ <h4 class=3D"title"><a id=3D"id382915"></a>4.3.4.3.=C3=
=82=C2=A0<span class=3D"function"><strong>DESCRIBE-CHARACTER-ENCODINGS</str=
ong></span></h4>
</div>
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The set of charact=
er encodings supported by Clozure CL can be
retrieved by calling
- <span><strong class=3D"function">CCL:DESCRIBE-CHARACTER-ENCODINGS</str=
ong></span>.</p>
+ <span class=3D"function"><strong>CCL:DESCRIBE-CHARACTER-ENCODINGS</str=
ong></span>.</p>
<p>
<div class=3D"refentrytitle">
<a id=3D"f_describe-character-encodings"></a>
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"functio=
n">describe-character-encodings</strong></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><stro=
ng>describe-character-encodings</strong></span>
</code>
</div>
<div class=3D"refentrytitle">Writes descriptions of define=
d character
@@ -3539,7 +3541,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id4969=
92"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id3829=
86"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Writes descr=
iptions of all defined character encodings
to <em class=3D"varname">*terminal-io*</em>. These descriptions
@@ -3548,9 +3550,9 @@
intended use.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id4970=
09"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id3830=
03"></a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
simplelist"><a href=3D"#Character-Encodings" title=3D"4.3.4.=C3=82=C2=A0Cha=
racter Encodings">Section=C3=82=C2=A04.3.4, =C3=A2=C2=80=C2=9CCharacter Enc=
odings=C3=A2=C2=80=C2=9D</a>, <a href=3D"#External-Formats" title=3D"4.3.2.=
=C3=82=C2=A0External Formats">Section=C3=82=C2=A04.3.2, =C3=A2=C2=80=C2=9CE=
xternal Formats=C3=A2=C2=80=C2=9D</a>, <a href=3D"#Supported-Character-Enco=
dings" title=3D"4.3.4.4.=C3=82=C2=A0Supported Character Encodings">Section=
=C3=82=C2=A04.3.4.4, =C3=A2=C2=80=C2=9CSupported Character Encodings=C3=A2=
=C2=80=C2=9D</a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
simplelist"><a class=3D"xref" href=3D"#Character-Encodings" title=3D"4.3.4.=
=C3=82=C2=A0Character Encodings">Section=C3=82=C2=A04.3.4, =C3=A2=C2=80=C2=
=9CCharacter Encodings=C3=A2=C2=80=C2=9D</a>, <a class=3D"xref" href=3D"#Ex=
ternal-Formats" title=3D"4.3.2.=C3=82=C2=A0External Formats">Section=C3=82=
=C2=A04.3.2, =C3=A2=C2=80=C2=9CExternal Formats=C3=A2=C2=80=C2=9D</a>, <a c=
lass=3D"xref" href=3D"#Supported-Character-Encodings" title=3D"4.3.4.4.=C3=
=82=C2=A0Supported Character Encodings">Section=C3=82=C2=A04.3.4.4, =C3=A2=
=C2=80=C2=9CSupported Character Encodings=C3=A2=C2=80=C2=9D</a></span>
</div>
</div>
</p>
@@ -3586,7 +3588,7 @@
<em class=3D"varname">*TERMINAL-IO*</em> and for all streams whose
EXTERNAL-FORMAT isn't explicitly specified. The default for
<em class=3D"varname">*TERMINAL-IO*</em> can be set via the
- <code class=3D"literal">-K</code> command-line argument (see <a hre=
f=3D"#Command-Line-Options" title=3D"2.5.=C3=82=C2=A0Command Line Options">=
Section=C3=82=C2=A02.5, =C3=A2=C2=80=C2=9CCommand Line Options=C3=A2=C2=80=
=C2=9D</a>).
+ <code class=3D"literal">-K</code> command-line argument (see <a cla=
ss=3D"xref" href=3D"#Command-Line-Options" title=3D"2.5.=C3=82=C2=A0Command=
Line Options">Section=C3=82=C2=A02.5, =C3=A2=C2=80=C2=9CCommand Line Optio=
ns=C3=A2=C2=80=C2=9D</a>).
</p>
<p>ISO-8859-1 just covers the first 256 Unicode code
points, where the first 128 code points are equivalent to
@@ -3965,7 +3967,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id497617"></a>4.4.1.=C3=82=
=C2=A0Pathname Expansion</h3>
+ <h3 class=3D"title"><a id=3D"id383711"></a>4.4.1.=C3=82=
=C2=A0Pathname Expansion</h3>
</div>
</div>
</div>
@@ -3985,7 +3987,7 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL sets up l=
ogical pathname translations for logical hosts: <code class=3D"literal">cc=
l</code> and <code class=3D"literal">home</code></p>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id497658" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383764" clas=
s=3D"indexterm"></a>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The <code class=3D"l=
iteral">CCL</code> logical host should point to the
<code class=3D"literal">ccl</code> directory. It is used for a va=
riety of
purposes by Clozure CL including: locating Clozure CL source code,
@@ -3993,7 +3995,7 @@
foreign function information, and the Clozure CL build process. It
is set to the value of the environment variable
<em class=3D"varname">CCL_DEFAULT_DIRECTORY</em>, which is set by =
the
- openmcl shell script <a href=3D"#The-ccl-Shell-Script" title=3D"2.=
3.1.=C3=82=C2=A0The ccl Shell Script">Section=C3=82=C2=A02.3.1, =C3=A2=C2=
=80=C2=9CThe ccl Shell Script=C3=A2=C2=80=C2=9D</a>. If
+ openmcl shell script <a class=3D"xref" href=3D"#The-ccl-Shell-Scri=
pt" title=3D"2.3.1.=C3=82=C2=A0The ccl Shell Script">Section=C3=82=C2=A02.3=
.1, =C3=A2=C2=80=C2=9CThe ccl Shell Script=C3=A2=C2=80=C2=9D</a>. If
<em class=3D"varname">CCL_DEFAULT_DIRECTORY</em> is not set, then =
it is set
to the directory containing the current heap image.</p>
</div>
@@ -4001,7 +4003,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id497696"></a>4.4.3.=C3=82=
=C2=A0OS X (Darwin)</h3>
+ <h3 class=3D"title"><a id=3D"id383814"></a>4.4.3.=C3=82=
=C2=A0OS X (Darwin)</h3>
</div>
</div>
</div>
@@ -4011,7 +4013,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id497707"></a>4.4.4.=C3=82=
=C2=A0Linux</h3>
+ <h3 class=3D"title"><a id=3D"id383826"></a>4.4.4.=C3=82=
=C2=A0Linux</h3>
</div>
</div>
</div>
@@ -4022,7 +4024,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id497718"></a>4.4.5.=C3=82=
=C2=A0FreeBSD</h3>
+ <h3 class=3D"title"><a id=3D"id383838"></a>4.4.5.=C3=82=
=C2=A0FreeBSD</h3>
</div>
</div>
</div>
@@ -4040,7 +4042,7 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In release 1.2 and lat=
er, Clozure CL
- supports <a href=3D"#memory_mapped_file"><em class=3D"glossterm">mem=
ory-mapped
+ supports <a class=3D"glossterm" href=3D"#memory_mapped_file"><em cla=
ss=3D"glossterm">memory-mapped
files</em></a>. On operating systems that support memory-mapped
files (including Mac OS X, Linux, and FreeBSD), the operating
system can arrange for a range of virtual memory addresses to
@@ -4087,8 +4089,8 @@
on 32-but platforms; and <em class=3D"varname">(EXPT 2 56)</em> on 6=
4-bit
platforms.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id497839" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"map-f=
ile-to-ivector"></a>CCL:MAP-FILE-TO-IVECTOR</em>
+ <a id=3D"id383954" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"map-f=
ile-to-ivector"></a>CCL:MAP-FILE-TO-IVECTOR</em>
<em class=3D"parameter"><code>pathname</code></em>
<em class=3D"parameter"><code>element-type</code></em>
[Function]</strong></span>
@@ -4111,7 +4113,7 @@
<dd>
<p>The element-type of the vector to be
created. Specified as
- a <a href=3D"#type-specifier"><em class=3D"glossterm">type-spe=
cifier</em></a>
+ a <a class=3D"glossterm" href=3D"#type-specifier"><em class=3D=
"glossterm">type-specifier</em></a>
that names a subtype of either <em class=3D"varname">SIGNED-BY=
TE</em>
or <em class=3D"varname">UNSIGNED-BYTE</em>.</p>
</dd>
@@ -4127,7 +4129,7 @@
the contents of the memory-mapped file.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The returned vector is
- a <a href=3D"#displaced-array"><em class=3D"glossterm">displaced-arr=
ay</em></a>
+ a <a class=3D"glossterm" href=3D"#displaced-array"><em class=3D"glos=
sterm">displaced-array</em></a>
whose element-type is <em class=3D"varname">(UPGRADED-ARRAY-ELEMENT-=
TYPE
element-type)</em>. The target of the displaced array is a
vector of type <em class=3D"varname">(SIMPLE-ARRAY element-type (*))=
</em> whose
@@ -4147,8 +4149,8 @@
returned by <em class=3D"varname">map-file-to-ivector</em>, Clozure =
CL signals
a memory error.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id497966" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"unmap=
-ivector"></a>CCL:UNMAP-IVECTOR</em>
+ <a id=3D"id405599" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"unmap=
-ivector"></a>CCL:UNMAP-IVECTOR</em>
<em class=3D"parameter"><code>displaced-array</code></em>
[Function]</strong></span>
</p>
@@ -4159,8 +4161,8 @@
closes the mapped file, and changes the displaced-array so that its
target is an empty vector (of length zero).</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id497997" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"map-f=
ile-to-octet-vector"></a>CCL:MAP-FILE-TO-OCTET-VECTOR</em>
+ <a id=3D"id405634" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"map-f=
ile-to-octet-vector"></a>CCL:MAP-FILE-TO-OCTET-VECTOR</em>
<em class=3D"parameter"><code>pathname</code></em>
[Function]</strong></span>
</p>
@@ -4169,8 +4171,8 @@
for the common case of memory-mapping a file as a vector of
bytes.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id498022" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"unmap=
-octet-vector"></a>CCL:UNMAP-OCTET-VECTOR</em>
+ <a id=3D"id405666" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"unmap=
-octet-vector"></a>CCL:UNMAP-OCTET-VECTOR</em>
<em class=3D"parameter"><code>displaced-array</code></em>
[Function]</strong></span>
</p>
@@ -4186,7 +4188,7 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL supports th=
e definition
- of <a href=3D"#static_variable"><em class=3D"glossterm">static
+ of <a class=3D"glossterm" href=3D"#static_variable"><em class=3D"glo=
ssterm">static
variables</em></a>, whose values are the same across threads,
and which may not be dynamically bound. The value of a static
variable is thus the same across all threads; changing the value
@@ -4208,8 +4210,8 @@
access to a special variable that has not been declared
static.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id498089" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"defst=
atic"></a>DEFSTATIC</em>
+ <a id=3D"id405741" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"defst=
atic"></a>DEFSTATIC</em>
<em class=3D"parameter"><code>var</code></em>
<em class=3D"parameter"><code>value</code></em>
<em class=3D"varname">&key</em>
@@ -4246,7 +4248,7 @@
</dl>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Proclaims the
- variable <a href=3D"#special_variable"><em class=3D"glossterm">speci=
al</em></a>,
+ variable <a class=3D"glossterm" href=3D"#special_variable"><em class=
=3D"glossterm">special</em></a>,
assigns the variable the supplied value, and assigns
the <em class=3D"varname">doc-string</em> to the
variable's <em class=3D"varname">VARIABLE</em> documentation. Marks =
the
@@ -4262,14 +4264,14 @@
</div>
</div>
</div>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id498190" class=
=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id405853" class=
=3D"indexterm"></a>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL provides the
function <code class=3D"literal">CCL:SAVE-APPLICATION</code>, which =
creates a file
containing an archived Lisp memory image.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL consists of=
a small executable called the
- Lisp <a href=3D"#lisp_image"><em class=3D"glossterm">kernel</em></a>=
, which
+ Lisp <a class=3D"glossterm" href=3D"#lisp_image"><em class=3D"glosst=
erm">kernel</em></a>, which
implements the very lowest level features of the Lisp system, and
- an <a href=3D"#lisp_image"><em class=3D"glossterm">image</em></a>, w=
hich
+ an <a class=3D"glossterm" href=3D"#lisp_image"><em class=3D"glosster=
m">image</em></a>, which
contains the in-memory representation of most of the Lisp system,
including functions, data structures, variables, and so on. When
you start Clozure CL, you are launching the kernel, which then locat=
es
@@ -4288,7 +4290,7 @@
want, then use <code class=3D"literal">CCL:SAVE-APPLICATION</code> t=
o preserve your
changes and later load them for use.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In fact, you can go fu=
rther than that. You can replace
- Clozure CL's <a href=3D"#toplevel_function"><em class=3D"glossterm">=
toplevel
+ Clozure CL's <a class=3D"glossterm" href=3D"#toplevel_function"><em =
class=3D"glossterm">toplevel
function</em></a> with your own, and then, when the image is
loaded, the Lisp system immediately performs your tasks rather
than the default tasks that make it a Lisp development system. If
@@ -4309,9 +4311,9 @@
using <code class=3D"literal">CCL:SAVE-APPLICATION</code> to preserv=
e your changes
in an executable image.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On Mac OS X,
- the <a href=3D"#application_builder">application builder</a>
+ the <a class=3D"link" href=3D"#application_builder">application buil=
der</a>
uses <code class=3D"literal">CCL:SAVE-APPLICATION</code> to create t=
he executable
- portion of the <a href=3D"#application_bundle"><em class=3D"glosster=
m">application
+ portion of the <a class=3D"glossterm" href=3D"#application_bundle"><=
em class=3D"glossterm">application
bundle</em></a>. Double-clicking the application bundle runs
the executable image created
by <code class=3D"literal">CCL:SAVE-APPLICATION</code>.</p>
@@ -4342,7 +4344,7 @@
a <code class=3D"literal">MACPTR</code> object that points to the ad=
dress 0 is not
converted, because address 0 can always be relied upon to refer to
the same thing.</p>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id498382" class=
=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id406074" class=
=3D"indexterm"></a>
<p xmlns=3D"http://www.w3.org/1999/xhtml">As of Clozure CL 1.2, =
the constant <code class=3D"literal">CCL:+NULL-PTR+</code>
refers to a <code class=3D"literal">MACPTR</code> object that points=
to address 0.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On all supported platf=
orms, you can
@@ -4353,8 +4355,8 @@
command-line parameter to the <code class=3D"literal">opencml</code>
or <code class=3D"literal">opencml64</code> script.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id498419" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"save-=
application"></a>SAVE-APPLICATION</em>
+ <a id=3D"id406122" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"save-=
application"></a>SAVE-APPLICATION</em>
<em class=3D"parameter"><code>filename</code></em>
<em class=3D"varname">&key</em>
<em class=3D"parameter"><code>toplevel-function</code></em>
@@ -4391,7 +4393,7 @@
when launched with this image.</p>
<p>If this parameter is not supplied, Clozure CL uses its
default toplevel. The default toplevel runs
- the <a href=3D"#REPL"><em class=3D"glossterm">read-eval-print
+ the <a class=3D"glossterm" href=3D"#REPL"><em class=3D"glosste=
rm">read-eval-print
loop</em></a>.</p>
</dd>
<dt>
@@ -4457,7 +4459,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title"><a id=3D"id471096"></a>Chapter=C3=82=C2=
=A05.=C3=82=C2=A0The Clozure CL IDE</h2>
+ <h2 class=3D"title"><a id=3D"id351866"></a>Chapter=C3=82=C2=
=A05.=C3=82=C2=A0The Clozure CL IDE</h2>
</div>
</div>
</div>
@@ -4465,56 +4467,56 @@
<dl>
<dt>
<span class=3D"sect1">
- <a href=3D"#id447378">5.1. Introduction</a>
+ <a href=3D"#id391992">5.1. Introduction</a>
</span>
</dt>
<dt>
<span class=3D"sect1">
- <a href=3D"#id461540">5.2. Building the IDE</a>
+ <a href=3D"#id388704">5.2. Building the IDE</a>
</span>
</dt>
<dt>
<span class=3D"sect1">
- <a href=3D"#id460360">5.3. Running the IDE</a>
+ <a href=3D"#id352336">5.3. Running the IDE</a>
</span>
</dt>
<dt>
<span class=3D"sect1">
- <a href=3D"#id443840">5.4. IDE Features</a>
+ <a href=3D"#id349170">5.4. IDE Features</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class=3D"sect2">
- <a href=3D"#id464744">5.4.1. Editor Windows</a>
+ <a href=3D"#id347206">5.4.1. Editor Windows</a>
</span>
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id427255">5.4.2. The Lisp Menu</a>
+ <a href=3D"#id362540">5.4.2. The Lisp Menu</a>
</span>
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id495106">5.4.3. The Tools Menu</a>
+ <a href=3D"#id373691">5.4.3. The Tools Menu</a>
</span>
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id483840">5.4.4. The Inspector Window</a>
+ <a href=3D"#id373711">5.4.4. The Inspector Window</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class=3D"sect1">
- <a href=3D"#id495865">5.5. IDE Sources</a>
+ <a href=3D"#id394341">5.5. IDE Sources</a>
</span>
</dt>
<dt>
<span class=3D"sect1">
- <a href=3D"#id464104">5.6. The Application Builder</a>
+ <a href=3D"#id394374">5.6. The Application Builder</a>
</span>
</dt>
</dl>
@@ -4523,7 +4525,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title" style=3D"clear: both"><a id=3D"id44737=
8"></a>5.1.=C3=82=C2=A0Introduction</h2>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"id39199=
2"></a>5.1.=C3=82=C2=A0Introduction</h2>
</div>
</div>
</div>
@@ -4545,7 +4547,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title" style=3D"clear: both"><a id=3D"id46154=
0"></a>5.2.=C3=82=C2=A0Building the IDE</h2>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"id38870=
4"></a>5.2.=C3=82=C2=A0Building the IDE</h2>
</div>
</div>
</div>
@@ -4558,7 +4560,7 @@
</li>
<li>
<p>Run ccl from the shell. The easiest way to do this is
- generally to execute the openmcl or openmcl64 command.</p>
+ generally to execute the ccl or ccl64 command.</p>
</li>
<li>
<p>Evaluate the form <code class=3D"code">(require :cocoa-=
application)</code></p>
@@ -4569,17 +4571,17 @@
installed in "/usr/local/ccl", the following sequence of shell
interactions builds the IDE:</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programlist=
ing">
- oshirion:ccl mikel$ openmcl64
- Welcome to Clozure Common Lisp Version 1.2-r8516MS (DarwinX8664)!
- ? (require :cocoa-application)
- ;Loading #P"ccl:cocoa-ide;fasls;cocoa-utils.dx64fsl.newest"...
- ;Loading #P"ccl:cocoa-ide;fasls;cocoa-defaults.dx64fsl.newest"...
+oshirion:ccl mikel$ ccl64
+Welcome to Clozure Common Lisp Version 1.2-r9198M-trunk (DarwinX8664)!
+? (require :cocoa-application)
+;Loading #P"ccl:cocoa-ide;fasls;cocoa-utils.dx64fsl.newest"...
+;Loading #P"ccl:cocoa-ide;fasls;cocoa-defaults.dx64fsl.newest"...
=
- [...many lines of "Compiling" and "Loading" omitted...]
+[...many lines of "Compiling" and "Loading" omitted...]
=
- Saving application to /usr/local/ccl/Clozure CL.app/
+Saving application to /usr/local/ccl/Clozure CL.app/
=
- oshirion:ccl mikel$ =
+oshirion:ccl mikel$ =
=
</pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL compiles an=
d loads the various subsystems that
@@ -4592,18 +4594,18 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title" style=3D"clear: both"><a id=3D"id46036=
0"></a>5.3.=C3=82=C2=A0Running the IDE</h2>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"id35233=
6"></a>5.3.=C3=82=C2=A0Running the IDE</h2>
</div>
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">After it has been buil=
t, you can run the "Clozure CL.app"
application normally, by double-clicking its icon. When
launched, the IDE initially displays a
- single <a href=3D"#listener_window"><em class=3D"glossterm">listener
+ single <a class=3D"glossterm" href=3D"#listener_window"><em class=3D=
"glossterm">listener
window</em></a> that you can use to interact with Lisp. You
can type Lisp expressions for evaluation at the prompt in the
listener window. You can also
- use <a href=3D"#hemlock"><em class=3D"glossterm">Hemlock</em></a> ed=
iting
+ use <a class=3D"glossterm" href=3D"#hemlock"><em class=3D"glossterm"=
>Hemlock</em></a> editing
commands to edit the text of expressions in the listener
window.</p>
</div>
@@ -4611,7 +4613,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title" style=3D"clear: both"><a id=3D"id44384=
0"></a>5.4.=C3=82=C2=A0IDE Features</h2>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"id34917=
0"></a>5.4.=C3=82=C2=A0IDE Features</h2>
</div>
</div>
</div>
@@ -4619,7 +4621,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id464744"></a>5.4.1.=C3=82=
=C2=A0Editor Windows</h3>
+ <h3 class=3D"title"><a id=3D"id347206"></a>5.4.1.=C3=82=
=C2=A0Editor Windows</h3>
</div>
</div>
</div>
@@ -4630,7 +4632,7 @@
case Clozure CL creates a new window as if you had chosen New from
the File menu.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Editor windows
- implement <a href=3D"#hemlock"><em class=3D"glossterm">Hemlock</em=
></a>
+ implement <a class=3D"glossterm" href=3D"#hemlock"><em class=3D"gl=
ossterm">Hemlock</em></a>
editing commands. You can use all the editing and customization
features of Hemlock within any editor window (including listener
windows).</p>
@@ -4639,7 +4641,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id427255"></a>5.4.2.=C3=82=
=C2=A0The Lisp Menu</h3>
+ <h3 class=3D"title"><a id=3D"id362540"></a>5.4.2.=C3=82=
=C2=A0The Lisp Menu</h3>
</div>
</div>
</div>
@@ -4654,14 +4656,14 @@
file, the result is an error).</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">You can interrupt co=
mputations, trigger breaks, and select
restarts from the Lisp menu. You can also display a backtrace or
- open the <a href=3D"#section_inspector_window">Inspector
+ open the <a class=3D"link" href=3D"#section_inspector_window">Insp=
ector
window</a>.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id495106"></a>5.4.3.=C3=82=
=C2=A0The Tools Menu</h3>
+ <h3 class=3D"title"><a id=3D"id373691"></a>5.4.3.=C3=82=
=C2=A0The Tools Menu</h3>
</div>
</div>
</div>
@@ -4671,14 +4673,14 @@
Apropos window to quickly find function names and other useful
symbols. The Processes window lists all threads running in the
current Lisp session. If you double-click a process entry, Clozure=
CL
- opens an <a href=3D"#section_inspector_window">Inspector
+ opens an <a class=3D"link" href=3D"#section_inspector_window">Insp=
ector
window</a> on that process.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id483840"></a>5.4.4.=C3=82=
=C2=A0The Inspector Window</h3>
+ <h3 class=3D"title"><a id=3D"id373711"></a>5.4.4.=C3=82=
=C2=A0The Inspector Window</h3>
</div>
</div>
</div>
@@ -4710,7 +4712,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title" style=3D"clear: both"><a id=3D"id49586=
5"></a>5.5.=C3=82=C2=A0IDE Sources</h2>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"id39434=
1"></a>5.5.=C3=82=C2=A0IDE Sources</h2>
</div>
</div>
</div>
@@ -4736,7 +4738,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title" style=3D"clear: both"><a id=3D"id46410=
4"></a>5.6.=C3=82=C2=A0The Application Builder</h2>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"id39437=
4"></a>5.6.=C3=82=C2=A0The Application Builder</h2>
</div>
</div>
</div>
@@ -4744,7 +4746,7 @@
<p xmlns=3D"http://www.w3.org/1999/xhtml">One important feature =
of the IDE currently has no Cocoa user
interface: the application builder. The application builder
constructs a
- Cocoa <a href=3D"#application_bundle"><em class=3D"glossterm">applic=
ation
+ Cocoa <a class=3D"glossterm" href=3D"#application_bundle"><em class=
=3D"glossterm">application
bundle</em></a> that runs a Lisp image when double-clicked. You
can use the application builder to create Cocoa applications in
Lisp. These applications are exactly like Cocoa applications
@@ -4754,8 +4756,8 @@
expression <code class=3D"code">(require :build-application)</code>.=
Clozure CL loads
the required subsystems, if necessary.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id477838" class=3D"indexterm"></a>
- <span><strong class=3D"command"><em class=3D"varname"><a id=3D"build=
-application"></a>BUILD-APPLICATION</em> <em class=3D"varname"><em class=3D=
"varname">&key</em></em>
+ <a id=3D"id394404" class=3D"indexterm"></a>
+ <span class=3D"command"><strong><em class=3D"varname"><a id=3D"build=
-application"></a>BUILD-APPLICATION</em> <em class=3D"varname"><em class=3D=
"varname">&key</em></em>
(<em class=3D"parameter"><code>name</code></em> <em class=3D"repla=
ceable"><code>"MyApplication"</code></em>)
(<em class=3D"parameter"><code>type-string</code></em> <em class=
=3D"replaceable"><code>"APPL"</code></em>)
(<em class=3D"parameter"><code>creator-string</code></em> <em clas=
s=3D"replaceable"><code>"OMCL"</code></em>)
@@ -4809,12 +4811,12 @@
</span>
</dt>
<dd>
- <p>Specifies the <a href=3D"#creator_code"><em class=3D"gl=
ossterm">creator
+ <p>Specifies the <a class=3D"glossterm" href=3D"#creator_c=
ode"><em class=3D"glossterm">creator
code</em></a>, which uniquely identifies the application
under Mac OS X. The default creator code is that of Clozure CL=
. For
more information about reserving and assigning creator codes,
see
- Apple's <a href=3D"http://developer.apple.com/datatype/index.h=
tml" target=3D"_top">developer
+ Apple's <a class=3D"ulink" href=3D"http://developer.apple.com/=
datatype/index.html" target=3D"_top">developer
page</a> on the topic.</p>
</dd>
<dt>
@@ -4839,9 +4841,9 @@
</dt>
<dd>
<p>A list of pathnames, where each pathname identifies
- a <a href=3D"#nibfile"><em class=3D"glossterm">nibfile</em></a=
> created
+ a <a class=3D"glossterm" href=3D"#nibfile"><em class=3D"glosst=
erm">nibfile</em></a> created
with
- Apple's <a href=3D"#InterfaceBuilder"><em class=3D"glossterm">=
InterfaceBuilder</em></a>
+ Apple's <a class=3D"glossterm" href=3D"#InterfaceBuilder"><em =
class=3D"glossterm">InterfaceBuilder</em></a>
application. <code class=3D"code">BUILD-APPLICATION</code> cop=
ies each
nibfile into the appropriate place in the application bundle,
enabling the application to load user-interface elements from
@@ -4857,7 +4859,7 @@
</dt>
<dd>
<p>The name of
- the <a href=3D"#nibfile"><em class=3D"glossterm">nibfile</em><=
/a> to load
+ the <a class=3D"glossterm" href=3D"#nibfile"><em class=3D"glos=
sterm">nibfile</em></a> to load
initially when launching. The user-interface defined in this
nibfile becomes the application's main interface. You must
supply the name of a suitable nibfile for this parameter, or
@@ -5053,7 +5055,7 @@
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id466949">7.3.2. As of August 2003:</a>
+ <a href=3D"#id356525">7.3.2. As of August 2003:</a>
</span>
</dt>
</dl>
@@ -5304,7 +5306,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id466949"></a>7.3.2.=C3=82=
=C2=A0 As of August 2003:</h3>
+ <h3 class=3D"title"><a id=3D"id356525"></a>7.3.2.=C3=82=
=C2=A0 As of August 2003:</h3>
</div>
</div>
</div>
@@ -5747,7 +5749,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">all-processes</strong></span> =3D> result
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>all-processes</strong></span> =3D> result
</code>
</div>
<div class=3D"refentrytitle">Obtain a fresh list of all known =
Lisp
@@ -5756,13 +5758,13 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id442728">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399273">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---a list of all lisp processes (threads)
known to Clozure CL.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425580">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399299">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns a list o=
f all lisp processes (threads) known
to Clozure CL as of
@@ -5774,10 +5776,10 @@
sense in which such a list can be accurate.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id455035">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399314">=
</a>
<div class=3D"header">See Also:</div>
<span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist">
- <a href=3D"#v_current-process" title=3D"Variable *CURREN=
T-PROCESS*">
+ <a class=3D"xref" href=3D"#v_current-process" title=3D"V=
ariable *CURRENT-PROCESS*">
<b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
*current-process*</b>
</a>
</span>
@@ -5790,7 +5792,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">make-process</strong></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>make-process</strong></span>
name &key
persistent priority class stack-size vstack-size
tstack-size initial-bindings use-standard-initial-bindings
@@ -5802,7 +5804,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id464285">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399383">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">name</span></i>---a string, used to identify the process.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">persistent</span></i>---if true, requests that information about =
the process
@@ -5841,16 +5843,16 @@
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">process</span></i>---the newly-created process.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id446912">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399571">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Creates and retu=
rns a new lisp process (thread) with the
specified attributes. <em class=3D"varname">process</em> will not b=
egin
execution immediately; it will need to be
<span class=3D"emphasis"><em>preset</em></span> (given
an initial function to run, as by
- <a href=3D"#f_process-preset" title=3D"Function PROCESS-PRESET"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-preset</b></a>) =
and
+ <a class=3D"xref" href=3D"#f_process-preset" title=3D"Function PROC=
ESS-PRESET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-p=
reset</b></a>) and
<span class=3D"emphasis"><em>enabled</em></span>
- (allowed to execute, as by <a href=3D"#f_process-enable" title=3D"F=
unction PROCESS-ENABLE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitiona=
l">process-enable</b></a>)
+ (allowed to execute, as by <a class=3D"xref" href=3D"#f_process-ena=
ble" title=3D"Function PROCESS-ENABLE"><b xmlns=3D"http://www.w3.org/TR/xht=
ml1/transitional">process-enable</b></a>)
before it's able to actually do anything.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If <em class=3D"=
varname">valueform</em> is a function, it is
called, with no arguments, in the execution environment of the
@@ -5862,9 +5864,9 @@
is used.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id429285">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399624">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_process-preset" title=3D"Function PROCESS-PRESET"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-preset</b></a>, =
<a href=3D"#f_process-enable" title=3D"Function PROCESS-ENABLE"><b xmlns=3D=
"http://www.w3.org/TR/xhtml1/transitional">process-enable</b></a>, <a href=
=3D"#f_process-run-function" title=3D"Function PROCESS-RUN-FUNCTION"><b xml=
ns=3D"http://www.w3.org/TR/xhtml1/transitional">process-run-function</b></a=
></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_process-preset" title=3D"Function PROC=
ESS-PRESET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-p=
reset</b></a>, <a class=3D"xref" href=3D"#f_process-enable" title=3D"Functi=
on PROCESS-ENABLE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">pr=
ocess-enable</b></a>, <a class=3D"xref" href=3D"#f_process-run-function" ti=
tle=3D"Function PROCESS-RUN-FUNCTION"><b xmlns=3D"http://www.w3.org/TR/xhtm=
l1/transitional">process-run-function</b></a></span>
</div>
</div>
</p>
@@ -5873,7 +5875,7 @@
<a id=3D"f_process-suspend"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-suspend</strong></span> process
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-suspend</strong></span> process
=3D> result</code>
</div>
<div class=3D"refentrytitle">Suspends a specified process.</di=
v>
@@ -5881,17 +5883,17 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426934">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399702">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">process</span></i>---a lisp process (thread).</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---T if <em xmlns=3D"http://www.w3.org/1999/xhtm=
l" class=3D"varname">process</em> had been runnable
and is now suspended; NIL otherwise. That is, T if
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">pro=
cess</em>'s
- <a xmlns=3D"http://www.w3.org/1999/xhtml" href=3D"#f_process-sus=
pend-count" title=3D"Function PROCESS-SUSPEND-COUNT"><b xmlns=3D"http://www=
.w3.org/TR/xhtml1/transitional">process-suspend-count</b></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"xref" href=3D=
"#f_process-suspend-count" title=3D"Function PROCESS-SUSPEND-COUNT"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">process-suspend-count</b></a>
transitioned from 0 to 1.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id482610">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399756">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Suspends <em cla=
ss=3D"varname">process</em>, preventing it from
running, and stopping it if it was already running. This is a fairly
@@ -5901,11 +5903,11 @@
lock or other resource which another process will wait for.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Each
- call to <span><strong class=3D"function">process-suspend</strong></=
span> must be reversed by
- a matching call to <a href=3D"#f_process-resume" title=3D"Function =
PROCESS-RESUME"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">proce=
ss-resume</b></a>
+ call to <span class=3D"function"><strong>process-suspend</strong></=
span> must be reversed by
+ a matching call to <a class=3D"xref" href=3D"#f_process-resume" tit=
le=3D"Function PROCESS-RESUME"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tran=
sitional">process-resume</b></a>
before <em class=3D"varname">process</em> is able to run. What
- <span><strong class=3D"function">process-suspend</strong></span> ac=
tually does is increment
- the <a href=3D"#f_process-suspend-count" title=3D"Function PROCESS-=
SUSPEND-COUNT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">proces=
s-suspend-count</b></a> of
+ <span class=3D"function"><strong>process-suspend</strong></span> ac=
tually does is increment
+ the <a class=3D"xref" href=3D"#f_process-suspend-count" title=3D"Fu=
nction PROCESS-SUSPEND-COUNT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/trans=
itional">process-suspend-count</b></a> of
<em class=3D"varname">process</em>.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A process can su=
spend itself; it it's successful in doing
@@ -5913,18 +5915,18 @@
process.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id439814">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399812">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_process-resume" title=3D"Function PROCESS-RESUME"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-resume</b></a>, =
<a href=3D"#f_process-suspend-count" title=3D"Function PROCESS-SUSPEND-COUN=
T"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-suspend-co=
unt</b></a></span>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id463502">=
</a>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_process-resume" title=3D"Function PROC=
ESS-RESUME"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-r=
esume</b></a>, <a class=3D"xref" href=3D"#f_process-suspend-count" title=3D=
"Function PROCESS-SUSPEND-COUNT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tr=
ansitional">process-suspend-count</b></a></span>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399837">=
</a>
<div class=3D"header">Notes:</div>
- <p xmlns=3D"http://www.w3.org/1999/xhtml"><span><strong cl=
ass=3D"function">process-suspend</strong></span> was previously called
- <span><strong class=3D"function">process-disable</strong></span>.
- <a href=3D"#f_process-enable" title=3D"Function PROCESS-ENABLE"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-enable</b></a>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml"><span class=3D"f=
unction"><strong>process-suspend</strong></span> was previously called
+ <span class=3D"function"><strong>process-disable</strong></span>.
+ <a class=3D"xref" href=3D"#f_process-enable" title=3D"Function PROC=
ESS-ENABLE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-e=
nable</b></a>
now names a function for which there is no
- obvious inverse, so <span><strong class=3D"function">process-disabl=
e</strong></span>
+ obvious inverse, so <span class=3D"function"><strong>process-disabl=
e</strong></span>
is no longer
defined.</p>
</div>
@@ -5935,7 +5937,7 @@
<a id=3D"f_process-resume"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-resume</strong></span> process
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-resume</strong></span> process
=3D> result</code>
</div>
<div class=3D"refentrytitle">Resumes a specified process which=
had previously
@@ -5944,38 +5946,38 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id451272">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399918">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">process</span></i>---a lisp process (thread).</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---T if <em xmlns=3D"http://www.w3.org/1999/xhtm=
l" class=3D"varname">process</em> had been suspended
and is now runnable; NIL otherwise. That is, T if
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">pro=
cess</em>'s
- <a xmlns=3D"http://www.w3.org/1999/xhtml" href=3D"#f_process-sus=
pend-count" title=3D"Function PROCESS-SUSPEND-COUNT"><b xmlns=3D"http://www=
.w3.org/TR/xhtml1/transitional">process-suspend-count</b></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"xref" href=3D=
"#f_process-suspend-count" title=3D"Function PROCESS-SUSPEND-COUNT"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">process-suspend-count</b></a>
transitioned from to 0.
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504118">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399972">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Undoes the effec=
t of a previous call to
- <a href=3D"#f_process-suspend" title=3D"Function PROCESS-SUSPEND"><=
b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-suspend</b></a=
>; if
+ <a class=3D"xref" href=3D"#f_process-suspend" title=3D"Function PRO=
CESS-SUSPEND"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process=
-suspend</b></a>; if
all such calls are undone, makes the process runnable. Has no
effect if the process is not suspended. What
- <span><strong class=3D"function">process-resume</strong></span> act=
ually does is decrement
- the <a href=3D"#f_process-suspend-count" title=3D"Function PROCESS-=
SUSPEND-COUNT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">proces=
s-suspend-count</b></a> of
+ <span class=3D"function"><strong>process-resume</strong></span> act=
ually does is decrement
+ the <a class=3D"xref" href=3D"#f_process-suspend-count" title=3D"Fu=
nction PROCESS-SUSPEND-COUNT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/trans=
itional">process-suspend-count</b></a> of
<em class=3D"varname">process</em>, to a minimum of 0.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504143">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400003">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_process-suspend" title=3D"Function PROCESS-SUSPEND"><=
b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-suspend</b></a=
>, <a href=3D"#f_process-suspend-count" title=3D"Function PROCESS-SUSPEND-C=
OUNT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-suspend=
-count</b></a></span>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504162">=
</a>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_process-suspend" title=3D"Function PRO=
CESS-SUSPEND"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process=
-suspend</b></a>, <a class=3D"xref" href=3D"#f_process-suspend-count" title=
=3D"Function PROCESS-SUSPEND-COUNT"><b xmlns=3D"http://www.w3.org/TR/xhtml1=
/transitional">process-suspend-count</b></a></span>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400028">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
This was previously called PROCESS-ENABLE;
- <a href=3D"#f_process-enable" title=3D"Function PROCESS-ENABLE"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-enable</b></a> n=
ow does something slightly
+ <a class=3D"xref" href=3D"#f_process-enable" title=3D"Function PROC=
ESS-ENABLE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-e=
nable</b></a> now does something slightly
different.
</p>
</div>
@@ -5987,7 +5989,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">process-suspend-count</strong></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>process-suspend-count</strong></span>
process =3D> result
</code>
</div>
@@ -5997,34 +5999,34 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504213">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400093">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">process</span></i>---a lisp process (thread).</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---The number of "outstanding"
- <a xmlns=3D"http://www.w3.org/1999/xhtml" href=3D"#f_process-sus=
pend" title=3D"Function PROCESS-SUSPEND"><b xmlns=3D"http://www.w3.org/TR/x=
html1/transitional">process-suspend</b></a> calls on
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"xref" href=3D=
"#f_process-suspend" title=3D"Function PROCESS-SUSPEND"><b xmlns=3D"http://=
www.w3.org/TR/xhtml1/transitional">process-suspend</b></a> calls on
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">pro=
cess</em>, or NIL if
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">pro=
cess</em> has expired.
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504257">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400147">=
</a>
<div class=3D"header">Description:</div>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">An "outstanding"=
<a href=3D"#f_process-suspend" title=3D"Function PROCESS-SUSPEND"><b xmlns=
=3D"http://www.w3.org/TR/xhtml1/transitional">process-suspend</b></a> call
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">An "outstanding"=
<a class=3D"xref" href=3D"#f_process-suspend" title=3D"Function PROCESS-SU=
SPEND"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-suspen=
d</b></a> call
is one which has not yet been reversed by a call to
- <a href=3D"#f_process-resume" title=3D"Function PROCESS-RESUME"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-resume</b></a>. =
A process expires when
+ <a class=3D"xref" href=3D"#f_process-resume" title=3D"Function PROC=
ESS-RESUME"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-r=
esume</b></a>. A process expires when
its initial function returns, although it may later be
reset.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A process is <sp=
an class=3D"emphasis"><em>runnable</em></span> when it has a
- <span><strong class=3D"function">process-suspend-count</strong></sp=
an> of 0, has been
- preset as by <a href=3D"#f_process-preset" title=3D"Function PROCES=
S-PRESET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-pre=
set</b></a>, and has been
- enabled as by <a href=3D"#f_process-enable" title=3D"Function PROCE=
SS-ENABLE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-en=
able</b></a>. Newly-created
- processes have a <span><strong class=3D"function">process-suspend-c=
ount</strong></span> of
+ <span class=3D"function"><strong>process-suspend-count</strong></sp=
an> of 0, has been
+ preset as by <a class=3D"xref" href=3D"#f_process-preset" title=3D"=
Function PROCESS-PRESET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transition=
al">process-preset</b></a>, and has been
+ enabled as by <a class=3D"xref" href=3D"#f_process-enable" title=3D=
"Function PROCESS-ENABLE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitio=
nal">process-enable</b></a>. Newly-created
+ processes have a <span class=3D"function"><strong>process-suspend-c=
ount</strong></span> of
0.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504296">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400197">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_process-suspend" title=3D"Function PROCESS-SUSPEND"><=
b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-suspend</b></a=
>, <a href=3D"#f_process-resume" title=3D"Function PROCESS-RESUME"><b xmlns=
=3D"http://www.w3.org/TR/xhtml1/transitional">process-resume</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_process-suspend" title=3D"Function PRO=
CESS-SUSPEND"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process=
-suspend</b></a>, <a class=3D"xref" href=3D"#f_process-resume" title=3D"Fun=
ction PROCESS-RESUME"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional"=
>process-resume</b></a></span>
</div>
</div>
</p>
@@ -6033,7 +6035,7 @@
<a id=3D"f_process-preset"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-preset</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-preset</strong></span>
process function <em xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"varname">&rest</em> args
=3D> result</code>
</div>
@@ -6043,7 +6045,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504353">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400273">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">process</span></i>---a lisp process (thread).</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">function</span></i>---a function, designated by itself or by a sy=
mbol
@@ -6054,23 +6056,23 @@
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---undefined.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504419">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400348">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Typically used t=
o initialize a newly-created or newly-reset
process, setting things up so that when <em class=3D"varname">proce=
ss</em>
becomes enabled, it will begin execution by
applying <em class=3D"varname">function</em> to <em class=3D"varnam=
e">args</em>.
- <span><strong class=3D"function">process-preset</strong></span> doe=
s not enable
+ <span class=3D"function"><strong>process-preset</strong></span> doe=
s not enable
<em class=3D"varname">process</em>,
- although a process must be <span><strong class=3D"function">process=
-preset</strong></span>
+ although a process must be <span class=3D"function"><strong>process=
-preset</strong></span>
before it can be enabled. Processes are normally enabled by
- <a href=3D"#f_process-enable" title=3D"Function PROCESS-ENABLE"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-enable</b></a>.
+ <a class=3D"xref" href=3D"#f_process-enable" title=3D"Function PROC=
ESS-ENABLE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-e=
nable</b></a>.
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504456">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400392">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-process" title=3D"Function MAKE-PROCESS"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">make-process</b></a>, <a hre=
f=3D"#f_process-enable" title=3D"Function PROCESS-ENABLE"><b xmlns=3D"http:=
//www.w3.org/TR/xhtml1/transitional">process-enable</b></a>, <a href=3D"#f_=
process-run-function" title=3D"Function PROCESS-RUN-FUNCTION"><b xmlns=3D"h=
ttp://www.w3.org/TR/xhtml1/transitional">process-run-function</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-process" title=3D"Function MAKE-P=
ROCESS"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-process<=
/b></a>, <a class=3D"xref" href=3D"#f_process-enable" title=3D"Function PRO=
CESS-ENABLE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-=
enable</b></a>, <a class=3D"xref" href=3D"#f_process-run-function" title=3D=
"Function PROCESS-RUN-FUNCTION"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tra=
nsitional">process-run-function</b></a></span>
</div>
</div>
</p>
@@ -6079,7 +6081,7 @@
<a id=3D"f_process-enable"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-enable</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-enable</strong></span>
process <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname=
">&optional</em> timeout
</code>
</div>
@@ -6089,23 +6091,23 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504517">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400474">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">process</span></i>---a lisp process (thread).</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">timeout</span></i>---a time interval in seconds. May be any
- non-negative real number the <span xmlns=3D"http://www.w3.org/19=
99/xhtml"><strong class=3D"function">floor</strong></span> of
+ non-negative real number the <span xmlns=3D"http://www.w3.org/19=
99/xhtml" class=3D"function"><strong>floor</strong></span> of
which fits in 32 bits. The default is 1.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---undefined.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504570">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400537">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Tries to begin t=
he execution of <em class=3D"varname">process</em>.
An error is signaled if <em class=3D"varname">process</em> has never
- been <a href=3D"#f_process-preset" title=3D"Function PROCESS-PRESET=
"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-preset</b><=
/a>. Otherwise,
+ been <a class=3D"xref" href=3D"#f_process-preset" title=3D"Function=
PROCESS-PRESET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">proc=
ess-preset</b></a>. Otherwise,
<em class=3D"varname">process</em> invokes its initial function.
</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml"><span><strong cl=
ass=3D"function">process-enable</strong></span> attempts to
+ <p xmlns=3D"http://www.w3.org/1999/xhtml"><span class=3D"f=
unction"><strong>process-enable</strong></span> attempts to
synchronize with <em class=3D"varname">process</em>, which is presu=
med
to be reset or in the act of resetting itself. If this attempt
is not successful within the time interval specified by
@@ -6115,12 +6117,12 @@
<p xmlns=3D"http://www.w3.org/1999/xhtml">A process cannot=
meaningfully attempt to enable itself.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504614">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400585">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-process" title=3D"Function MAKE-PROCESS"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">make-process</b></a>, <a hre=
f=3D"#f_process-preset" title=3D"Function PROCESS-PRESET"><b xmlns=3D"http:=
//www.w3.org/TR/xhtml1/transitional">process-preset</b></a>, <a href=3D"#f_=
process-run-function" title=3D"Function PROCESS-RUN-FUNCTION"><b xmlns=3D"h=
ttp://www.w3.org/TR/xhtml1/transitional">process-run-function</b></a></span>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504637">=
</a>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-process" title=3D"Function MAKE-P=
ROCESS"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-process<=
/b></a>, <a class=3D"xref" href=3D"#f_process-preset" title=3D"Function PRO=
CESS-PRESET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-=
preset</b></a>, <a class=3D"xref" href=3D"#f_process-run-function" title=3D=
"Function PROCESS-RUN-FUNCTION"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tra=
nsitional">process-run-function</b></a></span>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400616">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">It would be nice=
to have more discussion of what it means
to synchronize with the process.</p>
@@ -6132,7 +6134,7 @@
<a id=3D"f_process-run-function"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-run-function</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-run-function</strong></span>
process-specifier function <em xmlns=3D"http://www.w3.org/1999/xhtm=
l" class=3D"varname">&rest</em> args =3D> process</code>
</div>
<div class=3D"refentrytitle">Creates a process, presets it, an=
d enables it.
@@ -6141,44 +6143,44 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504731">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400731">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">name</span></i>---a string, used to identify the process.
- Passed to <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">make-process</strong></span>.</p>
+ Passed to <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>make-process</strong></span>.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">function</span></i>---a function, designated by itself or by a sy=
mbol
which names it. Passed to
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"fu=
nction">preset-process</strong></span>.
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function">=
<strong>preset-process</strong></span>.
</p>
- <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">persistent</span></i>---a boolean, passed to <span xmlns=3D"http:=
//www.w3.org/1999/xhtml"><strong class=3D"function">make-process</strong></=
span>.
+ <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">persistent</span></i>---a boolean, passed to <span xmlns=3D"http:=
//www.w3.org/1999/xhtml" class=3D"function"><strong>make-process</strong></=
span>.
</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">priority</span></i>---ignored.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">class</span></i>---a subclass of CCL:PROCESS. Passed to
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"fu=
nction">make-process</strong></span>.</p>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function">=
<strong>make-process</strong></span>.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">stack-size</span></i>---a size, in bytes. Passed to
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"fu=
nction">make-process</strong></span>.</p>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function">=
<strong>make-process</strong></span>.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">vstack-size</span></i>---a size, in bytes. Passed to
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"fu=
nction">make-process</strong></span>.</p>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function">=
<strong>make-process</strong></span>.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">tstack-size</span></i>---a size, in bytes. Passed to
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"fu=
nction">make-process</strong></span>.</p>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function">=
<strong>make-process</strong></span>.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">process</span></i>---the newly-created process.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504882">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400920">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Creates a lisp p=
rocess (thread) via
- <a href=3D"#f_make-process" title=3D"Function MAKE-PROCESS"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">make-process</b></a>,
- presets it via <a href=3D"#f_process-preset" title=3D"Function PROC=
ESS-PRESET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-p=
reset</b></a>, and
- enables it via <a href=3D"#f_process-enable" title=3D"Function PROC=
ESS-ENABLE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-e=
nable</b></a>. This means
+ <a class=3D"xref" href=3D"#f_make-process" title=3D"Function MAKE-P=
ROCESS"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-process<=
/b></a>,
+ presets it via <a class=3D"xref" href=3D"#f_process-preset" title=
=3D"Function PROCESS-PRESET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transi=
tional">process-preset</b></a>, and
+ enables it via <a class=3D"xref" href=3D"#f_process-enable" title=
=3D"Function PROCESS-ENABLE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transi=
tional">process-enable</b></a>. This means
that <em class=3D"varname">process</em> will immediately begin to
execute.
- <span><strong class=3D"function">process-run-function</strong></spa=
n> is
+ <span class=3D"function"><strong>process-run-function</strong></spa=
n> is
the simplest way to create and run a process.
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504909">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400955">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-process" title=3D"Function MAKE-PROCESS"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">make-process</b></a>, <a hre=
f=3D"#f_process-preset" title=3D"Function PROCESS-PRESET"><b xmlns=3D"http:=
//www.w3.org/TR/xhtml1/transitional">process-preset</b></a>, <a href=3D"#f_=
process-enable" title=3D"Function PROCESS-ENABLE"><b xmlns=3D"http://www.w3=
.org/TR/xhtml1/transitional">process-enable</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-process" title=3D"Function MAKE-P=
ROCESS"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-process<=
/b></a>, <a class=3D"xref" href=3D"#f_process-preset" title=3D"Function PRO=
CESS-PRESET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-=
preset</b></a>, <a class=3D"xref" href=3D"#f_process-enable" title=3D"Funct=
ion PROCESS-ENABLE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">p=
rocess-enable</b></a></span>
</div>
</div>
</p>
@@ -6187,7 +6189,7 @@
<a id=3D"f_process-interrupt"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-interrupt</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-interrupt</strong></span>
process function <em xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"varname">&rest</em> args =3D> result</code>
</div>
<div class=3D"refentrytitle">Arranges for the target process t=
o invoke a
@@ -6197,7 +6199,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id504972">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id412921">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">process</span></i>---a lisp process (thread).</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">function</span></i>---a function.
@@ -6206,11 +6208,11 @@
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">fun=
ction</em>.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---the result of applying <em xmlns=3D"http://ww=
w.w3.org/1999/xhtml" class=3D"varname">function</em>
to <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">=
args</em> if <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">p=
rocess</em>
- is the <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong clas=
s=3D"function">current-process</strong></span>, otherwise
+ is the <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"fun=
ction"><strong>current-process</strong></span>, otherwise
NIL.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505050">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413000">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Arranges for <em=
class=3D"varname">process</em>
to apply <em class=3D"varname">function</em> to <em class=3D"varnam=
e">args</em> at
@@ -6221,10 +6223,10 @@
execution at the point at which it was interrupted.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml"><em class=3D"var=
name">process</em> must be in an enabled state in
order to respond
- to a <span><strong class=3D"function">process-interrupt</strong></s=
pan> request. It's
+ to a <span class=3D"function"><strong>process-interrupt</strong></s=
pan> request. It's
perfectly legal for a process to call
- <span><strong class=3D"function">process-interrupt</strong></span> =
on itself.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml"><span><strong cl=
ass=3D"function">process-interrupt</strong></span>
+ <span class=3D"function"><strong>process-interrupt</strong></span> =
on itself.</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml"><span class=3D"f=
unction"><strong>process-interrupt</strong></span>
uses asynchronous POSIX signals to interrupt threads. If the
thread being interrupted is executing lisp code, it can
respond to the interrupt almost immediately (as soon as it
@@ -6241,24 +6243,24 @@
to or enters lisp.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505119">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413067">=
</a>
<div class=3D"header">See Also:</div>
<span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist">
- <a href=3D"#m_without-interrupts" title=3D"Macro WITHOUT=
-INTERRUPTS">
+ <a class=3D"xref" href=3D"#m_without-interrupts" title=
=3D"Macro WITHOUT-INTERRUPTS">
<b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
without-interrupts</b>
</a>
</span>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505134">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413084">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">It would probabl=
y be better for <em class=3D"varname">result</em>
to always be NIL, since the present behavior is inconsistent.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <span><strong class=3D"function">Process-interrupt</strong></span> =
works by sending signals
+ <span class=3D"function"><strong>Process-interrupt</strong></span> =
works by sending signals
between threads, via the C function
- <span><strong class=3D"function">#_pthread_signal</strong></span>. =
It could be argued
+ <span class=3D"function"><strong>#_pthread_signal</strong></span>. =
It could be argued
that it should be done in one of several possible other ways
under
Darwin, to make it practical to asynchronously interrupt
@@ -6280,27 +6282,27 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505189">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413143">=
</a>
<div class=3D"header">Value Type:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A lisp process (=
thread).</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505198">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413152">=
</a>
<div class=3D"header">Initial Value:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Bound separately=
in each process, to that process itself.
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505209">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413162">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Used when lisp c=
ode needs to find out what process it is
executing in. Shouldn't be set by user code.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505220">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413173">=
</a>
<div class=3D"header">See Also:</div>
<span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist">
- <a href=3D"#f_all-processes" title=3D"Function ALL-PROCE=
SSES">
+ <a class=3D"xref" href=3D"#f_all-processes" title=3D"Fun=
ction ALL-PROCESSES">
<b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
all-processes</b>
</a>
</span>
@@ -6312,7 +6314,7 @@
<a id=3D"f_process-reset"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-reset</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-reset</strong></span>
process <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname=
">&optional</em> kill-option =3D> result</code>
</div>
<div class=3D"refentrytitle">Causes a specified process to cle=
anly exit from
@@ -6321,20 +6323,20 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505273">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413235">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">process</span></i>---a lisp process (thread).</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">kill-option</span></i>---a generalized boolean. The default is T=
.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---undefined.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505321">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413283">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Causes <em class=
=3D"varname">process</em> to cleanly exit
from any ongoing computation. If <em class=3D"varname">kill-option=
</em>
is true, <em class=3D"varname">process</em> then exits. Otherwise,=
it
enters a state where it can be
- <a href=3D"#f_process-preset" title=3D"Function PROCESS-PRESET"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-preset</b></a>. =
This
+ <a class=3D"xref" href=3D"#f_process-preset" title=3D"Function PROC=
ESS-PRESET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-p=
reset</b></a>. This
is implemented by signaling a condition of type PROCESS-RESET;
user-defined condition handlers should generally refrain from
attempting to handle conditions of this type.</p>
@@ -6344,20 +6346,20 @@
has completed the act of resetting or killing itself; a process
which has either entered the limbo of the reset state or exited
has few ways of communicating either fact.
- <a href=3D"#f_process-enable" title=3D"Function PROCESS-ENABLE"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-enable</b></a>
+ <a class=3D"xref" href=3D"#f_process-enable" title=3D"Function PROC=
ESS-ENABLE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-e=
nable</b></a>
can reliably determine when a process has entered
the "limbo of the reset state", but can't predict how long the
clean exit from ongoing computation might take: that depends on
- the behavior of <span><strong class=3D"function">unwind-protect</st=
rong></span> cleanup
+ the behavior of <span class=3D"function"><strong>unwind-protect</st=
rong></span> cleanup
forms, and of the OS scheduler.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Resetting a proc=
ess other than
- <a href=3D"#v_current-process" title=3D"Variable *CURRENT-PROCESS*"=
><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">*current-process*</b=
></a> involves the
- use of <a href=3D"#f_process-interrupt" title=3D"Function PROCESS-I=
NTERRUPT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-int=
errupt</b></a>.</p>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505383">=
</a>
+ <a class=3D"xref" href=3D"#v_current-process" title=3D"Variable *CU=
RRENT-PROCESS*"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">*curr=
ent-process*</b></a> involves the
+ use of <a class=3D"xref" href=3D"#f_process-interrupt" title=3D"Fun=
ction PROCESS-INTERRUPT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transition=
al">process-interrupt</b></a>.</p>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413344">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_process-kill" title=3D"Function PROCESS-KILL"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">process-kill</b></a>, <a hre=
f=3D"#f_process-abort" title=3D"Function PROCESS-ABORT"><b xmlns=3D"http://=
www.w3.org/TR/xhtml1/transitional">process-abort</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_process-kill" title=3D"Function PROCES=
S-KILL"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-kill<=
/b></a>, <a class=3D"xref" href=3D"#f_process-abort" title=3D"Function PROC=
ESS-ABORT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-ab=
ort</b></a></span>
</div>
</div>
</p>
@@ -6366,7 +6368,7 @@
<a id=3D"f_process-kill"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-kill</strong></span> process
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-kill</strong></span> process
=3D> result</code>
</div>
<div class=3D"refentrytitle">Causes a specified process to cle=
anly exit from any
@@ -6375,22 +6377,22 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505437">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413408">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">process</span></i>---a lisp process (thread).</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---undefined.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505472">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413443">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Entirely equival=
ent to calling
(PROCESS-RESET PROCESS T). Causes <em class=3D"varname">process</e=
m>
to cleanly exit from any ongoing computation, and then exit.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505488">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413458">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_process-reset" title=3D"Function PROCESS-RESET"><b xm=
lns=3D"http://www.w3.org/TR/xhtml1/transitional">process-reset</b></a>, <a =
href=3D"#f_process-abort" title=3D"Function PROCESS-ABORT"><b xmlns=3D"http=
://www.w3.org/TR/xhtml1/transitional">process-abort</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_process-reset" title=3D"Function PROCE=
SS-RESET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-res=
et</b></a>, <a class=3D"xref" href=3D"#f_process-abort" title=3D"Function P=
ROCESS-ABORT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process=
-abort</b></a></span>
</div>
</div>
</p>
@@ -6399,7 +6401,7 @@
<a id=3D"f_process-abort"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-abort</strong></span> process
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-abort</strong></span> process
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&o=
ptional</em> condition
=3D> NIL</code>
</div>
@@ -6410,29 +6412,29 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505548">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413530">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">process</span></i>---a lisp process (thread).</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">condition</span></i>---a lisp condition. The default is NIL.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505583">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413565">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Entirely equival=
ent to calling
- (<a href=3D"#f_process-interrupt" title=3D"Function PROCESS-INTERRU=
PT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-interrupt=
</b></a> <em class=3D"varname">process</em>
- (<span><strong class=3D"function">lambda</strong></span> ()
- (<span><strong class=3D"function">abort</strong></span> <em class=
=3D"varname">condition</em>))).
+ (<a class=3D"xref" href=3D"#f_process-interrupt" title=3D"Function =
PROCESS-INTERRUPT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">pr=
ocess-interrupt</b></a> <em class=3D"varname">process</em>
+ (<span class=3D"function"><strong>lambda</strong></span> ()
+ (<span class=3D"function"><strong>abort</strong></span> <em class=
=3D"varname">condition</em>))).
Causes <em class=3D"varname">process</em> to transfer control to the
- applicable handler or restart for <span><strong class=3D"function">=
abort</strong></span>.</p>
+ applicable handler or restart for <span class=3D"function"><strong>=
abort</strong></span>.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If <em class=3D"=
varname">condition</em> is non-NIL,
- <span><strong class=3D"function">process-abort</strong></span> does=
not consider any
+ <span class=3D"function"><strong>process-abort</strong></span> does=
not consider any
handlers which are explicitly bound to conditions other than
<em class=3D"varname">condition</em>.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505631">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413620">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_process-reset" title=3D"Function PROCESS-RESET"><b xm=
lns=3D"http://www.w3.org/TR/xhtml1/transitional">process-reset</b></a>, <a =
href=3D"#f_process-kill" title=3D"Function PROCESS-KILL"><b xmlns=3D"http:/=
/www.w3.org/TR/xhtml1/transitional">process-kill</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_process-reset" title=3D"Function PROCE=
SS-RESET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-res=
et</b></a>, <a class=3D"xref" href=3D"#f_process-kill" title=3D"Function PR=
OCESS-KILL"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-k=
ill</b></a></span>
</div>
</div>
</p>
@@ -6449,19 +6451,19 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505676">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413672">=
</a>
<div class=3D"header">Value Type:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A positive integ=
er.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505685">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413681">=
</a>
<div class=3D"header">Initial Value:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The clock resolu=
tion of the OS scheduler. Currently,
both LinuxPPC and DarwinPPC yield an initial value of 100.
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505697">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413692">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">This value is or=
dinarily of marginal interest at best,
but, for backward compatibility, some functions accept timeout
@@ -6469,10 +6471,10 @@
ticks per second.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505710">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413704">=
</a>
<div class=3D"header">See Also:</div>
<span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist">
- <a href=3D"#f_process-wait-with-timeout" title=3D"Functi=
on PROCESS-WAIT-WITH-TIMEOUT">
+ <a class=3D"xref" href=3D"#f_process-wait-with-timeout" =
title=3D"Function PROCESS-WAIT-WITH-TIMEOUT">
<b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
process-wait-with-timeout</b>
</a>
</span>
@@ -6484,7 +6486,7 @@
<a id=3D"f_process-whostate"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-whostate</strong></span> process
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-whostate</strong></span> process
=3D> whostate</code>
</div>
<div class=3D"refentrytitle">Returns a string which describes =
the status of
@@ -6493,26 +6495,26 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505793">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413794">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">This information=
is primarily for the benefit of
debugging tools. <em class=3D"varname">whostate</em> is a terse re=
port
on what <em class=3D"varname">process</em> is doing, or not doing,
and why.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If the process i=
s currently waiting in a call to
- <a href=3D"#f_process-wait" title=3D"Function PROCESS-WAIT"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">process-wait</b></a> or
- <a href=3D"#f_process-wait-with-timeout" title=3D"Function PROCESS-=
WAIT-WITH-TIMEOUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">pr=
ocess-wait-with-timeout</b></a>, its
- <span><strong class=3D"function">process-whostate</strong></span> w=
ill be the value
+ <a class=3D"xref" href=3D"#f_process-wait" title=3D"Function PROCES=
S-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-wait<=
/b></a> or
+ <a class=3D"xref" href=3D"#f_process-wait-with-timeout" title=3D"Fu=
nction PROCESS-WAIT-WITH-TIMEOUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/t=
ransitional">process-wait-with-timeout</b></a>, its
+ <span class=3D"function"><strong>process-whostate</strong></span> w=
ill be the value
which was passed to that function as <em class=3D"varname">whostate=
</em>.
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505828">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413832">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_process-wait" title=3D"Function PROCESS-WAIT"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">process-wait</b></a>, <a hre=
f=3D"#f_process-wait-with-timeout" title=3D"Function PROCESS-WAIT-WITH-TIME=
OUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-wait-wit=
h-timeout</b></a>, <a href=3D"#m_with-terminal-input" title=3D"Macro WITH-T=
ERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-t=
erminal-input</b></a></span>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505852">=
</a>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_process-wait" title=3D"Function PROCES=
S-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-wait<=
/b></a>, <a class=3D"xref" href=3D"#f_process-wait-with-timeout" title=3D"F=
unction PROCESS-WAIT-WITH-TIMEOUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/=
transitional">process-wait-with-timeout</b></a>, <a class=3D"xref" href=3D"=
#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D"htt=
p://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413859">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">This should argu=
ably be SETFable, but doesn't seem to
ever have been.</p>
@@ -6525,8 +6527,8 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml">
- <strong class=3D"function">process-allow-schedule</stron=
g>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"func=
tion">
+ <strong>process-allow-schedule</strong>
</span>
</code>
</div>
@@ -6536,7 +6538,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505896">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413910">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Advises the OS s=
cheduler that the current thread has nothing
useful to do and that it should try to find some other thread to
@@ -6545,12 +6547,12 @@
occur. For example, you could use a lock or semaphore.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505911">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413923">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"h=
ttp://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a href=3D"#f_m=
ake-read-write-lock" title=3D"Function MAKE-READ-WRITE-LOCK"><b xmlns=3D"ht=
tp://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a hr=
ef=3D"#f_make-semaphore" title=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http=
://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a href=3D"#f=
_process-input-wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http=
://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a href=
=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=
=3D"http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, =
<a href=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b x=
mlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></=
a></span>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505947">=
</a>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-lock" title=3D"Function MAKE-LOCK=
"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, =
<a class=3D"xref" href=3D"#f_make-read-write-lock" title=3D"Function MAKE-R=
EAD-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-=
read-write-lock</b></a>, <a class=3D"xref" href=3D"#f_make-semaphore" title=
=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transi=
tional">make-semaphore</b></a>, <a class=3D"xref" href=3D"#f_process-input-=
wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/T=
R/xhtml1/transitional">process-input-wait</b></a>, <a class=3D"xref" href=
=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=
=3D"http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, =
<a class=3D"xref" href=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMI=
NAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-termi=
nal-input</b></a></span>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id413965">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">This is a holdov=
er from the days of cooperative
multitasking. All modern general-purpose operating systems use
@@ -6563,7 +6565,7 @@
<a id=3D"f_process-wait"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-wait</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-wait</strong></span>
whostate function <em xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"varname">&rest</em> args =3D> result</code>
</div>
<div class=3D"refentrytitle">Causes the current lisp process (=
thread) to wait for
@@ -6573,10 +6575,10 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id505998">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414021">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">whostate</span></i>---a string, which will be the value of
- <a xmlns=3D"http://www.w3.org/1999/xhtml" href=3D"#f_process-who=
state" title=3D"Function PROCESS-WHOSTATE"><b xmlns=3D"http://www.w3.org/TR=
/xhtml1/transitional">process-whostate</b></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"xref" href=3D=
"#f_process-whostate" title=3D"Function PROCESS-WHOSTATE"><b xmlns=3D"http:=
//www.w3.org/TR/xhtml1/transitional">process-whostate</b></a>
while the process is waiting.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">function</span></i>---a function, designated by itself or by a sy=
mbol
which names it.
@@ -6586,16 +6588,16 @@
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---NIL.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id506068">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414091">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Causes the curre=
nt lisp process (thread) to repeatedly
apply <em class=3D"varname">function</em> to
<em class=3D"varname">args</em> until the call returns a true resul=
t, then
returns NIL. After
each failed call, yields the CPU as if by
- <a href=3D"#f_process-allow-schedule" title=3D"Function PROCESS-ALL=
OW-SCHEDULE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-=
allow-schedule</b></a>.</p>
+ <a class=3D"xref" href=3D"#f_process-allow-schedule" title=3D"Funct=
ion PROCESS-ALLOW-SCHEDULE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transit=
ional">process-allow-schedule</b></a>.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- As with <a href=3D"#f_process-allow-schedule" title=3D"Function PRO=
CESS-ALLOW-SCHEDULE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
process-allow-schedule</b></a>, it's almost
+ As with <a class=3D"xref" href=3D"#f_process-allow-schedule" title=
=3D"Function PROCESS-ALLOW-SCHEDULE"><b xmlns=3D"http://www.w3.org/TR/xhtml=
1/transitional">process-allow-schedule</b></a>, it's almost
always more efficient to wait for some
specific event to occur; this isn't exactly busy-waiting, but
the OS scheduler can do a better job of scheduling if it's given
@@ -6603,9 +6605,9 @@
or semaphore.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id506102">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414123">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_process-whostate" title=3D"Function PROCESS-WHOSTATE"=
><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-whostate</b>=
</a>, <a href=3D"#f_process-wait-with-timeout" title=3D"Function PROCESS-WA=
IT-WITH-TIMEOUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">proc=
ess-wait-with-timeout</b></a>, <a href=3D"#f_make-lock" title=3D"Function M=
AKE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</=
b></a>, <a href=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WRI=
TE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-wr=
ite-lock</b></a>, <a href=3D"#f_make-semaphore" title=3D"Function MAKE-SEMA=
PHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-semaphore=
</b></a>, <a href=3D"#f_process-input-wait" title=3D"Function PROCESS-INPUT=
-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-input-=
wait</b></a>, <a href=3D"#f_process-output-wait" title=3D"Function PROCESS-=
OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-=
output-wait</b></a>, <a href=3D"#m_with-terminal-input" title=3D"Macro WITH=
-TERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with=
-terminal-input</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_process-whostate" title=3D"Function PR=
OCESS-WHOSTATE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">proce=
ss-whostate</b></a>, <a class=3D"xref" href=3D"#f_process-wait-with-timeout=
" title=3D"Function PROCESS-WAIT-WITH-TIMEOUT"><b xmlns=3D"http://www.w3.or=
g/TR/xhtml1/transitional">process-wait-with-timeout</b></a>, <a class=3D"xr=
ef" href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"http://w=
ww.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class=3D"xref" href=
=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WRITE-LOCK"><b xml=
ns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a=
>, <a class=3D"xref" href=3D"#f_make-semaphore" title=3D"Function MAKE-SEMA=
PHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-semaphore=
</b></a>, <a class=3D"xref" href=3D"#f_process-input-wait" title=3D"Functio=
n PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional"=
>process-input-wait</b></a>, <a class=3D"xref" href=3D"#f_process-output-wa=
it" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR=
/xhtml1/transitional">process-output-wait</b></a>, <a class=3D"xref" href=
=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D=
"http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></spa=
n>
</div>
</div>
</p>
@@ -6614,7 +6616,7 @@
<a id=3D"f_process-wait-with-timeout"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-wait-with-timeout</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-wait-with-timeout</strong></span>
whostate ticks function args =3D> result</code>
</div>
<div class=3D"refentrytitle">Causes the current thread to wait=
for a given
@@ -6623,44 +6625,44 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id506181">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414218">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">whostate</span></i>---a string, which will be the value of
- <a xmlns=3D"http://www.w3.org/1999/xhtml" href=3D"#f_process-who=
state" title=3D"Function PROCESS-WHOSTATE"><b xmlns=3D"http://www.w3.org/TR=
/xhtml1/transitional">process-whostate</b></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"xref" href=3D=
"#f_process-whostate" title=3D"Function PROCESS-WHOSTATE"><b xmlns=3D"http:=
//www.w3.org/TR/xhtml1/transitional">process-whostate</b></a>
while the process is waiting.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">ticks</span></i>---either a positive integer expressing a duration
- in "ticks" (see <a xmlns=3D"http://www.w3.org/1999/xhtml" href=
=3D"#v_ticks-per-second" title=3D"Variable *TICKS-PER-SECOND*"><b xmlns=3D"=
http://www.w3.org/TR/xhtml1/transitional">*ticks-per-second*</b></a>),
+ in "ticks" (see <a xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"xref" href=3D"#v_ticks-per-second" title=3D"Variable *TICKS-PER-SECOND*=
"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">*ticks-per-second*<=
/b></a>),
or NIL.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">function</span></i>---a function, designated by itself or by a sy=
mbol
which names it.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">args</span></i>---a list of values, appropriate as arguments to
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">fun=
ction</em>.</p>
- <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---T if <span xmlns=3D"http://www.w3.org/1999/xh=
tml"><strong class=3D"function">process-wait-with-timeout</strong></span>
+ <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---T if <span xmlns=3D"http://www.w3.org/1999/xh=
tml" class=3D"function"><strong>process-wait-with-timeout</strong></span>
returned because its <em xmlns=3D"http://www.w3.org/1999/xhtml" =
class=3D"varname">function</em> returned
true, or NIL if it returned because the duration
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">tic=
ks</em> has been exceeded.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id506279">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414318">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If <em class=3D"=
varname">ticks</em> is NIL, behaves exactly like
- <a href=3D"#f_process-wait" title=3D"Function PROCESS-WAIT"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">process-wait</b></a>, except=
for returning T.
+ <a class=3D"xref" href=3D"#f_process-wait" title=3D"Function PROCES=
S-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-wait<=
/b></a>, except for returning T.
Otherwise, <em class=3D"varname">function</em> will be tested repea=
tedly,
in the same
- kind of test/yield loop as in <a href=3D"#f_process-wait" title=3D"=
Function PROCESS-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional=
">process-wait</b></a>>
+ kind of test/yield loop as in <a class=3D"xref" href=3D"#f_process-=
wait" title=3D"Function PROCESS-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtm=
l1/transitional">process-wait</b></a>>
until either <em class=3D"varname">function</em> returns true,
or the duration <em class=3D"varname">ticks</em> has been exceeded.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml"> Having already =
read the descriptions of
- <a href=3D"#f_process-allow-schedule" title=3D"Function PROCESS-ALL=
OW-SCHEDULE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-=
allow-schedule</b></a> and
- <a href=3D"#f_process-wait" title=3D"Function PROCESS-WAIT"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">process-wait</b></a>, the
+ <a class=3D"xref" href=3D"#f_process-allow-schedule" title=3D"Funct=
ion PROCESS-ALLOW-SCHEDULE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transit=
ional">process-allow-schedule</b></a> and
+ <a class=3D"xref" href=3D"#f_process-wait" title=3D"Function PROCES=
S-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-wait<=
/b></a>, the
astute reader has no doubt anticipated the observation that
better alternatives should be used whenever possible.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id506323">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414362">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#v_ticks-per-second" title=3D"Variable *TICKS-PER-SECOND=
*"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">*ticks-per-second*=
</b></a>, <a href=3D"#f_process-whostate" title=3D"Function PROCESS-WHOSTAT=
E"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-whostate</=
b></a>, <a href=3D"#f_process-wait" title=3D"Function PROCESS-WAIT"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">process-wait</b></a>, <a hre=
f=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"http://www.w3.o=
rg/TR/xhtml1/transitional">make-lock</b></a>, <a href=3D"#f_make-read-write=
-lock" title=3D"Function MAKE-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.or=
g/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a href=3D"#f_make-=
semaphore" title=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/=
TR/xhtml1/transitional">make-semaphore</b></a>, <a href=3D"#f_process-input=
-wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/=
TR/xhtml1/transitional">process-input-wait</b></a>, <a href=3D"#f_process-o=
utput-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w=
3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a href=3D"#m_wi=
th-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D"http://w=
ww.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#v_ticks-per-second" title=3D"Variable *T=
ICKS-PER-SECOND*"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">*ti=
cks-per-second*</b></a>, <a class=3D"xref" href=3D"#f_process-whostate" tit=
le=3D"Function PROCESS-WHOSTATE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tr=
ansitional">process-whostate</b></a>, <a class=3D"xref" href=3D"#f_process-=
wait" title=3D"Function PROCESS-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtm=
l1/transitional">process-wait</b></a>, <a class=3D"xref" href=3D"#f_make-lo=
ck" title=3D"Function MAKE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tr=
ansitional">make-lock</b></a>, <a class=3D"xref" href=3D"#f_make-read-write=
-lock" title=3D"Function MAKE-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.or=
g/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class=3D"xref" h=
ref=3D"#f_make-semaphore" title=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"htt=
p://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class=3D"=
xref" href=3D"#f_process-input-wait" title=3D"Function PROCESS-INPUT-WAIT">=
<b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b=
></a>, <a class=3D"xref" href=3D"#f_process-output-wait" title=3D"Function =
PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
process-output-wait</b></a>, <a class=3D"xref" href=3D"#m_with-terminal-inp=
ut" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xh=
tml1/transitional">with-terminal-input</b></a></span>
</div>
</div>
</p>
@@ -6669,7 +6671,7 @@
<a id=3D"m_without-interrupts"></a>
<strong>[Macro]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">without-interrupts</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>without-interrupts</strong></span>
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&b=
ody</em> body =3D> result</code>
</div>
<div class=3D"refentrytitle">Evaluates its body in an environm=
ent in which
@@ -6678,32 +6680,32 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id506410">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414465">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">body</span></i>---an implicit progn.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---the primary value returned by
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">bod=
y</em>.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id506448">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414504">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Executes <em cla=
ss=3D"varname">body</em>
- in an environment in which <a href=3D"#f_process-interrupt" title=
=3D"Function PROCESS-INTERRUPT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tra=
nsitional">process-interrupt</b></a>
+ in an environment in which <a class=3D"xref" href=3D"#f_process-int=
errupt" title=3D"Function PROCESS-INTERRUPT"><b xmlns=3D"http://www.w3.org/=
TR/xhtml1/transitional">process-interrupt</b></a>
requests are
deferred. As noted in the description of
- <a href=3D"#f_process-interrupt" title=3D"Function PROCESS-INTERRUP=
T"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-interrupt<=
/b></a>, this has nothing to do
+ <a class=3D"xref" href=3D"#f_process-interrupt" title=3D"Function P=
ROCESS-INTERRUPT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">pro=
cess-interrupt</b></a>, this has nothing to do
with the
scheduling of other threads; it may be necessary to inhibit
- <a href=3D"#f_process-interrupt" title=3D"Function PROCESS-INTERRUP=
T"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-interrupt<=
/b></a> handling when
+ <a class=3D"xref" href=3D"#f_process-interrupt" title=3D"Function P=
ROCESS-INTERRUPT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">pro=
cess-interrupt</b></a> handling when
(for instance) modifying some data
structure (for which the current thread holds an appropriate lock)
in some manner that's not reentrant.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id506477">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414532">=
</a>
<div class=3D"header">See Also:</div>
<span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist">
- <a href=3D"#f_process-interrupt" title=3D"Function PROCE=
SS-INTERRUPT">
+ <a class=3D"xref" href=3D"#f_process-interrupt" title=3D=
"Function PROCESS-INTERRUPT">
<b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
process-interrupt</b>
</a>
</span>
@@ -6715,7 +6717,7 @@
<a id=3D"f_make-lock"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">make-lock</strong></span> <em xmlns=3D"http://www.w3.org/=
1999/xhtml" class=3D"varname">&optional</em>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>make-lock</strong></span> <em xmlns=3D"http://www.w3.org/=
1999/xhtml" class=3D"varname">&optional</em>
name =3D> lock</code>
</div>
<div class=3D"refentrytitle">Creates and returns a lock object=
, which can
@@ -6724,17 +6726,17 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id506530">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414594">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">name</span></i>---any lisp object; saved as part of
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">loc=
k</em>. Typically a string or symbol
- which may appear in the <a xmlns=3D"http://www.w3.org/1999/xhtml=
" href=3D"#f_process-whostate" title=3D"Function PROCESS-WHOSTATE"><b xmlns=
=3D"http://www.w3.org/TR/xhtml1/transitional">process-whostate</b></a>s
+ which may appear in the <a xmlns=3D"http://www.w3.org/1999/xhtml=
" class=3D"xref" href=3D"#f_process-whostate" title=3D"Function PROCESS-WHO=
STATE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-whosta=
te</b></a>s
of threads which are waiting for <em xmlns=3D"http://www.w3.org/=
1999/xhtml" class=3D"varname">lock</em>.
</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">lock</span></i>---a newly-allocated object of type CCL:LOCK.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id506848">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414641">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Creates and retu=
rns a lock object, which can
be used to synchronize access to some shared resource.
@@ -6744,9 +6746,9 @@
thread.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id506864">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414656">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#m_with-lock-grabbed" title=3D"Macro WITH-LOCK-GRABBED">=
<b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-lock-grabbed</b>=
</a>, <a href=3D"#f_grab-lock" title=3D"Function GRAB-LOCK"><b xmlns=3D"htt=
p://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a>, <a href=3D"#f_rel=
ease-lock" title=3D"Function RELEASE-LOCK"><b xmlns=3D"http://www.w3.org/TR=
/xhtml1/transitional">release-lock</b></a>, <a href=3D"#f_try-lock" title=
=3D"Function TRY-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional=
">try-lock</b></a>, <a href=3D"#f_make-read-write-lock" title=3D"Function M=
AKE-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
make-read-write-lock</b></a>, <a href=3D"#f_make-semaphore" title=3D"Functi=
on MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">ma=
ke-semaphore</b></a>, <a href=3D"#f_process-input-wait" title=3D"Function P=
ROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">pr=
ocess-input-wait</b></a>, <a href=3D"#f_process-output-wait" title=3D"Funct=
ion PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transition=
al">process-output-wait</b></a>, <a href=3D"#m_with-terminal-input" title=
=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tran=
sitional">with-terminal-input</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#m_with-lock-grabbed" title=3D"Macro WITH=
-LOCK-GRABBED"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-l=
ock-grabbed</b></a>, <a class=3D"xref" href=3D"#f_grab-lock" title=3D"Funct=
ion GRAB-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">grab-l=
ock</b></a>, <a class=3D"xref" href=3D"#f_release-lock" title=3D"Function R=
ELEASE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">release-=
lock</b></a>, <a class=3D"xref" href=3D"#f_try-lock" title=3D"Function TRY-=
LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">try-lock</b></a=
>, <a class=3D"xref" href=3D"#f_make-read-write-lock" title=3D"Function MAK=
E-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">ma=
ke-read-write-lock</b></a>, <a class=3D"xref" href=3D"#f_make-semaphore" ti=
tle=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tra=
nsitional">make-semaphore</b></a>, <a class=3D"xref" href=3D"#f_process-inp=
ut-wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.or=
g/TR/xhtml1/transitional">process-input-wait</b></a>, <a class=3D"xref" hre=
f=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>,=
<a class=3D"xref" href=3D"#m_with-terminal-input" title=3D"Macro WITH-TERM=
INAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-term=
inal-input</b></a></span>
</div>
</div>
</p>
@@ -6755,7 +6757,7 @@
<a id=3D"m_with-lock-grabbed"></a>
<strong>[Macro]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">with-lock-grabbed</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>with-lock-grabbed</strong></span>
(lock) <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname"=
>&body</em> body</code>
</div>
<div class=3D"refentrytitle">Waits until a given lock can be o=
btained, then
@@ -6764,7 +6766,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id506951">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414759">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">lock</span></i>---an object of type CCL:LOCK.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">body</span></i>---an implicit progn.</p>
@@ -6772,20 +6774,20 @@
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">bod=
y</em>.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507002">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414810">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Waits until <em =
class=3D"varname">lock</em> is either free or
owned by the calling
thread, then executes <em class=3D"varname">body</em> with the
lock owned by the calling thread. If <em class=3D"varname">lock</em>
- was free when <span><strong class=3D"function">with-lock-grabbed</s=
trong></span> was called,
+ was free when <span class=3D"function"><strong>with-lock-grabbed</s=
trong></span> was called,
it is restored to a free state after <em class=3D"varname">body</em>
is executed.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507032">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414839">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"h=
ttp://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a href=3D"#f_g=
rab-lock" title=3D"Function GRAB-LOCK"><b xmlns=3D"http://www.w3.org/TR/xht=
ml1/transitional">grab-lock</b></a>, <a href=3D"#f_release-lock" title=3D"F=
unction RELEASE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional"=
>release-lock</b></a>, <a href=3D"#f_try-lock" title=3D"Function TRY-LOCK">=
<b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">try-lock</b></a>, <a =
href=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WRITE-LOCK"><b=
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b=
></a>, <a href=3D"#f_make-semaphore" title=3D"Function MAKE-SEMAPHORE"><b x=
mlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <=
a href=3D"#f_process-input-wait" title=3D"Function PROCESS-INPUT-WAIT"><b x=
mlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a=
>, <a href=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT=
"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-output-wait=
</b></a>, <a href=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-I=
NPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-terminal-i=
nput</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-lock" title=3D"Function MAKE-LOCK=
"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, =
<a class=3D"xref" href=3D"#f_grab-lock" title=3D"Function GRAB-LOCK"><b xml=
ns=3D"http://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a>, <a class=
=3D"xref" href=3D"#f_release-lock" title=3D"Function RELEASE-LOCK"><b xmlns=
=3D"http://www.w3.org/TR/xhtml1/transitional">release-lock</b></a>, <a clas=
s=3D"xref" href=3D"#f_try-lock" title=3D"Function TRY-LOCK"><b xmlns=3D"htt=
p://www.w3.org/TR/xhtml1/transitional">try-lock</b></a>, <a class=3D"xref" =
href=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WRITE-LOCK"><b=
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b=
></a>, <a class=3D"xref" href=3D"#f_make-semaphore" title=3D"Function MAKE-=
SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-semap=
hore</b></a>, <a class=3D"xref" href=3D"#f_process-input-wait" title=3D"Fun=
ction PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitio=
nal">process-input-wait</b></a>, <a class=3D"xref" href=3D"#f_process-outpu=
t-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.or=
g/TR/xhtml1/transitional">process-output-wait</b></a>, <a class=3D"xref" hr=
ef=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=
=3D"http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></=
span>
</div>
</div>
</p>
@@ -6794,7 +6796,7 @@
<a id=3D"f_grab-lock"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">grab-lock</strong></span> lock</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>grab-lock</strong></span> lock</code>
</div>
<div class=3D"refentrytitle">Waits until a given lock can be o=
btained, then
obtains it.</div>
@@ -6802,25 +6804,25 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507115">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414939">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">lock</span></i>---an object of type CCL:LOCK.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507137">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414962">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Blocks until <em=
class=3D"varname">lock</em> is owned by the
calling thread.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">The macro <a hre=
f=3D"#m_with-lock-grabbed" title=3D"Macro WITH-LOCK-GRABBED"><b xmlns=3D"ht=
tp://www.w3.org/TR/xhtml1/transitional">with-lock-grabbed</b></a>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">The macro <a cla=
ss=3D"xref" href=3D"#m_with-lock-grabbed" title=3D"Macro WITH-LOCK-GRABBED"=
><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-lock-grabbed</b=
></a>
<span class=3D"emphasis"><em>could</em></span> be defined in
- terms of <span><strong class=3D"function">grab-lock</strong></span>=
and
- <a href=3D"#f_release-lock" title=3D"Function RELEASE-LOCK"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">release-lock</b></a>, but it=
is actually
+ terms of <span class=3D"function"><strong>grab-lock</strong></span>=
and
+ <a class=3D"xref" href=3D"#f_release-lock" title=3D"Function RELEAS=
E-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">release-lock<=
/b></a>, but it is actually
implemented at a slightly lower level.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507168">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id414995">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"h=
ttp://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a href=3D"#m_w=
ith-lock-grabbed" title=3D"Macro WITH-LOCK-GRABBED"><b xmlns=3D"http://www.=
w3.org/TR/xhtml1/transitional">with-lock-grabbed</b></a>, <a href=3D"#f_rel=
ease-lock" title=3D"Function RELEASE-LOCK"><b xmlns=3D"http://www.w3.org/TR=
/xhtml1/transitional">release-lock</b></a>, <a href=3D"#f_try-lock" title=
=3D"Function TRY-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional=
">try-lock</b></a>, <a href=3D"#f_make-read-write-lock" title=3D"Function M=
AKE-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
make-read-write-lock</b></a>, <a href=3D"#f_make-semaphore" title=3D"Functi=
on MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">ma=
ke-semaphore</b></a>, <a href=3D"#f_process-input-wait" title=3D"Function P=
ROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">pr=
ocess-input-wait</b></a>, <a href=3D"#f_process-output-wait" title=3D"Funct=
ion PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transition=
al">process-output-wait</b></a>, <a href=3D"#m_with-terminal-input" title=
=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tran=
sitional">with-terminal-input</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-lock" title=3D"Function MAKE-LOCK=
"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, =
<a class=3D"xref" href=3D"#m_with-lock-grabbed" title=3D"Macro WITH-LOCK-GR=
ABBED"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-lock-grab=
bed</b></a>, <a class=3D"xref" href=3D"#f_release-lock" title=3D"Function R=
ELEASE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">release-=
lock</b></a>, <a class=3D"xref" href=3D"#f_try-lock" title=3D"Function TRY-=
LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">try-lock</b></a=
>, <a class=3D"xref" href=3D"#f_make-read-write-lock" title=3D"Function MAK=
E-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">ma=
ke-read-write-lock</b></a>, <a class=3D"xref" href=3D"#f_make-semaphore" ti=
tle=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tra=
nsitional">make-semaphore</b></a>, <a class=3D"xref" href=3D"#f_process-inp=
ut-wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.or=
g/TR/xhtml1/transitional">process-input-wait</b></a>, <a class=3D"xref" hre=
f=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>,=
<a class=3D"xref" href=3D"#m_with-terminal-input" title=3D"Macro WITH-TERM=
INAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-term=
inal-input</b></a></span>
</div>
</div>
</p>
@@ -6829,34 +6831,34 @@
<a id=3D"f_release-lock"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">release-lock</strong></span> lock</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>release-lock</strong></span> lock</code>
</div>
<div class=3D"refentrytitle">Relinquishes ownership of a given=
lock.</div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507250">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415094">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">lock</span></i>---an object of type CCL:LOCK.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507272">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415117">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Signals an error=
of type CCL:LOCK-NOT-OWNER if
<em class=3D"varname">lock</em>
is not already owned by the calling thread; otherwise, undoes the
effect of one previous =
- <a href=3D"#f_grab-lock" title=3D"Function GRAB-LOCK"><b xmlns=3D"h=
ttp://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a>. If this means =
that
- <span><strong class=3D"function">release-lock</strong></span> has n=
ow been called on
+ <a class=3D"xref" href=3D"#f_grab-lock" title=3D"Function GRAB-LOCK=
"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a>. =
If this means that
+ <span class=3D"function"><strong>release-lock</strong></span> has n=
ow been called on
<em class=3D"varname">lock</em> the same number of times as
- <a href=3D"#f_grab-lock" title=3D"Function GRAB-LOCK"><b xmlns=3D"h=
ttp://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a> has, <em class=
=3D"varname">lock</em>
+ <a class=3D"xref" href=3D"#f_grab-lock" title=3D"Function GRAB-LOCK=
"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a> h=
as, <em class=3D"varname">lock</em>
becomes free.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507304">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415150">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"h=
ttp://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a href=3D"#m_w=
ith-lock-grabbed" title=3D"Macro WITH-LOCK-GRABBED"><b xmlns=3D"http://www.=
w3.org/TR/xhtml1/transitional">with-lock-grabbed</b></a>, <a href=3D"#f_gra=
b-lock" title=3D"Function GRAB-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml=
1/transitional">grab-lock</b></a>, <a href=3D"#f_try-lock" title=3D"Functio=
n TRY-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">try-lock<=
/b></a>, <a href=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WR=
ITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-w=
rite-lock</b></a>, <a href=3D"#f_make-semaphore" title=3D"Function MAKE-SEM=
APHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-semaphor=
e</b></a>, <a href=3D"#f_process-input-wait" title=3D"Function PROCESS-INPU=
T-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-input=
-wait</b></a>, <a href=3D"#f_process-output-wait" title=3D"Function PROCESS=
-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process=
-output-wait</b></a>, <a href=3D"#m_with-terminal-input" title=3D"Macro WIT=
H-TERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">wit=
h-terminal-input</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-lock" title=3D"Function MAKE-LOCK=
"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, =
<a class=3D"xref" href=3D"#m_with-lock-grabbed" title=3D"Macro WITH-LOCK-GR=
ABBED"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-lock-grab=
bed</b></a>, <a class=3D"xref" href=3D"#f_grab-lock" title=3D"Function GRAB=
-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">grab-lock</b><=
/a>, <a class=3D"xref" href=3D"#f_try-lock" title=3D"Function TRY-LOCK"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">try-lock</b></a>, <a cla=
ss=3D"xref" href=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WR=
ITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-w=
rite-lock</b></a>, <a class=3D"xref" href=3D"#f_make-semaphore" title=3D"Fu=
nction MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional=
">make-semaphore</b></a>, <a class=3D"xref" href=3D"#f_process-input-wait" =
title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtm=
l1/transitional">process-input-wait</b></a>, <a class=3D"xref" href=3D"#f_p=
rocess-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http=
://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class=
=3D"xref" href=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPU=
T"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-terminal-inpu=
t</b></a></span>
</div>
</div>
</p>
@@ -6865,7 +6867,7 @@
<a id=3D"f_try-lock"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">try-lock</strong></span> lock =3D> result</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>try-lock</strong></span> lock =3D> result</code>
</div>
<div class=3D"refentrytitle">Obtains the given lock, but only =
if it is not
necessary to wait for it.</div>
@@ -6873,19 +6875,19 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507388">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415251">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">lock</span></i>---an object of type CCL:LOCK.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---T if <em xmlns=3D"http://www.w3.org/1999/xhtm=
l" class=3D"varname">lock</em> has been obtained,
or NIL if it has not.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507427">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415289">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Tests whether <e=
m class=3D"varname">lock</em>
can be obtained without blocking - that is, either
<em class=3D"varname">lock</em> is already free, or it is already o=
wned
- by <a href=3D"#v_current-process" title=3D"Variable *CURRENT-PROCES=
S*"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">*current-process*=
</b></a>. If it can,
+ by <a class=3D"xref" href=3D"#v_current-process" title=3D"Variable =
*CURRENT-PROCESS*"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">*c=
urrent-process*</b></a>. If it can,
causes it to
be owned by the calling lisp process (thread) and returns T.
Otherwise, the lock
@@ -6893,9 +6895,9 @@
blocking; NIL is returned in this case.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507453">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415312">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"h=
ttp://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a href=3D"#m_w=
ith-lock-grabbed" title=3D"Macro WITH-LOCK-GRABBED"><b xmlns=3D"http://www.=
w3.org/TR/xhtml1/transitional">with-lock-grabbed</b></a>, <a href=3D"#f_gra=
b-lock" title=3D"Function GRAB-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml=
1/transitional">grab-lock</b></a>, <a href=3D"#f_release-lock" title=3D"Fun=
ction RELEASE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">r=
elease-lock</b></a>, <a href=3D"#f_make-read-write-lock" title=3D"Function =
MAKE-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional"=
>make-read-write-lock</b></a>, <a href=3D"#f_make-semaphore" title=3D"Funct=
ion MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">m=
ake-semaphore</b></a>, <a href=3D"#f_process-input-wait" title=3D"Function =
PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">p=
rocess-input-wait</b></a>, <a href=3D"#f_process-output-wait" title=3D"Func=
tion PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitio=
nal">process-output-wait</b></a>, <a href=3D"#m_with-terminal-input" title=
=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tran=
sitional">with-terminal-input</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-lock" title=3D"Function MAKE-LOCK=
"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, =
<a class=3D"xref" href=3D"#m_with-lock-grabbed" title=3D"Macro WITH-LOCK-GR=
ABBED"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-lock-grab=
bed</b></a>, <a class=3D"xref" href=3D"#f_grab-lock" title=3D"Function GRAB=
-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">grab-lock</b><=
/a>, <a class=3D"xref" href=3D"#f_release-lock" title=3D"Function RELEASE-L=
OCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">release-lock</b>=
</a>, <a class=3D"xref" href=3D"#f_make-read-write-lock" title=3D"Function =
MAKE-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional"=
>make-read-write-lock</b></a>, <a class=3D"xref" href=3D"#f_make-semaphore"=
title=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/=
transitional">make-semaphore</b></a>, <a class=3D"xref" href=3D"#f_process-=
input-wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3=
.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class=3D"xref" =
href=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b x=
mlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></=
a>, <a class=3D"xref" href=3D"#m_with-terminal-input" title=3D"Macro WITH-T=
ERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-t=
erminal-input</b></a></span>
</div>
</div>
</p>
@@ -6904,7 +6906,7 @@
<a id=3D"f_make-read-write-lock"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">make-read-write-lock</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>make-read-write-lock</strong></span>
=3D> read-write-lock</code>
</div>
<div class=3D"refentrytitle">Creates and returns a read-write =
lock, which can
@@ -6913,13 +6915,13 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507537">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415412">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">read-write-lock</span></i>---a newly-allocated object of type
CCL:READ-WRITE-LOCK.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507560">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415435">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Creates and retu=
rns an object of type CCL::READ-WRITE-LOCK.
A read-write lock may, at any given time, belong to any number
@@ -6930,12 +6932,12 @@
no readers and no writers.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507580">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415451">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#m_with-read-lock" title=3D"Macro WITH-READ-LOCK"><b xml=
ns=3D"http://www.w3.org/TR/xhtml1/transitional">with-read-lock</b></a>, <a =
href=3D"#m_with-write-lock" title=3D"Macro WITH-WRITE-LOCK"><b xmlns=3D"htt=
p://www.w3.org/TR/xhtml1/transitional">with-write-lock</b></a>, <a href=3D"=
#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"http://www.w3.org/TR=
/xhtml1/transitional">make-lock</b></a>, <a href=3D"#f_make-semaphore" titl=
e=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/trans=
itional">make-semaphore</b></a>, <a href=3D"#f_process-input-wait" title=3D=
"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/trans=
itional">process-input-wait</b></a>, <a href=3D"#f_process-output-wait" tit=
le=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1=
/transitional">process-output-wait</b></a>, <a href=3D"#m_with-terminal-inp=
ut" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xh=
tml1/transitional">with-terminal-input</b></a></span>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507620">=
</a>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#m_with-read-lock" title=3D"Macro WITH-RE=
AD-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-read-lo=
ck</b></a>, <a class=3D"xref" href=3D"#m_with-write-lock" title=3D"Macro WI=
TH-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-w=
rite-lock</b></a>, <a class=3D"xref" href=3D"#f_make-lock" title=3D"Functio=
n MAKE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-loc=
k</b></a>, <a class=3D"xref" href=3D"#f_make-semaphore" title=3D"Function M=
AKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-s=
emaphore</b></a>, <a class=3D"xref" href=3D"#f_process-input-wait" title=3D=
"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/trans=
itional">process-input-wait</b></a>, <a class=3D"xref" href=3D"#f_process-o=
utput-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w=
3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class=3D"xref=
" href=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xm=
lns=3D"http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a=
></span>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415499">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">There probably s=
hould be some way to
atomically "promote" a reader, making it a writer without
@@ -6948,7 +6950,7 @@
<a id=3D"m_with-read-lock"></a>
<strong>[Macro]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">with-read-lock</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>with-read-lock</strong></span>
(read-write-lock) <em xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"varname">&body</em> body =3D> result</code>
</div>
<div class=3D"refentrytitle">Waits until a given lock is avail=
able for
@@ -6958,7 +6960,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507671">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415556">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">read-write-lock</span></i>---an object of type
CCL:READ-WRITE-LOCK.</p>
@@ -6967,23 +6969,23 @@
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">bod=
y</em>.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507723">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415607">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Waits until <em =
class=3D"varname">read-write-lock</em> has no
writer,
- ensures that <a href=3D"#v_current-process" title=3D"Variable *CURR=
ENT-PROCESS*"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">*curren=
t-process*</b></a> is a
+ ensures that <a class=3D"xref" href=3D"#v_current-process" title=3D=
"Variable *CURRENT-PROCESS*"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transi=
tional">*current-process*</b></a> is a
reader of it, then executes <em class=3D"varname">body</em>.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">After executing =
<em class=3D"varname">body</em>, if
- <a href=3D"#v_current-process" title=3D"Variable *CURRENT-PROCESS*"=
><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">*current-process*</b=
></a> was not a reader of
+ <a class=3D"xref" href=3D"#v_current-process" title=3D"Variable *CU=
RRENT-PROCESS*"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">*curr=
ent-process*</b></a> was not a reader of
<em class=3D"varname">read-write-lock</em> before
- <span><strong class=3D"function">with-read-lock</strong></span> was=
called, the lock is
+ <span class=3D"function"><strong>with-read-lock</strong></span> was=
called, the lock is
released. If it was already a reader, it remains one.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507760">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415647">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WRI=
TE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-wr=
ite-lock</b></a>, <a href=3D"#m_with-write-lock" title=3D"Macro WITH-WRITE-=
LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-write-lock=
</b></a>, <a href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D=
"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a href=3D"#f=
_make-semaphore" title=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w=
3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a href=3D"#f_process=
-input-wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w=
3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a href=3D"#f_pro=
cess-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http:/=
/www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a href=3D=
"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D"ht=
tp://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-read-write-lock" title=3D"Functio=
n MAKE-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitiona=
l">make-read-write-lock</b></a>, <a class=3D"xref" href=3D"#m_with-write-lo=
ck" title=3D"Macro WITH-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1=
/transitional">with-write-lock</b></a>, <a class=3D"xref" href=3D"#f_make-l=
ock" title=3D"Function MAKE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/t=
ransitional">make-lock</b></a>, <a class=3D"xref" href=3D"#f_make-semaphore=
" title=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1=
/transitional">make-semaphore</b></a>, <a class=3D"xref" href=3D"#f_process=
-input-wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w=
3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class=3D"xref"=
href=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b><=
/a>, <a class=3D"xref" href=3D"#m_with-terminal-input" title=3D"Macro WITH-=
TERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-=
terminal-input</b></a></span>
</div>
</div>
</p>
@@ -6992,7 +6994,7 @@
<a id=3D"m_with-write-lock"></a>
<strong>[Macro]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">with-write-lock</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>with-write-lock</strong></span>
(read-write-lock) <em xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"varname">&body</em> body</code>
</div>
<div class=3D"refentrytitle">Waits until the given lock is ava=
ilable for write
@@ -7001,7 +7003,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507839">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415740">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">read-write-lock</span></i>---an object of type
CCL:READ-WRITE-LOCK.</p>
@@ -7010,24 +7012,24 @@
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">bod=
y</em>.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507891">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415791">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Waits until <em =
class=3D"varname">read-write-lock</em> has no
- readers and no writer other than <a href=3D"#v_current-process" tit=
le=3D"Variable *CURRENT-PROCESS*"><b xmlns=3D"http://www.w3.org/TR/xhtml1/t=
ransitional">*current-process*</b></a>,
- then ensures that <a href=3D"#v_current-process" title=3D"Variable =
*CURRENT-PROCESS*"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">*c=
urrent-process*</b></a> is the
+ readers and no writer other than <a class=3D"xref" href=3D"#v_curre=
nt-process" title=3D"Variable *CURRENT-PROCESS*"><b xmlns=3D"http://www.w3.=
org/TR/xhtml1/transitional">*current-process*</b></a>,
+ then ensures that <a class=3D"xref" href=3D"#v_current-process" tit=
le=3D"Variable *CURRENT-PROCESS*"><b xmlns=3D"http://www.w3.org/TR/xhtml1/t=
ransitional">*current-process*</b></a> is the
writer of it. With the lock held, executes <em class=3D"varname">b=
ody</em>.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">After executing =
<em class=3D"varname">body</em>, if
- <a href=3D"#v_current-process" title=3D"Variable *CURRENT-PROCESS*"=
><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">*current-process*</b=
></a> was not the writer of
+ <a class=3D"xref" href=3D"#v_current-process" title=3D"Variable *CU=
RRENT-PROCESS*"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">*curr=
ent-process*</b></a> was not the writer of
<em class=3D"varname">read-write-lock</em> before
- <span><strong class=3D"function">with-write-lock</strong></span> wa=
s called, the lock is
+ <span class=3D"function"><strong>with-write-lock</strong></span> wa=
s called, the lock is
released. If it was already the writer, it remains the
writer.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id507933">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415836">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WRI=
TE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-wr=
ite-lock</b></a>, <a href=3D"#m_with-read-lock" title=3D"Macro WITH-READ-LO=
CK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-read-lock</b=
></a>, <a href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"ht=
tp://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a href=3D"#f_ma=
ke-semaphore" title=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.o=
rg/TR/xhtml1/transitional">make-semaphore</b></a>, <a href=3D"#f_process-in=
put-wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.o=
rg/TR/xhtml1/transitional">process-input-wait</b></a>, <a href=3D"#f_proces=
s-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://ww=
w.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a href=3D"#m=
_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D"http:=
//www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-read-write-lock" title=3D"Functio=
n MAKE-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitiona=
l">make-read-write-lock</b></a>, <a class=3D"xref" href=3D"#m_with-read-loc=
k" title=3D"Macro WITH-READ-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/t=
ransitional">with-read-lock</b></a>, <a class=3D"xref" href=3D"#f_make-lock=
" title=3D"Function MAKE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tran=
sitional">make-lock</b></a>, <a class=3D"xref" href=3D"#f_make-semaphore" t=
itle=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tr=
ansitional">make-semaphore</b></a>, <a class=3D"xref" href=3D"#f_process-in=
put-wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.o=
rg/TR/xhtml1/transitional">process-input-wait</b></a>, <a class=3D"xref" hr=
ef=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xml=
ns=3D"http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>=
, <a class=3D"xref" href=3D"#m_with-terminal-input" title=3D"Macro WITH-TER=
MINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-ter=
minal-input</b></a></span>
</div>
</div>
</p>
@@ -7036,7 +7038,7 @@
<a id=3D"f_make-semaphore"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">make-semaphore</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>make-semaphore</strong></span>
=3D> semaphore</code>
</div>
<div class=3D"refentrytitle">Creates and returns a semaphore, =
which can be used
@@ -7045,12 +7047,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508009">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415926">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">semaphore</span></i>---a newly-allocated object of type CCL:SEMAP=
HORE.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508031">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415948">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Creates and retu=
rns an object of type CCL:SEMAPHORE.
A semaphore has an associated "count" which may be incremented
@@ -7059,9 +7061,9 @@
<em class=3D"varname">semaphore</em> has an initial count of 0.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508048">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id415963">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_signal-semaphore" title=3D"Function SIGNAL-SEMAPHORE"=
><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">signal-semaphore</b>=
</a>, <a href=3D"#f_wait-on-semaphore" title=3D"Function WAIT-ON-SEMAPHORE"=
><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">wait-on-semaphore</b=
></a>, <a href=3D"#f_timed-wait-on-semaphore" title=3D"Function TIMED-WAIT-=
ON-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">timed-w=
ait-on-semaphore</b></a>, <a href=3D"#f_make-lock" title=3D"Function MAKE-L=
OCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a=
>, <a href=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WRITE-LO=
CK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-write-l=
ock</b></a>, <a href=3D"#f_process-input-wait" title=3D"Function PROCESS-IN=
PUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-inp=
ut-wait</b></a>, <a href=3D"#f_process-output-wait" title=3D"Function PROCE=
SS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">proce=
ss-output-wait</b></a>, <a href=3D"#m_with-terminal-input" title=3D"Macro W=
ITH-TERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">w=
ith-terminal-input</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_signal-semaphore" title=3D"Function SI=
GNAL-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">signa=
l-semaphore</b></a>, <a class=3D"xref" href=3D"#f_wait-on-semaphore" title=
=3D"Function WAIT-ON-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tra=
nsitional">wait-on-semaphore</b></a>, <a class=3D"xref" href=3D"#f_timed-wa=
it-on-semaphore" title=3D"Function TIMED-WAIT-ON-SEMAPHORE"><b xmlns=3D"htt=
p://www.w3.org/TR/xhtml1/transitional">timed-wait-on-semaphore</b></a>, <a =
class=3D"xref" href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=
=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class=
=3D"xref" href=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WRIT=
E-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-wri=
te-lock</b></a>, <a class=3D"xref" href=3D"#f_process-input-wait" title=3D"=
Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transi=
tional">process-input-wait</b></a>, <a class=3D"xref" href=3D"#f_process-ou=
tput-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3=
.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class=3D"xref"=
href=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xml=
ns=3D"http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a>=
</span>
</div>
</div>
</p>
@@ -7070,7 +7072,7 @@
<a id=3D"f_signal-semaphore"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">signal-semaphore</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>signal-semaphore</strong></span>
semaphore =3D> result</code>
</div>
<div class=3D"refentrytitle">Atomically increments the count o=
f a given
@@ -7079,29 +7081,29 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508127">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416058">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">semaphore</span></i>---an object of type CCL:SEMAPHORE.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---an integer representing an error identifier
which was returned by the underlying OS call.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508164">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416094">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Atomically incre=
ments <em class=3D"varname">semaphore</em>'s
"count" by 1; this
may enable a waiting thread to resume execution.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508179">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416108">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-semaphore" title=3D"Function MAKE-SEMAPHORE"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, =
<a href=3D"#f_wait-on-semaphore" title=3D"Function WAIT-ON-SEMAPHORE"><b xm=
lns=3D"http://www.w3.org/TR/xhtml1/transitional">wait-on-semaphore</b></a>,=
<a href=3D"#f_timed-wait-on-semaphore" title=3D"Function TIMED-WAIT-ON-SEM=
APHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">timed-wait-on=
-semaphore</b></a>, <a href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><=
b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a =
href=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WRITE-LOCK"><b=
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b=
></a>, <a href=3D"#f_process-input-wait" title=3D"Function PROCESS-INPUT-WA=
IT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-input-wai=
t</b></a>, <a href=3D"#f_process-output-wait" title=3D"Function PROCESS-OUT=
PUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-out=
put-wait</b></a>, <a href=3D"#m_with-terminal-input" title=3D"Macro WITH-TE=
RMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-te=
rminal-input</b></a></span>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508226">=
</a>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-semaphore" title=3D"Function MAKE=
-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-sema=
phore</b></a>, <a class=3D"xref" href=3D"#f_wait-on-semaphore" title=3D"Fun=
ction WAIT-ON-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transition=
al">wait-on-semaphore</b></a>, <a class=3D"xref" href=3D"#f_timed-wait-on-s=
emaphore" title=3D"Function TIMED-WAIT-ON-SEMAPHORE"><b xmlns=3D"http://www=
.w3.org/TR/xhtml1/transitional">timed-wait-on-semaphore</b></a>, <a class=
=3D"xref" href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"ht=
tp://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class=3D"xref=
" href=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WRITE-LOCK">=
<b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock<=
/b></a>, <a class=3D"xref" href=3D"#f_process-input-wait" title=3D"Function=
PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
process-input-wait</b></a>, <a class=3D"xref" href=3D"#f_process-output-wai=
t" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/=
xhtml1/transitional">process-output-wait</b></a>, <a class=3D"xref" href=3D=
"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D"ht=
tp://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416161">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml"><em class=3D"var=
name">result</em> should probably be interpreted
- and acted on by <span><strong class=3D"function">signal-semaphore</=
strong></span>, because
+ and acted on by <span class=3D"function"><strong>signal-semaphore</=
strong></span>, because
it is not likely to be meaningful to a lisp program, and the
most common cause of failure is a type error.</p>
</div>
@@ -7112,7 +7114,7 @@
<a id=3D"f_wait-on-semaphore"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">wait-on-semaphore</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>wait-on-semaphore</strong></span>
semaphore =3D> result</code>
</div>
<div class=3D"refentrytitle">Waits until the given semaphore h=
as a positive
@@ -7121,14 +7123,14 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508281">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416221">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">semaphore</span></i>---an object of type CCL:SEMAPHORE.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---an integer representing an error identifier
which was returned by the underlying OS call.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508319">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416257">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Waits until <em =
class=3D"varname">semaphore</em>
has a positive count that can be
@@ -7136,15 +7138,15 @@
corresponding call to SIGNAL-SEMAPHORE.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508334">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416272">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-semaphore" title=3D"Function MAKE-SEMAPHORE"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, =
<a href=3D"#f_signal-semaphore" title=3D"Function SIGNAL-SEMAPHORE"><b xmln=
s=3D"http://www.w3.org/TR/xhtml1/transitional">signal-semaphore</b></a>, <a=
href=3D"#f_timed-wait-on-semaphore" title=3D"Function TIMED-WAIT-ON-SEMAPH=
ORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">timed-wait-on-se=
maphore</b></a>, <a href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b x=
mlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a hre=
f=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WRITE-LOCK"><b xm=
lns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></=
a>, <a href=3D"#f_process-input-wait" title=3D"Function PROCESS-INPUT-WAIT"=
><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-input-wait</=
b></a>, <a href=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT=
-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-output=
-wait</b></a>, <a href=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMI=
NAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-termi=
nal-input</b></a></span>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508386">=
</a>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-semaphore" title=3D"Function MAKE=
-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-sema=
phore</b></a>, <a class=3D"xref" href=3D"#f_signal-semaphore" title=3D"Func=
tion SIGNAL-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional=
">signal-semaphore</b></a>, <a class=3D"xref" href=3D"#f_timed-wait-on-sema=
phore" title=3D"Function TIMED-WAIT-ON-SEMAPHORE"><b xmlns=3D"http://www.w3=
.org/TR/xhtml1/transitional">timed-wait-on-semaphore</b></a>, <a class=3D"x=
ref" href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"http://=
www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class=3D"xref" hre=
f=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WRITE-LOCK"><b xm=
lns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></=
a>, <a class=3D"xref" href=3D"#f_process-input-wait" title=3D"Function PROC=
ESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">proce=
ss-input-wait</b></a>, <a class=3D"xref" href=3D"#f_process-output-wait" ti=
tle=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml=
1/transitional">process-output-wait</b></a>, <a class=3D"xref" href=3D"#m_w=
ith-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D"http://=
www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416325">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml"><em class=3D"var=
name">result</em> should probably be interpreted
- and acted on by <span><strong class=3D"function">wait-on-semaphore<=
/strong></span>, because
+ and acted on by <span class=3D"function"><strong>wait-on-semaphore<=
/strong></span>, because
it is not likely to be meaningful to a lisp program, and the
most common cause of failure is a type error.</p>
</div>
@@ -7155,7 +7157,7 @@
<a id=3D"f_timed-wait-on-semaphore"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">timed-wait-on-semaphore</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>timed-wait-on-semaphore</strong></span>
semaphore timeout =3D> result</code>
</div>
<div class=3D"refentrytitle">Waits until the given semaphore h=
as a positive
@@ -7165,20 +7167,20 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508442">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416385">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">semaphore</span></i>---An object of type CCL:SEMAPHORE.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">timeout</span></i>---a time interval in seconds. May be any
- non-negative real number the <span xmlns=3D"http://www.w3.org/19=
99/xhtml"><strong class=3D"function">floor</strong></span> of
+ non-negative real number the <span xmlns=3D"http://www.w3.org/19=
99/xhtml" class=3D"function"><strong>floor</strong></span> of
which fits in 32 bits. The default is 1.</p>
- <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---T if <span xmlns=3D"http://www.w3.org/1999/xh=
tml"><strong class=3D"function">timed-wait-on-semaphore</strong></span>
+ <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---T if <span xmlns=3D"http://www.w3.org/1999/xh=
tml" class=3D"function"><strong>timed-wait-on-semaphore</strong></span>
returned because it was able to decrement the count of
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">sem=
aphore</em>; NIL if it returned because
the duration <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D=
"varname">timeout</em> has been
exceeded.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508509">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416451">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Waits until <em =
class=3D"varname">semaphore</em>
has a positive count that can be
@@ -7187,9 +7189,9 @@
elapsed.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508527">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416468">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-semaphore" title=3D"Function MAKE-SEMAPHORE"><b =
xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, =
<a href=3D"#f_wait-on-semaphore" title=3D"Function WAIT-ON-SEMAPHORE"><b xm=
lns=3D"http://www.w3.org/TR/xhtml1/transitional">wait-on-semaphore</b></a>,=
<a href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"http://w=
ww.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a href=3D"#f_make-rea=
d-write-lock" title=3D"Function MAKE-READ-WRITE-LOCK"><b xmlns=3D"http://ww=
w.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a href=3D"#=
f_process-input-wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"htt=
p://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a href=
=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=
=3D"http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, =
<a href=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b x=
mlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></=
a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-semaphore" title=3D"Function MAKE=
-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-sema=
phore</b></a>, <a class=3D"xref" href=3D"#f_wait-on-semaphore" title=3D"Fun=
ction WAIT-ON-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transition=
al">wait-on-semaphore</b></a>, <a class=3D"xref" href=3D"#f_make-lock" titl=
e=3D"Function MAKE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transition=
al">make-lock</b></a>, <a class=3D"xref" href=3D"#f_make-read-write-lock" t=
itle=3D"Function MAKE-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xht=
ml1/transitional">make-read-write-lock</b></a>, <a class=3D"xref" href=3D"#=
f_process-input-wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"htt=
p://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class=
=3D"xref" href=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT-=
WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-output-=
wait</b></a>, <a class=3D"xref" href=3D"#m_with-terminal-input" title=3D"Ma=
cro WITH-TERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transition=
al">with-terminal-input</b></a></span>
</div>
</div>
</p>
@@ -7198,7 +7200,7 @@
<a id=3D"f_process-input-wait"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-input-wait</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-input-wait</strong></span>
fd <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&am=
p;optional</em> timeout</code>
</div>
<div class=3D"refentrytitle">Waits until input is available on=
a given
@@ -7207,21 +7209,21 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508613">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416561">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">fd</span></i>---a file descriptor, which is a non-negative integer
used by the OS to refer to an open file, socket, or similar
- I/O connection. See <a xmlns=3D"http://www.w3.org/1999/xhtml" h=
ref=3D"#f_stream-device" title=3D"Generic Function CCL::STREAM-DEVICE"><b x=
mlns=3D"http://www.w3.org/TR/xhtml1/transitional">ccl::stream-device</b></a=
>.</p>
+ I/O connection. See <a xmlns=3D"http://www.w3.org/1999/xhtml" c=
lass=3D"xref" href=3D"#f_stream-device" title=3D"Generic Function CCL::STRE=
AM-DEVICE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">ccl::strea=
m-device</b></a>.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">timeout</span></i>---either NIL or a time interval in millisecond=
s. Must be a non-negative integer. The default is NIL.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508657">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416603">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Wait until input=
is available on <em class=3D"varname">fd</em>.
- This uses the <span><strong class=3D"function">select()</strong></s=
pan> system call, and is
+ This uses the <span class=3D"function"><strong>select()</strong></s=
pan> system call, and is
generally a fairly
efficient way of blocking while waiting for input. More
- accurately, <span><strong class=3D"function">process-input-wait</st=
rong></span>
+ accurately, <span class=3D"function"><strong>process-input-wait</st=
rong></span>
waits until it's possible to read
from fd without blocking, or until <em class=3D"varname">timeout</e=
m>, if
it is not NIL, has been exceeded.</p>
@@ -7231,17 +7233,17 @@
return zero bytes.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508690">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416636">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"h=
ttp://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a href=3D"#f_m=
ake-read-write-lock" title=3D"Function MAKE-READ-WRITE-LOCK"><b xmlns=3D"ht=
tp://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a hr=
ef=3D"#f_make-semaphore" title=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http=
://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a href=3D"#f=
_process-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"ht=
tp://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a hre=
f=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=
=3D"http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></=
span>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508727">=
</a>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-lock" title=3D"Function MAKE-LOCK=
"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, =
<a class=3D"xref" href=3D"#f_make-read-write-lock" title=3D"Function MAKE-R=
EAD-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-=
read-write-lock</b></a>, <a class=3D"xref" href=3D"#f_make-semaphore" title=
=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transi=
tional">make-semaphore</b></a>, <a class=3D"xref" href=3D"#f_process-output=
-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org=
/TR/xhtml1/transitional">process-output-wait</b></a>, <a class=3D"xref" hre=
f=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=
=3D"http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></=
span>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416674">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <span><strong class=3D"function">process-input-wait</strong></span>=
has a timeout parameter,
+ <span class=3D"function"><strong>process-input-wait</strong></span>=
has a timeout parameter,
and
- <a href=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT=
-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-output=
-wait</b></a> does not. This
+ <a class=3D"xref" href=3D"#f_process-output-wait" title=3D"Function=
PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional"=
>process-output-wait</b></a> does not. This
inconsistency should probably be corrected.
</p>
</div>
@@ -7252,7 +7254,7 @@
<a id=3D"f_process-output-wait"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">process-output-wait</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>process-output-wait</strong></span>
fd <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&a=
mp;optional</em> timeout</code>
</div>
<div class=3D"refentrytitle">Waits until output is possible on=
a given file
@@ -7261,38 +7263,38 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508785">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416738">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">fd</span></i>---a file descriptor, which is a non-negative integer
used by the OS to refer to an open file, socket, or similar
- I/O connection. See <a xmlns=3D"http://www.w3.org/1999/xhtml" h=
ref=3D"#f_stream-device" title=3D"Generic Function CCL::STREAM-DEVICE"><b x=
mlns=3D"http://www.w3.org/TR/xhtml1/transitional">ccl::stream-device</b></a=
>.</p>
+ I/O connection. See <a xmlns=3D"http://www.w3.org/1999/xhtml" c=
lass=3D"xref" href=3D"#f_stream-device" title=3D"Generic Function CCL::STRE=
AM-DEVICE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">ccl::strea=
m-device</b></a>.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">timeout</span></i>---either NIL or a time interval in millisecond=
s. Must be a non-negative integer. The default is NIL.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508829">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416780">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Wait until outpu=
t is possible on <em class=3D"varname">fd</em> or until <em class=3D"varnam=
e">timeout</em>, if
it is not NIL, has been exceeded.
- This uses the <span><strong class=3D"function">select()</strong></s=
pan> system call, and is
+ This uses the <span class=3D"function"><strong>select()</strong></s=
pan> system call, and is
generally a fairly
efficient way of blocking while waiting to output.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">If <span><strong=
class=3D"function">process-output-wait</strong></span> is called on
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">If <span class=
=3D"function"><strong>process-output-wait</strong></span> is called on
a network socket which has not yet established a connection, it
will wait until the connection is established. This is an
important use, often overlooked.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508862">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416813">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"h=
ttp://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a href=3D"#f_m=
ake-read-write-lock" title=3D"Function MAKE-READ-WRITE-LOCK"><b xmlns=3D"ht=
tp://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a hr=
ef=3D"#f_make-semaphore" title=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http=
://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a href=3D"#f=
_process-input-wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http=
://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a href=
=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D=
"http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></spa=
n>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508899">=
</a>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#f_make-lock" title=3D"Function MAKE-LOCK=
"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, =
<a class=3D"xref" href=3D"#f_make-read-write-lock" title=3D"Function MAKE-R=
EAD-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-=
read-write-lock</b></a>, <a class=3D"xref" href=3D"#f_make-semaphore" title=
=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transi=
tional">make-semaphore</b></a>, <a class=3D"xref" href=3D"#f_process-input-=
wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/T=
R/xhtml1/transitional">process-input-wait</b></a>, <a class=3D"xref" href=
=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INPUT"><b xmlns=3D=
"http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></spa=
n>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416850">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a href=3D"#f_process-input-wait" title=3D"Function PROCESS-INPUT-W=
AIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-input-wa=
it</b></a> has a timeout parameter,
+ <a class=3D"xref" href=3D"#f_process-input-wait" title=3D"Function =
PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">p=
rocess-input-wait</b></a> has a timeout parameter,
and
- <span><strong class=3D"function">process-output-wait</strong></span=
> does not. This
+ <span class=3D"function"><strong>process-output-wait</strong></span=
> does not. This
inconsistency should probably be corrected.
</p>
</div>
@@ -7303,7 +7305,7 @@
<a id=3D"m_with-terminal-input"></a>
<strong>[Macro]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">with-terminal-input</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>with-terminal-input</strong></span>
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&b=
ody</em> body =3D> result</code>
</div>
<div class=3D"refentrytitle">Executes its body in an environme=
nt with exclusive
@@ -7312,14 +7314,14 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508957">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416915">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">body</span></i>---an implicit progn.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---the primary value returned by
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">bod=
y</em>.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id508996">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416954">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Requests exclusi=
ve read access to the standard terminal
stream, <em class=3D"varname">*terminal-io*</em>. Executes
@@ -7327,9 +7329,9 @@
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id509014">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416970">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#v_request-terminal-input-via-break" title=3D"Variable *=
REQUEST-TERMINAL-INPUT-VIA-BREAK*"><b xmlns=3D"http://www.w3.org/TR/xhtml1/=
transitional">*request-terminal-input-via-break*</b></a>, <a href=3D"#cmd_y=
" title=3D"Toplevel Command :Y"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tra=
nsitional">:y</b></a>, <a href=3D"#f_make-lock" title=3D"Function MAKE-LOCK=
"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, =
<a href=3D"#f_make-read-write-lock" title=3D"Function MAKE-READ-WRITE-LOCK"=
><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock=
</b></a>, <a href=3D"#f_make-semaphore" title=3D"Function MAKE-SEMAPHORE"><=
b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>=
, <a href=3D"#f_process-input-wait" title=3D"Function PROCESS-INPUT-WAIT"><=
b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b>=
</a>, <a href=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT-W=
AIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-output-w=
ait</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#v_request-terminal-input-via-break" titl=
e=3D"Variable *REQUEST-TERMINAL-INPUT-VIA-BREAK*"><b xmlns=3D"http://www.w3=
.org/TR/xhtml1/transitional">*request-terminal-input-via-break*</b></a>, <a=
class=3D"xref" href=3D"#cmd_y" title=3D"Toplevel Command :Y"><b xmlns=3D"h=
ttp://www.w3.org/TR/xhtml1/transitional">:y</b></a>, <a class=3D"xref" href=
=3D"#f_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"http://www.w3.or=
g/TR/xhtml1/transitional">make-lock</b></a>, <a class=3D"xref" href=3D"#f_m=
ake-read-write-lock" title=3D"Function MAKE-READ-WRITE-LOCK"><b xmlns=3D"ht=
tp://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a cl=
ass=3D"xref" href=3D"#f_make-semaphore" title=3D"Function MAKE-SEMAPHORE"><=
b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>=
, <a class=3D"xref" href=3D"#f_process-input-wait" title=3D"Function PROCES=
S-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process=
-input-wait</b></a>, <a class=3D"xref" href=3D"#f_process-output-wait" titl=
e=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/=
transitional">process-output-wait</b></a></span>
</div>
</div>
</p>
@@ -7346,17 +7348,17 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id509094">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417047">=
</a>
<div class=3D"header">Value Type:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A boolean.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id509104">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417057">=
</a>
<div class=3D"header">Initial Value:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">NIL.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id509114">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417067">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Controls how att=
empts to obtain ownership of terminal input
are made. When NIL, a message is printed on *TERMINAL-IO*;
@@ -7368,9 +7370,9 @@
loop.)</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id509131">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417080">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INP=
UT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-terminal-inp=
ut</b></a>, <a href=3D"#cmd_y" title=3D"Toplevel Command :Y"><b xmlns=3D"ht=
tp://www.w3.org/TR/xhtml1/transitional">:y</b></a>, <a href=3D"#f_make-lock=
" title=3D"Function MAKE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/tran=
sitional">make-lock</b></a>, <a href=3D"#f_make-read-write-lock" title=3D"F=
unction MAKE-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/trans=
itional">make-read-write-lock</b></a>, <a href=3D"#f_make-semaphore" title=
=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transi=
tional">make-semaphore</b></a>, <a href=3D"#f_process-input-wait" title=3D"=
Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transi=
tional">process-input-wait</b></a>, <a href=3D"#f_process-output-wait" titl=
e=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/=
transitional">process-output-wait</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#m_with-terminal-input" title=3D"Macro WI=
TH-TERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">wi=
th-terminal-input</b></a>, <a class=3D"xref" href=3D"#cmd_y" title=3D"Tople=
vel Command :Y"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">:y</b=
></a>, <a class=3D"xref" href=3D"#f_make-lock" title=3D"Function MAKE-LOCK"=
><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <=
a class=3D"xref" href=3D"#f_make-read-write-lock" title=3D"Function MAKE-RE=
AD-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-r=
ead-write-lock</b></a>, <a class=3D"xref" href=3D"#f_make-semaphore" title=
=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transi=
tional">make-semaphore</b></a>, <a class=3D"xref" href=3D"#f_process-input-=
wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/T=
R/xhtml1/transitional">process-input-wait</b></a>, <a class=3D"xref" href=
=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=
=3D"http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a></=
span>
</div>
</div>
</p>
@@ -7379,7 +7381,7 @@
<a id=3D"cmd_y"></a>
<strong>[Toplevel Command]</strong>
<br></br>
- <code>(<span xmlns=3D"http://www.w3.org/1999/xhtml"><strong =
class=3D"function">:y</strong></span> p)</code>
+ <code>(<span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D=
"function"><strong>:y</strong></span> p)</code>
</div>
<div class=3D"refentrytitle">Yields control of terminal input =
to a specified
lisp process (thread).</div>
@@ -7387,29 +7389,29 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id509215">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417171">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">p</span></i>---a lisp process (thread), designated either by
an integer which matches its
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"fu=
nction">process-serial-number</strong></span>,
- or by a string which is <span xmlns=3D"http://www.w3.org/1999/xh=
tml"><strong class=3D"function">equal</strong></span> to
- its <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=
=3D"function">process-name</strong></span>.</p>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id509250">=
</a>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function">=
<strong>process-serial-number</strong></span>,
+ or by a string which is <span xmlns=3D"http://www.w3.org/1999/xh=
tml" class=3D"function"><strong>equal</strong></span> to
+ its <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"functi=
on"><strong>process-name</strong></span>.</p>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417210">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">:Y is a toplevel=
command, not a function. As such, it
can only be used interactively, and only from the initial
process.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The command yiel=
ds control of terminal input to the
process <em class=3D"varname">p</em>, which must have used
- <a href=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INP=
UT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-terminal-inp=
ut</b></a> to request access to the
+ <a class=3D"xref" href=3D"#m_with-terminal-input" title=3D"Macro WI=
TH-TERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">wi=
th-terminal-input</b></a> to request access to the
terminal input stream.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id509274">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417232">=
</a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a href=3D"#m_with-terminal-input" title=3D"Macro WITH-TERMINAL-INP=
UT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-terminal-inp=
ut</b></a>, <a href=3D"#v_request-terminal-input-via-break" title=3D"Variab=
le *REQUEST-TERMINAL-INPUT-VIA-BREAK*"><b xmlns=3D"http://www.w3.org/TR/xht=
ml1/transitional">*request-terminal-input-via-break*</b></a>, <a href=3D"#f=
_make-lock" title=3D"Function MAKE-LOCK"><b xmlns=3D"http://www.w3.org/TR/x=
html1/transitional">make-lock</b></a>, <a href=3D"#f_make-read-write-lock" =
title=3D"Function MAKE-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xh=
tml1/transitional">make-read-write-lock</b></a>, <a href=3D"#f_make-semapho=
re" title=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtm=
l1/transitional">make-semaphore</b></a>, <a href=3D"#f_process-input-wait" =
title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www.w3.org/TR/xhtm=
l1/transitional">process-input-wait</b></a>, <a href=3D"#f_process-output-w=
ait" title=3D"Function PROCESS-OUTPUT-WAIT"><b xmlns=3D"http://www.w3.org/T=
R/xhtml1/transitional">process-output-wait</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist"><a class=3D"xref" href=3D"#m_with-terminal-input" title=3D"Macro WI=
TH-TERMINAL-INPUT"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">wi=
th-terminal-input</b></a>, <a class=3D"xref" href=3D"#v_request-terminal-in=
put-via-break" title=3D"Variable *REQUEST-TERMINAL-INPUT-VIA-BREAK*"><b xml=
ns=3D"http://www.w3.org/TR/xhtml1/transitional">*request-terminal-input-via=
-break*</b></a>, <a class=3D"xref" href=3D"#f_make-lock" title=3D"Function =
MAKE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-lock<=
/b></a>, <a class=3D"xref" href=3D"#f_make-read-write-lock" title=3D"Functi=
on MAKE-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transition=
al">make-read-write-lock</b></a>, <a class=3D"xref" href=3D"#f_make-semapho=
re" title=3D"Function MAKE-SEMAPHORE"><b xmlns=3D"http://www.w3.org/TR/xhtm=
l1/transitional">make-semaphore</b></a>, <a class=3D"xref" href=3D"#f_proce=
ss-input-wait" title=3D"Function PROCESS-INPUT-WAIT"><b xmlns=3D"http://www=
.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class=3D"xre=
f" href=3D"#f_process-output-wait" title=3D"Function PROCESS-OUTPUT-WAIT"><=
b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b=
></a></span>
</div>
</div>
</p>
@@ -7456,7 +7458,7 @@
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL supports th=
ree types of sockets: TCP sockets, UDP
sockets, and Unix-domain sockets. This should be enough for all
but the most esoteric network situations. All sockets are
- created by <a href=3D"#f_make-socket" title=3D"Function MAKE-SOCKET"=
><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-socket</b></a>.=
The type of socket
+ created by <a class=3D"xref" href=3D"#f_make-socket" title=3D"Functi=
on MAKE-SOCKET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-=
socket</b></a>. The type of socket
depends on the arguments to it, as follows:</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"variablelis=
t">
<dl>
@@ -7526,7 +7528,7 @@
<a id=3D"f_make-socket"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">make-socket</strong></span> <em xmlns=3D"http://www.w3.or=
g/1999/xhtml" class=3D"varname">&key</em>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>make-socket</strong></span> <em xmlns=3D"http://www.w3.or=
g/1999/xhtml" class=3D"varname">&key</em>
address-family type connect eol format remote-host
remote-port local-host local-port local-filename
remote-filename keepalive reuse-address nodelay broadcast
@@ -7538,7 +7540,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id498897">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id372876">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">address-family</span></i>---The address/protocol family of this s=
ocket. Currently
only :internet (the default), meaning IP, and :file,
@@ -7610,13 +7612,13 @@
million. If an input operation takes longer than the
specified number of seconds, an
<code xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"literal">input-tim=
eout</code> error is signalled.
- (see <a xmlns=3D"http://www.w3.org/1999/xhtml" href=3D"#Stream-Timeouts-=
And-Deadlines" title=3D"10.1.4.=C3=82=C2=A0Stream Timeouts and Deadlines">S=
ection=C3=82=C2=A010.1.4, =C3=A2=C2=80=C2=9CStream Timeouts and Deadlines=
=C3=A2=C2=80=C2=9D</a>)</p>
+ (see <a xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"xref" href=3D"#S=
tream-Timeouts-And-Deadlines" title=3D"10.1.4.=C3=82=C2=A0Stream Timeouts a=
nd Deadlines">Section=C3=82=C2=A010.1.4, =C3=A2=C2=80=C2=9CStream Timeouts =
and Deadlines=C3=A2=C2=80=C2=9D</a>)</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">output-timeout</span></i>---The number of seconds before an outpu=
t operation
times out. Must be a real number between zero and one
million. If an output operation takes longer than the
specified number of seconds, an
<code xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"literal">output-ti=
meout</code> error is signalled.
- (see <a xmlns=3D"http://www.w3.org/1999/xhtml" href=3D"#Stream-Timeouts-=
And-Deadlines" title=3D"10.1.4.=C3=82=C2=A0Stream Timeouts and Deadlines">S=
ection=C3=82=C2=A010.1.4, =C3=A2=C2=80=C2=9CStream Timeouts and Deadlines=
=C3=A2=C2=80=C2=9D</a>)</p>
+ (see <a xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"xref" href=3D"#S=
tream-Timeouts-And-Deadlines" title=3D"10.1.4.=C3=82=C2=A0Stream Timeouts a=
nd Deadlines">Section=C3=82=C2=A010.1.4, =C3=A2=C2=80=C2=9CStream Timeouts =
and Deadlines=C3=A2=C2=80=C2=9D</a>)</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">connect-timeout</span></i>---The number of seconds before a conne=
ction
attempt times out. [TODO: what are acceptable values?]
If a connection attempt takes longer than the
@@ -7634,10 +7636,10 @@
stream does not complete before the deadline then a
<code xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"literal">COMMUNICA=
TION-DEADLINE-EXPIRED</code>
error is signalled. A deadline takes precedence over
- any input/output timeouts that may be set. (see <a xmlns=3D"http://www.=
w3.org/1999/xhtml" href=3D"#Stream-Timeouts-And-Deadlines" title=3D"10.1.4.=
=C3=82=C2=A0Stream Timeouts and Deadlines">Section=C3=82=C2=A010.1.4, =C3=
=A2=C2=80=C2=9CStream Timeouts and Deadlines=C3=A2=C2=80=C2=9D</a>)</p>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id458069">=
</a>
+ any input/output timeouts that may be set. (see <a xmlns=3D"http://www.=
w3.org/1999/xhtml" class=3D"xref" href=3D"#Stream-Timeouts-And-Deadlines" t=
itle=3D"10.1.4.=C3=82=C2=A0Stream Timeouts and Deadlines">Section=C3=82=C2=
=A010.1.4, =C3=A2=C2=80=C2=9CStream Timeouts and Deadlines=C3=A2=C2=80=C2=
=9D</a>)</p>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404926">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Creates and retu=
rns a new socket</p>
</div>
@@ -7648,7 +7650,7 @@
<a id=3D"f_accept-connection"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">accept-connection</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>accept-connection</strong></span>
(socket listener-socket) <em xmlns=3D"http://www.w3.org/1999/xhtml" cla=
ss=3D"varname">&key</em> wait</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -7656,7 +7658,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id430857">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404987">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The listener-socket to listen on.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">wait</span></i>---If true (the default), and there are no connect=
ions
@@ -7664,7 +7666,7 @@
returns NIL immediately.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id473045">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id405030">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Extracts the fir=
st connection on the queue of pending
connections, accepts it (i.e. completes the connection startup
@@ -7682,7 +7684,7 @@
<a id=3D"f_dotted-to-ipaddr"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">dotted-to-ipaddr</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>dotted-to-ipaddr</strong></span>
dotted <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&am=
p;key</em> errorp</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -7690,7 +7692,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id495522">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id405095">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">dotted</span></i>---A string representing an IP address in the
"nn.nn.nn.nn" format</p>
@@ -7698,7 +7700,7 @@
is invalid. If false, NIL is returned.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id482782">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id405136">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Converts a dotte=
d-string representation of a host address to
a 32-bit unsigned IP address.</p>
@@ -7710,7 +7712,7 @@
<a id=3D"f_ipaddr-to-dotted"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">ipaddr-to-dotted</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>ipaddr-to-dotted</strong></span>
ipaddr <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&am=
p;key</em> values</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -7718,7 +7720,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id459506">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id405198">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">ipaddr</span></i>---A 32-bit integer representing an internet hos=
t address</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">values</span></i>---If false (the default), returns a string in t=
he form
@@ -7727,7 +7729,7 @@
8-bit integers.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id502645">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id403555">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Converts a 32-bi=
t unsigned IP address into octets.</p>
</div>
@@ -7738,7 +7740,7 @@
<a id=3D"f_ipaddr-to-hostname"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">ipaddr-to-hostname</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>ipaddr-to-hostname</strong></span>
ipaddr <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&am=
p;key</em> ignore-cache</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -7746,14 +7748,14 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id451113">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id403616">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">ipaddr</span></i>---a 32-bit integer representing an internet hos=
t address</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">ignore-cache</span></i>---This argument is ignored (it is accepte=
d for
compatibility with Franz Allegro)</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id470273">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id403657">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Converts a 32-bi=
t unsigned IP address into a host name
string</p>
@@ -7765,7 +7767,7 @@
<a id=3D"f_lookup-hostname"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">lookup-hostname</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>lookup-hostname</strong></span>
host</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -7773,7 +7775,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id501148">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id403714">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">host</span></i>---Specifies the host. It can be either a host name
string such as "clozure.com", or a dotted address
@@ -7781,7 +7783,7 @@
IP address such as 3232235521.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433781">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id403742">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Converts a host =
spec in any of the acceptable formats into a
32-bit unsigned IP address</p>
@@ -7793,7 +7795,7 @@
<a id=3D"f_lookup-port"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">lookup-port</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>lookup-port</strong></span>
port protocol</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -7801,7 +7803,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id475043">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id403800">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">port</span></i>---Specifies the port. It can be either a string, =
such as
"http" or a symbol, such as :http, or an unsigned
@@ -7810,7 +7812,7 @@
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">protocol</span></i>---Must be one of "tcp" or "udp".</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id488453">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id403842">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Finds the port n=
umber for the specified port and protocol</p>
</div>
@@ -7821,7 +7823,7 @@
<a id=3D"f_receive-from"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">receive-from</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>receive-from</strong></span>
(socket udp-socket) size <em xmlns=3D"http://www.w3.org/1999/xhtml" cla=
ss=3D"varname">&key</em> buffer
extract offset</code>
</div>
@@ -7830,7 +7832,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id428852">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id403904">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The socket to read from</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">size</span></i>---Maximum number of bytes to read. If the packet =
is
@@ -7847,7 +7849,7 @@
data is to be stored. The default is 0.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id446788">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id403994">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Reads a UDP pack=
et from a socket. If no packets are
available, waits for a packet to arrive. Returns four values:</p>
@@ -7875,7 +7877,7 @@
<a id=3D"f_send-to"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">send-to</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>send-to</strong></span>
(socket udp-socket) buffer size <em xmlns=3D"http://www.w3.org/1999/xht=
ml" class=3D"varname">&key</em> remote-host
remote-port offset</code>
</div>
@@ -7884,7 +7886,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id435843">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404109">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The socket to write to</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">buffer</span></i>---A vector containing the data to send. It must=
be
@@ -7900,7 +7902,7 @@
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">offset</span></i>---The offset in the buffer where the packet dat=
a starts</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id474272">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404213">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Send a UDP packe=
t over a socket.</p>
</div>
@@ -7911,7 +7913,7 @@
<a id=3D"f_shutdown"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">shutdown</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>shutdown</strong></span>
socket <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&am=
p;key</em> direction</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -7919,14 +7921,14 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id462324">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404274">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The socket to shut down (typically a tcp-stre=
am)</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">direction</span></i>---One of :input to disallow further input, o=
r :output to
disallow further output.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id462135">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404315">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Shuts down part =
of a bidirectional connection. This is
useful if e.g. you need to read responses after sending an
@@ -7939,7 +7941,7 @@
<a id=3D"f_socket-os-fd"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">socket-os-fd</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>socket-os-fd</strong></span>
socket</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -7947,12 +7949,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id448673">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404374">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The socket</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id463587">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404400">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns the nati=
ve OS's representation of the socket, or
NIL if the socket is closed. On Unix, this is the Unix 'file
@@ -7969,7 +7971,7 @@
<a id=3D"f_remote-host"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">remote-host</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>remote-host</strong></span>
socket</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -7977,12 +7979,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id443064">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404461">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The socket</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id461811">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404487">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns the 32-b=
it unsigned IP address of the remote host,
or NIL if the socket is not connected.</p>
@@ -7994,7 +7996,7 @@
<a id=3D"f_remote-port"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">remote-port</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>remote-port</strong></span>
socket</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -8002,12 +8004,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id434816">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404545">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The socket</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id430162">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404571">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns the remo=
te port number, or NIL if the socket is not
connected.</p>
@@ -8019,7 +8021,7 @@
<a id=3D"f_local-host"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">local-host</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>local-host</strong></span>
socket</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -8027,12 +8029,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id483432">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404629">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The socket</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433176">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404655">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns 32-bit u=
nsigned IP address of the local host.</p>
</div>
@@ -8043,7 +8045,7 @@
<a id=3D"f_local-port"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">local-port</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>local-port</strong></span>
socket</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -8051,12 +8053,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433219">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404712">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The socket</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id455761">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404738">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns the loca=
l port number</p>
</div>
@@ -8067,7 +8069,7 @@
<a id=3D"f_socket-address-family"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">socket-address-family</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>socket-address-family</strong></span>
socket</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -8075,12 +8077,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id485427">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401876">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The socket</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433435">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401902">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns :interne=
t or :file, as appropriate.</p>
</div>
@@ -8091,7 +8093,7 @@
<a id=3D"f_socket-connect"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">socket-connect</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>socket-connect</strong></span>
socket</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -8099,12 +8101,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id450826">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401959">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The socket</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id450849">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401985">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns :active =
for tcp-stream, :passive for
listener-socket, and NIL for udp-socket</p>
@@ -8116,7 +8118,7 @@
<a id=3D"f_socket-format"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">socket-format</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>socket-format</strong></span>
socket</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -8124,12 +8126,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id453854">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402042">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The socket</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id459449">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402069">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns the sock=
et format as specified by the :format
argument to make-socket.</p>
@@ -8141,7 +8143,7 @@
<a id=3D"f_socket-type"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">socket-type</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>socket-type</strong></span>
socket</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -8149,12 +8151,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id440524">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402127">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The socket</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id440547">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402153">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">returns :stream =
for tcp-stream and listener-socket, and
:datagram for udp-socket.</p>
@@ -8173,12 +8175,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id487264">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402196">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The class of OS =
errors signaled by socket functions</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id492064">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402207">=
</a>
<div class=3D"header">Superclasses:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">simple-error</p>
</div>
@@ -8189,7 +8191,7 @@
<a id=3D"f_socket-error-code"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">socket-error-code</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>socket-error-code</strong></span>
socket-error</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -8197,12 +8199,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id468134">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402265">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket-error</span></i>---the condition</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433013">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402291">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The OS error cod=
e of the error</p>
</div>
@@ -8213,7 +8215,7 @@
<a id=3D"f_socket-error-identifier"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">socket-error-identifier</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>socket-error-identifier</strong></span>
socket-error</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -8221,12 +8223,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id451001">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402349">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket-error</span></i>---the condition</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id466905">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402375">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A symbol represe=
nting the error code in a more
OS-independent way.</p>
@@ -8242,7 +8244,7 @@
<a id=3D"f_socket-error-situation"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">socket-error-situation</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>socket-error-situation</strong></span>
socket-error</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -8250,12 +8252,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id441085">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402438">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket-error</span></i>---the condition</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id459794">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402464">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A string describ=
ing the context where the error happened. On
Linux, this is the name of the system call which returned the
@@ -8268,7 +8270,7 @@
<a id=3D"o_close"></a>
<strong>[Method]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">close</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>close</strong></span>
(socket socket) <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"var=
name">&key</em> abort</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -8276,7 +8278,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id474919">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402527">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">socket</span></i>---The socket to close</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">abort</span></i>---If false (the default), closes the socket in an
@@ -8287,7 +8289,7 @@
clean up).</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id448866">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402570">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The close generi=
c function can be applied to sockets. It
releases the operating system resources associated with the
@@ -8300,7 +8302,7 @@
<a id=3D"m_with-open-socket"></a>
<strong>[Macro]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">with-open-socket</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>with-open-socket</strong></span>
(var . make-socket-args) <em xmlns=3D"http://www.w3.org/1999/xhtml" cla=
ss=3D"varname">&body</em> body</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -8308,14 +8310,14 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id458864">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402655">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">var</span></i>---variable to bind</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">make-socket-args</span></i>---arguments suitable for passing to m=
ake-socket</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">body</span></i>---body to execute</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id469415">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402710">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">executes body wi=
th var bound to the result of applying
make-socket to make-socket-args. The socket gets closed on exit.</p>
@@ -8435,7 +8437,7 @@
<a id=3D"f_run-program"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">run-program</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>run-program</strong></span>
program args <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varn=
ame">&key</em> (wait t) pty input
if-input-does-not-exist output (if-output-exists :error) (error
:output) (if-error-exists :error) status-hook</code>
@@ -8446,7 +8448,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id481469">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id368679">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">program</span></i>---A string or pathname which denotes an execut=
able file.
The PATH environment variable is used to find programs whose
@@ -8488,7 +8490,7 @@
EXTERNAL-PROCESS.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id461423">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id354820">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Runs the specifi=
ed program in an external (Unix) process,
returning an object of type EXTERNAL-PROCESS if successful.</p>
@@ -8500,7 +8502,7 @@
<a id=3D"f_signal-external-process"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">signal-external-process</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>signal-external-process</strong></span>
proc signal-number</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -8508,13 +8510,13 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431361">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id354877">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM=
.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">signal</span></i>---A small integer.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id457362">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id354917">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Sends the specif=
ied "signal" to the specified
external process. (Typically, it would only be useful to call
@@ -8528,7 +8530,7 @@
<a id=3D"f_external-process-id"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">external-process-id</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>external-process-id</strong></span>
proc</code>
</div>
<div class=3D"refentrytitle">Returns the "process ID" of an OS=
subprocess,
@@ -8537,12 +8539,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id470325">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386150">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM=
.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id442573">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386176">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns the <spa=
n class=3D"emphasis"><em>process id</em></span> assigned to
the external process by the operating system. This is typically
@@ -8555,7 +8557,7 @@
<a id=3D"f_external-process-input-stream"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">external-process-input-stream</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>external-process-input-stream</strong></span>
proc</code>
</div>
<div class=3D"refentrytitle">Returns the lisp stream which is =
used to write
@@ -8564,12 +8566,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id472686">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id369560">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM=
.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id480066">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id369586">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns the stre=
am created when the input argument to
run-program is specified as :STREAM.</p>
@@ -8581,7 +8583,7 @@
<a id=3D"f_external-process-output-stream"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">external-process-output-stream</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>external-process-output-stream</strong></span>
proc</code>
</div>
<div class=3D"refentrytitle">Returns the lisp stream which is =
used to read
@@ -8590,12 +8592,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id468658">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id369647">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM=
.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id434953">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id379281">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns the stre=
am created when the output argument to
run-program is specified as :STREAM.</p>
@@ -8607,7 +8609,7 @@
<a id=3D"f_external-process-error-stream"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">external-process-error-stream</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>external-process-error-stream</strong></span>
proc</code>
</div>
<div class=3D"refentrytitle">Returns the stream which is used =
to read
@@ -8617,12 +8619,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id500858">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id379341">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM=
.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id490818">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id379367">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns the stre=
am created when the error argument to
run-program is specified as :STREAM.</p>
@@ -8634,7 +8636,7 @@
<a id=3D"f_external-process-status"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">external-process-status</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>external-process-status</strong></span>
proc</code>
</div>
<div class=3D"refentrytitle">Returns information about whether=
an OS
@@ -8644,12 +8646,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id461170">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id367898">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM=
.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id434075">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id367924">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns, as mult=
iple values, a keyword denoting the status
of the external process (one of :running, :stopped, :signaled, or
@@ -8679,7 +8681,7 @@
<dl>
<dt>
<span class=3D"sect2">
- <a href=3D"#id467737">10.1.1. Stream External Encoding=
</a>
+ <a href=3D"#id380903">10.1.1. Stream External Encoding=
</a>
</span>
</dt>
<dt>
@@ -8747,13 +8749,13 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id467737"></a>10.1.1.=C3=82=
=C2=A0Stream External Encoding</h3>
+ <h3 class=3D"title"><a id=3D"id380903"></a>10.1.1.=C3=82=
=C2=A0Stream External Encoding</h3>
</div>
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL streams h=
ave an external-encoding attribute that
may be read using
- <span><strong class=3D"function">STREAM-EXTERNAL-ENCODING</strong></sp=
an> and set using <span><strong class=3D"function">(SETF
+ <span class=3D"function"><strong>STREAM-EXTERNAL-ENCODING</strong></sp=
an> and set using <span class=3D"function"><strong>(SETF
STREAM-EXTERNAL-ENCODING)</strong></span>.
</p>
</div>
@@ -8765,8 +8767,8 @@
</div>
</div>
</div>
- <p xmlns=3D"http://www.w3.org/1999/xhtml"><span><strong class=
=3D"function">OPEN</strong></span> and
- <span><strong class=3D"function">MAKE-SOCKET</strong></span> have ea=
ch been extended to take
+ <p xmlns=3D"http://www.w3.org/1999/xhtml"><span class=3D"funct=
ion"><strong>OPEN</strong></span> and
+ <span class=3D"function"><strong>MAKE-SOCKET</strong></span> have ea=
ch been extended to take
the additional keyword arguments: <code class=3D"literal">:CLASS</co=
de>,
<code class=3D"literal">:SHARING</code>, and
<code class=3D"literal">:BASIC</code>.</p>
@@ -8781,7 +8783,7 @@
<p>A symbol that names the desired class of the stream.
The specified class must inherit from
<code class=3D"literal">FILE-STREAM</code> for
- <span><strong class=3D"function">OPEN</strong></span>.</p>
+ <span class=3D"function"><strong>OPEN</strong></span>.</p>
</dd>
<dt>
<span class=3D"term">
@@ -8822,8 +8824,8 @@
separate "read" and "write" locks for IO streams.
This makes it possible for instance, for one thread to
read from such a stream while another thread writes to
- it. (see also <a href=3D"#f_make-read-write-lock" title=3D"Function MAK=
E-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">ma=
ke-read-write-lock</b></a>
- <a href=3D"#m_with-read-lock" title=3D"Macro WITH-READ-LOCK"><b xmlns=3D=
"http://www.w3.org/TR/xhtml1/transitional">with-read-lock</b></a> <a href=
=3D"#m_with-write-lock" title=3D"Macro WITH-WRITE-LOCK"><b xmlns=3D"http://=
www.w3.org/TR/xhtml1/transitional">with-write-lock</b></a>)</p>
+ it. (see also <a class=3D"xref" href=3D"#f_make-read-write-lock" title=
=3D"Function MAKE-READ-WRITE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/=
transitional">make-read-write-lock</b></a>
+ <a class=3D"xref" href=3D"#m_with-read-lock" title=3D"Macro WITH-READ-LO=
CK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-read-lock</b=
></a> <a class=3D"xref" href=3D"#m_with-write-lock" title=3D"Macro WITH-WRI=
TE-LOCK"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">with-write-l=
ock</b></a>)</p>
</dd>
<dt>
<span class=3D"term">
@@ -8852,7 +8854,7 @@
<p>A boolean that indicates whether or not the stream is
a Gray stream, i.e. whether or not the stream is an instance
of <code class=3D"literal">FUNDAMENTAL-STREAM</code> or
- <code class=3D"literal">CCL::BASIC-STREAM</code>(see <a href=3D"#Basic-=
Versus-Fundamental-Streams" title=3D"10.1.3.=C3=82=C2=A0Basic Versus Fundam=
ental Streams">Section=C3=82=C2=A010.1.3, =C3=A2=C2=80=C2=9CBasic Versus Fu=
ndamental Streams=C3=A2=C2=80=C2=9D</a>). Defaults to
+ <code class=3D"literal">CCL::BASIC-STREAM</code>(see <a class=3D"xref" =
href=3D"#Basic-Versus-Fundamental-Streams" title=3D"10.1.3.=C3=82=C2=A0Basi=
c Versus Fundamental Streams">Section=C3=82=C2=A010.1.3, =C3=A2=C2=80=C2=9C=
Basic Versus Fundamental Streams=C3=A2=C2=80=C2=9D</a>). Defaults to
<code class=3D"literal">T</code>.</p>
</dd>
</dl>
@@ -8866,7 +8868,7 @@
</div>
</div>
</div>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">Gray streams (see <a=
href=3D"#Creating-Your-Own-Stream-Classes-with-Gray-Streams" title=3D"10.2=
.=C3=82=C2=A0Creating Your Own Stream Classes with Gray Streams">Section=C3=
=82=C2=A010.2, =C3=A2=C2=80=C2=9CCreating Your Own Stream Classes with Gray=
Streams=C3=A2=C2=80=C2=9D</a>)
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">Gray streams (see <a=
class=3D"xref" href=3D"#Creating-Your-Own-Stream-Classes-with-Gray-Streams=
" title=3D"10.2.=C3=82=C2=A0Creating Your Own Stream Classes with Gray Stre=
ams">Section=C3=82=C2=A010.2, =C3=A2=C2=80=C2=9CCreating Your Own Stream Cl=
asses with Gray Streams=C3=A2=C2=80=C2=9D</a>)
all inherit from <code class=3D"literal">FUNDAMENTAL-STREAM</code> w=
hereas
basic streams inherit from <code class=3D"literal">CCL::BASIC-STREAM=
</code>.
The tradeoff between FUNDAMENTAL and BASIC streams is entirely
@@ -8885,7 +8887,7 @@
when that support isn't needed can improve I/O performance.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The Gray stream meth=
od
- <span><strong class=3D"function">STREAM-READ-CHAR</strong></span> sh=
ould work on appropriate
+ <span class=3D"function"><strong>STREAM-READ-CHAR</strong></span> sh=
ould work on appropriate
<code class=3D"literal">BASIC-STREAM</code>s. (There may still be c=
ases
where such methods are undefined; such cases should be
considered bugs.) It is not guaranteed that Gray stream methods
@@ -8907,20 +8909,20 @@
</div>
</div>
</div>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id427146" clas=
s=3D"indexterm"></a>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id488528" clas=
s=3D"indexterm"></a>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id484109" clas=
s=3D"indexterm"></a>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id463965" clas=
s=3D"indexterm"></a>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433256" clas=
s=3D"indexterm"></a>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425542" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402803" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402813" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402823" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402832" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402842" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402852" clas=
s=3D"indexterm"></a>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A stream that is ass=
ociated with a file descriptor has
attributes and accessors:
- <span><strong class=3D"function">STREAM-INPUT-TIMEOUT</strong></sp=
an>,
- <span><strong class=3D"function">STREAM-OUTPUT-TIMEOUT</strong></s=
pan>, and
- <span><strong class=3D"function">STREAM-DEADLINE</strong></span>. =
All three accessors have
- corresponding <span><strong class=3D"function">SETF</strong></span=
> methods.
- <span><strong class=3D"function">STREAM-INPUT-TIMEOUT</strong></sp=
an> and
- <span><strong class=3D"function">STREAM-OUTPUT-TIMEOUT</strong></s=
pan> are specified in
+ <span class=3D"function"><strong>STREAM-INPUT-TIMEOUT</strong></sp=
an>,
+ <span class=3D"function"><strong>STREAM-OUTPUT-TIMEOUT</strong></s=
pan>, and
+ <span class=3D"function"><strong>STREAM-DEADLINE</strong></span>. =
All three accessors have
+ corresponding <span class=3D"function"><strong>SETF</strong></span=
> methods.
+ <span class=3D"function"><strong>STREAM-INPUT-TIMEOUT</strong></sp=
an> and
+ <span class=3D"function"><strong>STREAM-OUTPUT-TIMEOUT</strong></s=
pan> are specified in
seconds and can be any positive real number less than one million.
When a timeout is set and the corresponding I/O operation takes
longer than the specified interval, an error is signalled. The
@@ -8956,7 +8958,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"fun=
ction">open-file-streams</strong></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><=
strong>open-file-streams</strong></span>
=3D> stream-list
</code>
</div>
@@ -8965,21 +8967,21 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id469274=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id406598=
"></a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">stream-list</span></i>---A list of open file streams. This is a =
copy of
an internal list so it may be destructively
modified without ill effect.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id444191=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id406625=
"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns a list=
of open file streams.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id487677=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id406636=
"></a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"si=
mplelist"><a href=3D"#f_note-open-file-stream" title=3D"Function NOTE-OPEN-=
FILE-STREAM"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">note-ope=
n-file-stream</b></a>, <a href=3D"#f_remove-open-file-stream" title=3D"Func=
tion REMOVE-OPEN-FILE-STREAM"><b xmlns=3D"http://www.w3.org/TR/xhtml1/trans=
itional">remove-open-file-stream</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"si=
mplelist"><a class=3D"xref" href=3D"#f_note-open-file-stream" title=3D"Func=
tion NOTE-OPEN-FILE-STREAM"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transit=
ional">note-open-file-stream</b></a>, <a class=3D"xref" href=3D"#f_remove-o=
pen-file-stream" title=3D"Function REMOVE-OPEN-FILE-STREAM"><b xmlns=3D"htt=
p://www.w3.org/TR/xhtml1/transitional">remove-open-file-stream</b></a></spa=
n>
</div>
</div>
</p>
@@ -8989,7 +8991,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"fun=
ction">note-open-file-stream</strong></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><=
strong>note-open-file-stream</strong></span>
file-stream
</code>
</div>
@@ -9000,23 +9002,23 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id475844=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id406717=
"></a>
<div class=3D"header">Arguments:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">file-stream</span></i>---A file stream.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id472282=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id406743=
"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Adds a file st=
ream to the internal list of open
file streams that is returned by
- <span><strong class=3D"function">open-file-streams</strong></span=
>. This function is
+ <span class=3D"function"><strong>open-file-streams</strong></span=
>. This function is
thread-safe. It will usually only be called from custom
stream code when a file-stream is created.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id457744=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id406762=
"></a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"si=
mplelist"><a href=3D"#f_open-file-streams" title=3D"Function OPEN-FILE-STRE=
AMS"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">open-file-stream=
s</b></a>, <a href=3D"#f_remove-open-file-stream" title=3D"Function REMOVE-=
OPEN-FILE-STREAM"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">rem=
ove-open-file-stream</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"si=
mplelist"><a class=3D"xref" href=3D"#f_open-file-streams" title=3D"Function=
OPEN-FILE-STREAMS"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">o=
pen-file-streams</b></a>, <a class=3D"xref" href=3D"#f_remove-open-file-str=
eam" title=3D"Function REMOVE-OPEN-FILE-STREAM"><b xmlns=3D"http://www.w3.o=
rg/TR/xhtml1/transitional">remove-open-file-stream</b></a></span>
</div>
</div>
</p>
@@ -9026,7 +9028,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"fun=
ction">remove-open-file-stream</strong></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><=
strong>remove-open-file-stream</strong></span>
file-stream
</code>
</div>
@@ -9037,23 +9039,23 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433729=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id406843=
"></a>
<div class=3D"header">Arguments:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">file-stream</span></i>---A file stream.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id501400=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id406869=
"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Remove file st=
ream from the internal list of open file
streams that is returned by
- <span><strong class=3D"function">open-file-streams</strong></span=
>. This function is
+ <span class=3D"function"><strong>open-file-streams</strong></span=
>. This function is
thread-safe. It will usually only be called from custom
stream code when a file-stream is closed.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id488897=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id406888=
"></a>
<div class=3D"header">See Also:</div>
- <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"si=
mplelist"><a href=3D"#f_open-file-streams" title=3D"Function OPEN-FILE-STRE=
AMS"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">open-file-stream=
s</b></a>, <a href=3D"#f_note-open-file-stream" title=3D"Function NOTE-OPEN=
-FILE-STREAM"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">note-op=
en-file-stream</b></a></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"si=
mplelist"><a class=3D"xref" href=3D"#f_open-file-streams" title=3D"Function=
OPEN-FILE-STREAMS"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">o=
pen-file-streams</b></a>, <a class=3D"xref" href=3D"#f_note-open-file-strea=
m" title=3D"Function NOTE-OPEN-FILE-STREAM"><b xmlns=3D"http://www.w3.org/T=
R/xhtml1/transitional">note-open-file-stream</b></a></span>
</div>
</div>
</p>
@@ -9476,7 +9478,7 @@
<a id=3D"f_stream-read-list"></a>
<strong>[Generic Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong=
class=3D"function">stream-read-list</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"function"><strong>stream-read-list</strong></span>
stream list count</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -9484,7 +9486,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511284=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id407475=
"></a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">stream</span></i>---a stream, presumably a fundamental-input-stre=
am.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">list</span></i>---a list. When a STREAM-READ-LIST method is calle=
d by
@@ -9495,7 +9497,7 @@
to be greater than the length of the list.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511338=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id407533=
"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Should try to =
read up to count elements from stream into the
list list, returning the number of elements actually read (which
@@ -9508,7 +9510,7 @@
<a id=3D"f_stream-write-list"></a>
<strong>[Generic Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong=
class=3D"function">stream-write-list</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"function"><strong>stream-write-list</strong></span>
stream list count</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -9516,7 +9518,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511383=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id407593=
"></a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">stream</span></i>---a stream, presumably a fundamental-output-str=
eam.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">list</span></i>---a list. When a STREAM-WRITE-LIST method is call=
ed by
@@ -9527,7 +9529,7 @@
guaranteed not to be greater than the length of the list.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511438=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id407651=
"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">should try to =
write the first count elements of list to
stream. The return value of this method is ignored.</p>
@@ -9539,7 +9541,7 @@
<a id=3D"f_stream-read-vector"></a>
<strong>[Generic Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong=
class=3D"function">stream-read-vector</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"function"><strong>stream-read-vector</strong></span>
stream vector start end</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -9547,7 +9549,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511482=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id407709=
"></a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">stream</span></i>---a stream, presumably a fundamental-input-stre=
am</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">vector</span></i>---a vector. When a STREAM-READ-VECTOR method is=
called
@@ -9563,7 +9565,7 @@
length of vector.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511553=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id407784=
"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">should try to =
read successive elements from stream into
vector, starting at element start (inclusive) and continuing
@@ -9578,7 +9580,7 @@
<a id=3D"f_stream-write-vector"></a>
<strong>[Generic Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong=
class=3D"function">stream-write-vector</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"function"><strong>stream-write-vector</strong></span>
stream vector start end</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -9586,7 +9588,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511600=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id407844=
"></a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">stream</span></i>---a stream, presumably a fundamental-output-str=
eam</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">vector</span></i>---a vector. When a STREAM-WRITE-VECTOR method i=
s called
@@ -9602,7 +9604,7 @@
length of vector.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511672=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id407920=
"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">should try to =
write successive elements of vector to stream,
starting at element start (inclusive) and continuing through
@@ -9615,7 +9617,7 @@
<a id=3D"f_stream-device"></a>
<strong>[Generic Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong=
class=3D"function">ccl::stream-device</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"function"><strong>ccl::stream-device</strong></span>
s direction</code>
</div>
<div class=3D"refentrytitle">Returns the OS file descriptor =
associated with a
@@ -9624,13 +9626,13 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511719=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id407980=
"></a>
<div class=3D"header">Method Signatures:</div>
- <div class=3D"synopsis"><span xmlns=3D"http://www.w3.org=
/1999/xhtml"><strong class=3D"function">ccl::stream-device</strong></span> =
<i>
+ <div class=3D"synopsis"><span xmlns=3D"http://www.w3.org=
/1999/xhtml" class=3D"function"><strong>ccl::stream-device</strong></span> =
<i>
(s stream) direction =3D> fd</i></div>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511731=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id407998=
"></a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">s</span></i>---a stream.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">direction</span></i>---either :INPUT or :OUTPUT.</p>
@@ -9641,7 +9643,7 @@
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">d=
irection</em>.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511789=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id408063=
"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns the fi=
le descriptor associated with
<em class=3D"varname">s</em> in the direction given by
@@ -9657,7 +9659,7 @@
<a id=3D"f_stream-read-ivector"></a>
<strong>[Generic Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong=
class=3D"function">stream-read-ivector</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"function"><strong>stream-read-ivector</strong></span>
stream ivector start-octet max-octets</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -9665,14 +9667,14 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511844=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id408133=
"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Reads up to ma=
x-octets octets from stream into ivector,
storing them at start-octet. Returns the number of octets actually
read.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511857=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id408145=
"></a>
<div class=3D"header">Arguments:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">stream</span></i>---An input stream. The method defined on
BUFFERED-INPUT-STREAMs requires that the size in octets of
@@ -9689,7 +9691,7 @@
<a id=3D"f_stream-write-ivector"></a>
<strong>[Generic Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong=
class=3D"function">stream-write-ivector stream</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"function"><strong>stream-write-ivector stream</strong></span>
ivector start-octet max-octets</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -9697,13 +9699,13 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511954=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id408264=
"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Writes max-oct=
ets octets to stream from ivector, starting at
start-octet. Returns max-octets.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id511966=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id408276=
"></a>
<div class=3D"header">Arguments:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">stream</span></i>---An input stream. The method defined on
BUFFERED-OUTPUT-STREAMs requires that the size in octets of
@@ -9713,7 +9715,7 @@
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">max-octet</span></i>---A non-negative integer.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id512030=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id408348=
"></a>
<div class=3D"header">Examples:</div>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"pro=
gramlisting">
;;; Write the contents of a (SIMPLE-ARRAY(UNSIGNED-BYTE 16) 3) =
@@ -10658,7 +10660,7 @@
</dd>
<dt>
<span class=3D"sect1">
- <a href=3D"#id523636">12.12. The Foreign-Function-Interfac=
e Dictionary</a>
+ <a href=3D"#id430545">12.12. The Foreign-Function-Interfac=
e Dictionary</a>
</span>
</dt>
</dl>
@@ -10755,7 +10757,7 @@
name <code class=3D"code">:NS-RECT</code> is a name for the type=
that
corresponds to <code class=3D"code">NS:NS-RECT</code>, and you c=
an
use <code class=3D"code">:NS-RECT</code> as a type designator
- in <a href=3D"#anchor_rlet"><code class=3D"code">RLET</code></a>=
forms to
+ in <a class=3D"link" href=3D"#anchor_rlet"><code class=3D"code">=
RLET</code></a> forms to
specify a structure of type <code class=3D"code">NS-RECT</code>.=
</p>
</li>
<li>
@@ -11001,7 +11003,7 @@
</dt>
<dd>
<p>The argument/return values
- is <a href=3D"#Referencing-and-Using-Foreign-Memory-Addresses" t=
itle=3D"12.3.=C3=82=C2=A0Referencing and Using Foreign Memory Addresses">a =
MACPTR</a>.</p>
+ is <a class=3D"link" href=3D"#Referencing-and-Using-Foreign-Memo=
ry-Addresses" title=3D"12.3.=C3=82=C2=A0Referencing and Using Foreign Memor=
y Addresses">a MACPTR</a>.</p>
</dd>
<dt>
<span class=3D"term">:VOID</span>
@@ -11486,7 +11488,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id520741"></a>12.3.2.4.=
=C3=82=C2=A0%int-to-ptr [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id410723"></a>12.3.2.4.=
=C3=82=C2=A0%int-to-ptr [Function]</h4>
</div>
</div>
</div>
@@ -11527,7 +11529,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id520806"></a>12.3.2.5.=
=C3=82=C2=A0%inc-ptr [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id410798"></a>12.3.2.5.=
=C3=82=C2=A0%inc-ptr [Function]</h4>
</div>
</div>
</div>
@@ -11577,7 +11579,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id520887"></a>12.3.2.6.=
=C3=82=C2=A0%ptr-to-int [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id410889"></a>12.3.2.6.=
=C3=82=C2=A0%ptr-to-int [Function]</h4>
</div>
</div>
</div>
@@ -11619,7 +11621,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id520952"></a>12.3.2.7.=
=C3=82=C2=A0%null-ptr [Macro]</h4>
+ <h4 class=3D"title"><a id=3D"id410964"></a>12.3.2.7.=
=C3=82=C2=A0%null-ptr [Macro]</h4>
</div>
</div>
</div>
@@ -11644,7 +11646,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id520987"></a>12.3.2.8.=
=C3=82=C2=A0%null-ptr-p [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id411006"></a>12.3.2.8.=
=C3=82=C2=A0%null-ptr-p [Function]</h4>
</div>
</div>
</div>
@@ -11686,7 +11688,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id521053"></a>12.3.2.9.=
=C3=82=C2=A0%setf-macptr [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id411081"></a>12.3.2.9.=
=C3=82=C2=A0%setf-macptr [Function]</h4>
</div>
</div>
</div>
@@ -11734,7 +11736,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id521132"></a>12.3.2.10.=
=C3=82=C2=A0%incf-ptr [Macro]</h4>
+ <h4 class=3D"title"><a id=3D"id411171"></a>12.3.2.10.=
=C3=82=C2=A0%incf-ptr [Macro]</h4>
</div>
</div>
</div>
@@ -11782,7 +11784,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id521210"></a>12.3.2.11.=
=C3=82=C2=A0with-macptrs [Macro]</h4>
+ <h4 class=3D"title"><a id=3D"id411262"></a>12.3.2.11.=
=C3=82=C2=A0with-macptrs [Macro]</h4>
</div>
</div>
</div>
@@ -11832,7 +11834,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id521291"></a>12.3.2.12.=
=C3=82=C2=A0%stack-block [Macro]</h4>
+ <h4 class=3D"title"><a id=3D"id411354"></a>12.3.2.12.=
=C3=82=C2=A0%stack-block [Macro]</h4>
</div>
</div>
</div>
@@ -11883,7 +11885,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id521373"></a>12.3.2.13.=
=C3=82=C2=A0make-cstring [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id411446"></a>12.3.2.13.=
=C3=82=C2=A0make-cstring [Function]</h4>
</div>
</div>
</div>
@@ -11926,7 +11928,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id521441"></a>12.3.2.14.=
=C3=82=C2=A0with-cstrs [Macro]</h4>
+ <h4 class=3D"title"><a id=3D"id411522"></a>12.3.2.14.=
=C3=82=C2=A0with-cstrs [Macro]</h4>
</div>
</div>
</div>
@@ -11976,7 +11978,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id521523"></a>12.3.2.15.=
=C3=82=C2=A0with-encoded-cstrs [Macro]</h4>
+ <h4 class=3D"title"><a id=3D"id411614"></a>12.3.2.15.=
=C3=82=C2=A0with-encoded-cstrs [Macro]</h4>
</div>
</div>
</div>
@@ -12039,7 +12041,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id521635"></a>12.3.2.16.=
=C3=82=C2=A0%get-cstring [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id411737"></a>12.3.2.16.=
=C3=82=C2=A0%get-cstring [Function]</h4>
</div>
</div>
</div>
@@ -12081,7 +12083,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id521700"></a>12.3.2.17.=
=C3=82=C2=A0%str-from-ptr [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id428584"></a>12.3.2.17.=
=C3=82=C2=A0%str-from-ptr [Function]</h4>
</div>
</div>
</div>
@@ -12182,7 +12184,7 @@
<p xmlns=3D"http://www.w3.org/1999/xhtml">Since the <code clas=
s=3D"literal">CCL</code> sources contain instances of these
reader macros (and references to foreign record types and
fields), compiling <code class=3D"literal">CCL</code> from those s=
ources depends on the
- ability to find and use (see <a href=3D"#Building-the-heap-image" =
title=3D"3.5.=C3=82=C2=A0Building the heap image">Section=C3=82=C2=A03.5, =
=C3=A2=C2=80=C2=9CBuilding the heap image=C3=A2=C2=80=C2=9D</a>).</p>
+ ability to find and use (see <a class=3D"xref" href=3D"#Building-t=
he-heap-image" title=3D"3.5.=C3=82=C2=A0Building the heap image">Section=C3=
=82=C2=A03.5, =C3=A2=C2=80=C2=9CBuilding the heap image=C3=A2=C2=80=C2=9D</=
a>).</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -12197,7 +12199,7 @@
<li>
<p><code class=3D"literal">CCL</code> now preserves the =
case of external symbols in
its database
- files. See <a href=3D"#Case-sensitivity-of-foreign-names-in-CCL" =
title=3D"12.8.=C3=82=C2=A0Case-sensitivity of foreign names in CCL">Case-se=
nsitivity
+ files. See <a class=3D"link" href=3D"#Case-sensitivity-of-foreign=
-names-in-CCL" title=3D"12.8.=C3=82=C2=A0Case-sensitivity of foreign names =
in CCL">Case-sensitivity
of foreign names in <code class=3D"literal">CCL</code></a> for in=
formation about
case in foreign symbol names.</p>
</li>
@@ -12212,7 +12214,7 @@
</ul>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">For information abou=
t building the database files,
- see <a href=3D"#The-Interface-Translator" title=3D"12.7.=C3=82=C2=A0T=
he Interface Translator">Section=C3=82=C2=A012.7, =C3=A2=C2=80=C2=9CThe Int=
erface Translator=C3=A2=C2=80=C2=9D</a>.</p>
+ see <a class=3D"xref" href=3D"#The-Interface-Translator" title=3D"12.=
7.=C3=82=C2=A0The Interface Translator">Section=C3=82=C2=A012.7, =C3=A2=C2=
=80=C2=9CThe Interface Translator=C3=A2=C2=80=C2=9D</a>.</p>
</div>
</div>
<div class=3D"sect1" lang=3D"en" xml:lang=3D"en">
@@ -12352,7 +12354,7 @@
</li>
</ol>
</div>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">Refer to <a href=3D"=
#The-Interface-Translator" title=3D"12.7.=C3=82=C2=A0The Interface Translat=
or">Section=C3=82=C2=A012.7, =C3=A2=C2=80=C2=9CThe Interface Translator=C3=
=A2=C2=80=C2=9D</a> for
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">Refer to <a class=3D=
"xref" href=3D"#The-Interface-Translator" title=3D"12.7.=C3=82=C2=A0The Int=
erface Translator">Section=C3=82=C2=A012.7, =C3=A2=C2=80=C2=9CThe Interface=
Translator=C3=A2=C2=80=C2=9D</a> for
information about running the interface translator and .ffi
parser.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Assuming that all we=
nt well, there should now be .cdb
@@ -12385,10 +12387,10 @@
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml"><code class=3D"liter=
al">CCL</code> provides facilities to open and close shared
libraries.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">"Opening" a shared l=
ibrary, which is done with <a href=3D"#f_open-shared-library" title=3D"Func=
tion OPEN-SHARED-LIBRARY"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitio=
nal">open-shared-library</b></a>, maps the library's code and
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">"Opening" a shared l=
ibrary, which is done with <a class=3D"xref" href=3D"#f_open-shared-library=
" title=3D"Function OPEN-SHARED-LIBRARY"><b xmlns=3D"http://www.w3.org/TR/x=
html1/transitional">open-shared-library</b></a>, maps the library's code and
data into <code class=3D"literal">CCL</code>'s address space and m=
akes its exported
symbols accessible to <code class=3D"literal">CCL</code>.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">"Closing" a shared l=
ibrary, which is done with <a href=3D"#f_close-shared-library" title=3D"Fun=
ction CLOSE-SHARED-LIBRARY"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transit=
ional">close-shared-library</b></a>, unmaps the library's code
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">"Closing" a shared l=
ibrary, which is done with <a class=3D"xref" href=3D"#f_close-shared-librar=
y" title=3D"Function CLOSE-SHARED-LIBRARY"><b xmlns=3D"http://www.w3.org/TR=
/xhtml1/transitional">close-shared-library</b></a>, unmaps the library's co=
de
and and removes the library's symbols from the global
namespace.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A small number of sh=
ared libraries (including libc,
@@ -12928,7 +12930,7 @@
<p xmlns=3D"http://www.w3.org/1999/xhtml">Before we call anythin=
g, let's check that the individual
functions can actually be found by the system. We don't have to
do this, but it helps to know how to find out whether this is
- the problem, when something goes wrong. We use <a href=3D"#m_extern=
al-call" title=3D"Macro EXTERNAL-CALL"><b xmlns=3D"http://www.w3.org/TR/xht=
ml1/transitional">external-call</b></a>:</p>
+ the problem, when something goes wrong. We use <a class=3D"xref" hr=
ef=3D"#m_external-call" title=3D"Macro EXTERNAL-CALL"><b xmlns=3D"http://ww=
w.w3.org/TR/xhtml1/transitional">external-call</b></a>:</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programlist=
ing">
=
? (external "_void_void_test")
@@ -13588,7 +13590,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
<div>
<div>
- <h2 class=3D"title" style=3D"clear: both"><a id=3D"id52363=
6"></a>12.12.=C3=82=C2=A0The Foreign-Function-Interface Dictionary</h2>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"id43054=
5"></a>12.12.=C3=82=C2=A0The Foreign-Function-Interface Dictionary</h2>
</div>
</div>
</div>
@@ -13605,13 +13607,13 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id523669">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id430583">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Reads a symbol f=
rom the current input stream, with *PACKAGE*
bound to the "OS" package and with readtable-case preserved.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">Does a lookup on=
that symbol in <a href=3D"#The-Interface-Database" title=3D"12.4.=C3=82=C2=
=A0The Interface Database">the <code class=3D"literal">CCL</code> interface
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">Does a lookup on=
that symbol in <a class=3D"link" href=3D"#The-Interface-Database" title=3D=
"12.4.=C3=82=C2=A0The Interface Database">the <code class=3D"literal">CCL</=
code> interface
database</a>, signalling an error if no foreign function
- information can be found for the symbol in any active <a href=3D"#U=
sing-Interface-Directories" title=3D"12.5.=C3=82=C2=A0Using Interface Direc=
tories">interface
+ information can be found for the symbol in any active <a class=3D"l=
ink" href=3D"#Using-Interface-Directories" title=3D"12.5.=C3=82=C2=A0Using =
Interface Directories">interface
directory</a>.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Notes the foreig=
n function information, including the foreign
function's return type, the number and type of the foreign
@@ -13657,7 +13659,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id523776">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id430689">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In <code class=
=3D"literal">CCL</code> 1.2 and later, the #& reader macro can be used =
to
access foreign variables; this functionality depends on the presenc=
e of
@@ -13716,7 +13718,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id523895">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id430806">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In <code class=
=3D"literal">CCL</code> 0.14.2 and later, the #? reader macro can be used
to access foreign constants; this functionality depends on the
@@ -13763,7 +13765,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id523978">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id430889">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In <code class=
=3D"literal">CCL</code> 1.2 and later, the #/ reader macro can be used to
access foreign functions on the Darwin platform. The current
@@ -13866,7 +13868,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id524405">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431028">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In Clozure CL 1.=
2 and later, the #> reader macro reads
the following text as a keyword, preserving the case of the
@@ -13886,7 +13888,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">close-shared-library</strong></span> library <em xmlns=3D"http://www.w=
3.org/1999/xhtml" class=3D"varname">&key</em>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>close-shared-library</strong></span> library <em xmlns=3D"http://www.w=
3.org/1999/xhtml" class=3D"varname">&key</em>
completely</code>
</div>
<div class=3D"refentrytitle">Stops using a shared library, inf=
orming the operating
@@ -13895,19 +13897,19 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id524468">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431097">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">library</span></i>---either an object of type SHLIB, or a string =
which
designates one by its so-name.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">completely</span></i>---a boolean. The default is T.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id524505">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431134">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If <em class=3D"=
varname">completely</em> is T, sets the
reference count of <em class=3D"varname">library</em> to 0. Otherw=
ise,
decrements it by 1. In either case, if the reference count
- becomes 0, <span><strong class=3D"function">close-shared-library</s=
trong></span>
+ becomes 0, <span class=3D"function"><strong>close-shared-library</s=
trong></span>
frees all memory resources consumed <em class=3D"varname">library</=
em>
and
causes any EXTERNAL-ENTRY-POINTs known to be defined by it to
@@ -13921,7 +13923,7 @@
<strong>[Macro]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">defcallback</strong></span> name
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>defcallback</strong></span> name
({arg-type-specifier var}* <em xmlns=3D"http://www.w3.org/1999/xhtm=
l" class=3D"varname">&optional</em> result-type-specifier)
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&b=
ody</em> body
</code>
@@ -13931,11 +13933,11 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id524573">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431210">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">name</span></i>---A symbol which can be made into a special varia=
ble</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">arg-type-specifer</span></i>---One of the foreign argument-type k=
eywords,
- described above, or an equivalent <a xmlns=3D"http://www.w3.org/=
1999/xhtml" href=3D"#Specifying-And-Using-Foreign-Types" title=3D"12.1.=C3=
=82=C2=A0Specifying And Using Foreign Types">foreign
+ described above, or an equivalent <a xmlns=3D"http://www.w3.org/=
1999/xhtml" class=3D"link" href=3D"#Specifying-And-Using-Foreign-Types" tit=
le=3D"12.1.=C3=82=C2=A0Specifying And Using Foreign Types">foreign
type specifier</a>. In addition, if the keyword
:WITHOUT-INTERRUPTS is specified, the callback will be
executed with lisp interrupts disabled if the
@@ -13948,7 +13950,7 @@
which can be coerced to the specified result-type.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id524649">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431281">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Proclaims <em cl=
ass=3D"varname">name</em>
to be a special variable; sets its value to a
@@ -13964,7 +13966,7 @@
updated version of the lisp callback function will be called.
This feature allows for callback functions to be redefined
incrementally, just like Lisp functions are.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml"><span><strong cl=
ass=3D"function">defcallback</strong></span>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml"><span class=3D"f=
unction"><strong>defcallback</strong></span>
returns the callback pointer, e.g., the
value of <em class=3D"varname">name</em>.</p>
</div>
@@ -13976,7 +13978,7 @@
<strong>[Macro]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">def-foreign-type</strong></span> name foreign-type-spec
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>def-foreign-type</strong></span> name foreign-type-spec
</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -13984,15 +13986,15 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id524725">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431360">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">name</span></i>---NIL or a keyword; the keyword may contain
- <a xmlns=3D"http://www.w3.org/1999/xhtml" href=3D"#Case-sensitiv=
ity-of-foreign-names-in-CCL" title=3D"12.8.=C3=82=C2=A0Case-sensitivity of =
foreign names in CCL">escaping constructs</a>.</p>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"link" href=3D=
"#Case-sensitivity-of-foreign-names-in-CCL" title=3D"12.8.=C3=82=C2=A0Case-=
sensitivity of foreign names in CCL">escaping constructs</a>.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">foreign-type-spec</span></i>---A foreign type specifier, whose sy=
ntax is (loosely)
defined above.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id524767">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431402">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If name is non-N=
IL, defines name to be an alias for the
foreign type specified by foreign-type-spec. If foreign-type-spec
@@ -14017,7 +14019,7 @@
<strong>[Macro]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">external</strong></span> name =3D> entry
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>external</strong></span> name =3D> entry
</code>
</div>
<div class=3D"refentrytitle">Resolves a reference to an extern=
al symbol which
@@ -14026,7 +14028,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id524838">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431474">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">name</span></i>---
a simple-string which names an external symbol.
@@ -14039,7 +14041,7 @@
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id524880">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431515">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If there is alre=
ady an EXTERNAL-ENTRY-POINT for
the symbol named by <em class=3D"varname">name</em>, finds it and
@@ -14058,7 +14060,7 @@
<strong>[Macro]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">external-call</strong></span> name
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>external-call</strong></span> name
{arg-type-specifier arg}* <em xmlns=3D"http://www.w3.org/1999/xhtml=
" class=3D"varname">&optional</em> result-type-specifier
</code>
</div>
@@ -14067,20 +14069,20 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id524945">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431584">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">name</span></i>---A lisp string. See external, above.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">arg-type-specifer</span></i>---One of the foreign argument-type k=
eywords, described
- above, or an equivalent <a xmlns=3D"http://www.w3.org/1999/xhtml=
" href=3D"#Specifying-And-Using-Foreign-Types" title=3D"12.1.=C3=82=C2=A0Sp=
ecifying And Using Foreign Types">foreign
+ above, or an equivalent <a xmlns=3D"http://www.w3.org/1999/xhtml=
" class=3D"link" href=3D"#Specifying-And-Using-Foreign-Types" title=3D"12.1=
.=C3=82=C2=A0Specifying And Using Foreign Types">foreign
type specifier</a>.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">arg</span></i>---A lisp value of type indicated by the correspond=
ing
arg-type-specifier</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result-type-specifier</span></i>---One of the foreign argument-ty=
pe keywords, described
- above, or an equivalent <a xmlns=3D"http://www.w3.org/1999/xhtml=
" href=3D"#Specifying-And-Using-Foreign-Types" title=3D"12.1.=C3=82=C2=A0Sp=
ecifying And Using Foreign Types">foreign
+ above, or an equivalent <a xmlns=3D"http://www.w3.org/1999/xhtml=
" class=3D"link" href=3D"#Specifying-And-Using-Foreign-Types" title=3D"12.1=
.=C3=82=C2=A0Specifying And Using Foreign Types">foreign
type specifier</a>.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525019">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431657">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Calls the foreig=
n function at the address obtained by
resolving the external-entry-point associated with name, passing
@@ -14098,7 +14100,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">%ff-call</strong></span> entrypoint
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>%ff-call</strong></span> entrypoint
{arg-type-keyword arg}* <em xmlns=3D"http://www.w3.org/1999/xhtml" =
class=3D"varname">&optional</em> result-type-keyword
</code>
</div>
@@ -14107,7 +14109,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525074">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431717">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">entrypoint</span></i>---A fixnum or MACPTR</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">arg-type-keyword</span></i>---One of the foreign argument-type ke=
ywords, described
@@ -14118,7 +14120,7 @@
above</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525139">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431780">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Calls the foreig=
n function at address entrypoint passing the
values of each arg as a foreign argument of type indicated by the
@@ -14135,7 +14137,7 @@
<strong>[Macro]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">ff-call</strong></span> entrypoint
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>ff-call</strong></span> entrypoint
{arg-type-specifier arg}* <em xmlns=3D"http://www.w3.org/1999/xhtml=
" class=3D"varname">&optional</em> result-type-specifier
</code>
</div>
@@ -14144,20 +14146,20 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525193">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431839">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">entrypoint</span></i>---A fixnum or MACPTR</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">arg-type-specifer</span></i>---One of the foreign argument-type k=
eywords, described
- above, or an equivalent <a xmlns=3D"http://www.w3.org/1999/xhtml=
" href=3D"#Specifying-And-Using-Foreign-Types" title=3D"12.1.=C3=82=C2=A0Sp=
ecifying And Using Foreign Types">foreign
+ above, or an equivalent <a xmlns=3D"http://www.w3.org/1999/xhtml=
" class=3D"link" href=3D"#Specifying-And-Using-Foreign-Types" title=3D"12.1=
.=C3=82=C2=A0Specifying And Using Foreign Types">foreign
type specifier</a>.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">arg</span></i>---A lisp value of type indicated by the correspond=
ing
arg-type-specifier</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result-type-specifier</span></i>---One of the foreign argument-ty=
pe keywords, described
- above, or an equivalent <a xmlns=3D"http://www.w3.org/1999/xhtml=
" href=3D"#Specifying-And-Using-Foreign-Types" title=3D"12.1.=C3=82=C2=A0Sp=
ecifying And Using Foreign Types">foreign
+ above, or an equivalent <a xmlns=3D"http://www.w3.org/1999/xhtml=
" class=3D"link" href=3D"#Specifying-And-Using-Foreign-Types" title=3D"12.1=
.=C3=82=C2=A0Specifying And Using Foreign Types">foreign
type specifier</a>.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525267">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431912">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Calls the foreig=
n function at address entrypoint passing the
values of each arg as a foreign argument of type indicated by the
@@ -14174,7 +14176,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">foreign-symbol-address</strong></span> name
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>foreign-symbol-address</strong></span> name
</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -14182,16 +14184,16 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525318">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431968">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">name</span></i>---A lisp string.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525340">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id431990">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Tries to resolve=
the address of the foreign symbol
name. If successful, returns that address encapsulated in
- <a href=3D"#Referencing-and-Using-Foreign-Memory-Addresses" title=
=3D"12.3.=C3=82=C2=A0Referencing and Using Foreign Memory Addresses">a
+ <a class=3D"link" href=3D"#Referencing-and-Using-Foreign-Memory-Add=
resses" title=3D"12.3.=C3=82=C2=A0Referencing and Using Foreign Memory Addr=
esses">a
MACPTR</a>, else returns NIL.</p>
</div>
</div>
@@ -14202,7 +14204,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">foreign-symbol-entry</strong></span> name
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>foreign-symbol-entry</strong></span> name
</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -14210,12 +14212,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525392">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432050">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">name</span></i>---A lisp string.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525414">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432072">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Tries to resolve=
the address of the foreign symbol name. If
successful, returns a fixnum representation of that address, else
@@ -14229,7 +14231,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">free</strong></span> ptr
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>free</strong></span> ptr
</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -14237,13 +14239,13 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525461">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432126">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">ptr</span></i>---A <code xmlns=3D"http://www.w3.org/1999/xhtml" c=
lass=3D"code">MACPTR</code> that points to a block of
foreign, heap-allocated memory.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525488">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432152">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In Clozure CL 1.=
2 and later, the <code class=3D"code">CCL:FREE</code>
function invokes the foreign <code class=3D"code">free</code> fu=
nction from
@@ -14266,7 +14268,7 @@
<strong>[Macro]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">make-gcable-record</strong></span> typespec
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>make-gcable-record</strong></span> typespec
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&r=
est</em> initforms =3D> result
</code>
</div>
@@ -14275,7 +14277,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525572">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432243">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">typespec</span></i>---A foreign type specifier, or a keyword whic=
h is used
as the name of a foreign struct or union.</p>
@@ -14284,20 +14286,20 @@
otherwise, a list of alternating field names and
values appropriate for the types of those fields.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---
- A <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"=
type">macptr</strong></span> which encapsulates the address of a
+ A <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"type"><s=
trong>macptr</strong></span> which encapsulates the address of a
newly-allocated record on the foreign heap. The foreign
- object returned by <span xmlns=3D"http://www.w3.org/1999/xhtml">=
<strong class=3D"function">make-gcable-record</strong></span>
+ object returned by <span xmlns=3D"http://www.w3.org/1999/xhtml" =
class=3D"function"><strong>make-gcable-record</strong></span>
is freed when the garbage collector determines that
the <code xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"code">=
MACPTR</code> object that describes it is
unreachable.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525642">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432310">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Allocates a block of foreign memory suitable to hold the foreign
type described by <code class=3D"code">typespec</code>, in the same=
manner
- as <a href=3D"#anchor_make-record">MAKE-RECORD</a>. In
+ as <a class=3D"link" href=3D"#anchor_make-record">MAKE-RECORD</a>. =
In
addition, <code class=3D"code">MAKE-GCABLE-RECORD</code> marks the
returned object gcable; in other words, it informs the garbage
collector that it may reclaim the object when it becomes
@@ -14305,7 +14307,7 @@
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In all other res=
pects, <code class=3D"code">MAKE-GCABLE-RECORD</code> works
the same way
- as <a href=3D"#anchor_make-record">MAKE-RECORD</a></p>
+ as <a class=3D"link" href=3D"#anchor_make-record">MAKE-RECORD</a=
></p>
<p xmlns=3D"http://www.w3.org/1999/xhtml"> When using gcab=
le pointers, it's important to remember the
distinction between a <code class=3D"code">MACPTR</code> object =
(which is a
lisp object, more or less like any other) and the block of
@@ -14332,7 +14334,7 @@
<strong>[Macro]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">make-record</strong></span> typespec
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>make-record</strong></span> typespec
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&r=
est</em> initforms =3D> result
</code>
</div>
@@ -14341,7 +14343,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525758">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432426">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">typespec</span></i>---A foreign type specifier, or a keyword whic=
h is used
as the name of a foreign struct or union.</p>
@@ -14350,21 +14352,21 @@
otherwise, a list of alternating field names and
values appropriate for the types of those fields.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">result</span></i>---
- A <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"=
type">macptr</strong></span> which encapsulates the address of a
+ A <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"type"><s=
trong>macptr</strong></span> which encapsulates the address of a
newly-allocated record on the foreign heap.
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525819">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432484">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Expands into code which allocates and initializes
an instance of the type =
denoted by <em class=3D"varname">typespec</em>, on the foreign
heap. The record is allocated using the C function
- <span><strong class=3D"function">malloc</strong></span>, and the us=
er of
- <span><strong class=3D"function">make-record</strong></span> must e=
xplicitly call
- the function <span><strong class=3D"function">CCL:FREE</strong></sp=
an> to deallocate the
+ <span class=3D"function"><strong>malloc</strong></span>, and the us=
er of
+ <span class=3D"function"><strong>make-record</strong></span> must e=
xplicitly call
+ the function <span class=3D"function"><strong>CCL:FREE</strong></sp=
an> to deallocate the
record, when it is no longer needed.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
@@ -14372,7 +14374,7 @@
or values are used in the initialization. When the type
is a scalar, <em class=3D"varname">initforms</em> is either a single
value which can be coerced to that type, or no value, in which
- case binary 0 is used. When the type is a <span><strong class=3D"t=
ype">struct</strong></span>,
+ case binary 0 is used. When the type is a <span class=3D"type"><st=
rong>struct</strong></span>,
<em class=3D"varname">initforms</em> is a list, giving field names
and the values for each. Each field is treated in the same way
as a scalar is: If a value for it is given, it must be
@@ -14380,35 +14382,35 @@
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
When the type is an array, <em class=3D"varname">initforms</em> may
- not be provided, because <span><strong class=3D"function">make-reco=
rd</strong></span>
- cannot initialize its values. <span><strong class=3D"function">mak=
e-record</strong></span>
- is also unable to initialize fields of a <span><strong class=3D"typ=
e">struct</strong></span>
+ not be provided, because <span class=3D"function"><strong>make-reco=
rd</strong></span>
+ cannot initialize its values. <span class=3D"function"><strong>mak=
e-record</strong></span>
+ is also unable to initialize fields of a <span class=3D"type"><stro=
ng>struct</strong></span>
which are themselves
- <span><strong class=3D"type">struct</strong></span>s. The user of
- <span><strong class=3D"function">make-record</strong></span> should=
set these values
+ <span class=3D"type"><strong>struct</strong></span>s. The user of
+ <span class=3D"function"><strong>make-record</strong></span> should=
set these values
by another means.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
A possibly-significant limitation is that it must be possible to
find the foreign type at the time the macro is expanded;
- <span><strong class=3D"function">make-record</strong></span> signal=
s an error if this is
+ <span class=3D"function"><strong>make-record</strong></span> signal=
s an error if this is
not the case.
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525905">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432574">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- It is inconvenient that <span><strong class=3D"function">make-recor=
d</strong></span> is a
+ It is inconvenient that <span class=3D"function"><strong>make-recor=
d</strong></span> is a
macro, because this means that <em class=3D"varname">typespec</em>
cannot be a variable; it must be an immediate value.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
If it weren't for this requirement,
- <span><strong class=3D"function">make-record</strong></span> could =
be a function. However,
+ <span class=3D"function"><strong>make-record</strong></span> could =
be a function. However,
that would mean that any stand-alone application using it would
have to include a copy of the interface database
- (see <a href=3D"#The-Interface-Database" title=3D"12.4.=C3=82=C2=A0=
The Interface Database">Section=C3=82=C2=A012.4, =C3=A2=C2=80=C2=9CThe Inte=
rface Database=C3=A2=C2=80=C2=9D</a>), which is undesirable
+ (see <a class=3D"xref" href=3D"#The-Interface-Database" title=3D"12=
.4.=C3=82=C2=A0The Interface Database">Section=C3=82=C2=A012.4, =C3=A2=C2=
=80=C2=9CThe Interface Database=C3=A2=C2=80=C2=9D</a>), which is undesirable
because it's large.
</p>
</div>
@@ -14420,7 +14422,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">open-shared-library</strong></span> name =3D> library
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>open-shared-library</strong></span> name =3D> library
</code>
</div>
<div class=3D"refentrytitle">Asks the operating system to load=
a shared library
@@ -14429,7 +14431,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id525978">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432657">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">name</span></i>---A SIMPLE-STRING which is presumed to be the so-=
name of
or a filesystem path to the library.</p>
@@ -14437,7 +14439,7 @@
library denoted by <em xmlns=3D"http://www.w3.org/1999/xhtml" cl=
ass=3D"varname">name</em>.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526019">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432697">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If the library d=
enoted by <em class=3D"varname">name</em> can
be loaded by the
@@ -14448,7 +14450,7 @@
operating system.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526038">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432713">=
</a>
<div class=3D"header">Examples:</div>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"progr=
amlisting">;;; Try to do something simple.
? (open-shared-library "libgtk.so")
@@ -14483,7 +14485,7 @@
#<EXTERNAL-ENTRY-POINT "gtk_main" {unresolved} libgtk.so #x30=
46FE46></pre>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526048">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432733">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">It would be help=
ful to describe what an soname is and give
examples of one.</p>
@@ -14498,7 +14500,7 @@
<strong>[Macro]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">pref</strong></span> ptr accessor-form
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>pref</strong></span> ptr accessor-form
</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -14506,15 +14508,15 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526099">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432791">=
</a>
<div class=3D"header">Values:</div>
- <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">ptr</span></i>---<a xmlns=3D"http://www.w3.org/1999/xhtml" href=
=3D"#Referencing-and-Using-Foreign-Memory-Addresses" title=3D"12.3.=C3=82=
=C2=A0Referencing and Using Foreign Memory Addresses">a MACPTR</a>.</p>
+ <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">ptr</span></i>---<a xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"link" href=3D"#Referencing-and-Using-Foreign-Memory-Addresses" title=3D=
"12.3.=C3=82=C2=A0Referencing and Using Foreign Memory Addresses">a MACPTR<=
/a>.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">accessor-form</span></i>---a keyword which names a foreign type o=
r record, as
- described in <a xmlns=3D"http://www.w3.org/1999/xhtml" href=3D"#=
Foreign-type--record--and-field-names" title=3D"12.8.3.=C3=82=C2=A0Foreign =
type, record, and field names">Section=C3=82=C2=A012.8.3, =C3=A2=C2=80=C2=
=9CForeign type, record, and field names=C3=A2=C2=80=C2=9D</a>.
+ described in <a xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
xref" href=3D"#Foreign-type--record--and-field-names" title=3D"12.8.3.=C3=
=82=C2=A0Foreign type, record, and field names">Section=C3=82=C2=A012.8.3, =
=C3=A2=C2=80=C2=9CForeign type, record, and field names=C3=A2=C2=80=C2=9D</=
a>.
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526142">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432835">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">References an in=
stance of a foreign type (or a component of
a foreign type) accessible via ptr.</p>
@@ -14532,7 +14534,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">%reference-external-entry-point</strong></span> eep
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>%reference-external-entry-point</strong></span> eep
</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -14540,13 +14542,13 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526202">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432901">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">eep</span></i>---An EXTERNAL-ENTRY-POINT, as obtained by the EXTE=
RNAL
macro.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526226">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432924">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Tries to resolve=
the address of the EXTERNAL-ENTRY-POINT
eep; returns a fixnum representation of that address if
@@ -14561,7 +14563,7 @@
<strong>[Macro]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">rlet</strong></span> (var typespec <em xmlns=3D"http://www.w3.org/1999=
/xhtml" class=3D"varname">&rest</em> initforms)*
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>rlet</strong></span> (var typespec <em xmlns=3D"http://www.w3.org/1999=
/xhtml" class=3D"varname">&rest</em> initforms)*
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&b=
ody</em> body
</code>
</div>
@@ -14570,22 +14572,22 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526284">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432988">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">var</span></i>---A symbol (a lisp variable)</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">typespec</span></i>---A foreign type specifier or foreign record =
name.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">initforms</span></i>---As described above, for
- <a xmlns=3D"http://www.w3.org/1999/xhtml" href=3D"#m_make-record=
" title=3D"Macro MAKE-RECORD"><b xmlns=3D"http://www.w3.org/TR/xhtml1/trans=
itional">make-record</b></a></p>
- </div>
- <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526335">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"xref" href=3D=
"#m_make-record" title=3D"Macro MAKE-RECORD"><b xmlns=3D"http://www.w3.org/=
TR/xhtml1/transitional">make-record</b></a></p>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433039">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Executes <em cla=
ss=3D"varname">body</em>
in an environment in which each var is bound
- to <a href=3D"#Referencing-and-Using-Foreign-Memory-Addresses" titl=
e=3D"12.3.=C3=82=C2=A0Referencing and Using Foreign Memory Addresses">a MAC=
PTR</a> encapsulating the
+ to <a class=3D"link" href=3D"#Referencing-and-Using-Foreign-Memory-=
Addresses" title=3D"12.3.=C3=82=C2=A0Referencing and Using Foreign Memory A=
ddresses">a MACPTR</a> encapsulating the
address of a stack-allocated foreign memory block, allocated and
initialized from typespec and initforms as per
- <a href=3D"#m_make-record" title=3D"Macro MAKE-RECORD"><b xmlns=3D"=
http://www.w3.org/TR/xhtml1/transitional">make-record</b></a>.
+ <a class=3D"xref" href=3D"#m_make-record" title=3D"Macro MAKE-RECOR=
D"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">make-record</b></a=
>.
Returns whatever value(s) <em class=3D"varname">body</em>
returns.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Record fields th=
at aren't explicitly initialized have
@@ -14599,7 +14601,7 @@
<strong>[Macro]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">rletz</strong></span> (var typespec <em xmlns=3D"http://www.w3.org/199=
9/xhtml" class=3D"varname">&rest</em> initforms)*
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>rletz</strong></span> (var typespec <em xmlns=3D"http://www.w3.org/199=
9/xhtml" class=3D"varname">&rest</em> initforms)*
<em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&b=
ody</em> body
</code>
</div>
@@ -14608,17 +14610,17 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526408">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433120">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">var</span></i>---A symbol (a lisp variable)</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">typespec</span></i>---A foreign type specifier or foreign record =
name.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">initforms</span></i>---As described above, for ccl:make-record</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526457">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433168">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Executes body in=
an environment in which each var is
- bound to <a href=3D"#Referencing-and-Using-Foreign-Memory-Addresses=
" title=3D"12.3.=C3=82=C2=A0Referencing and Using Foreign Memory Addresses"=
>a
+ bound to <a class=3D"link" href=3D"#Referencing-and-Using-Foreign-M=
emory-Addresses" title=3D"12.3.=C3=82=C2=A0Referencing and Using Foreign Me=
mory Addresses">a
MACPTR</a> encapsulating the address of a stack-allocated
foreign memory block, allocated and initialized from
typespec and initforms as ccl:make-record.</p>
@@ -14634,7 +14636,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">terminate-when-unreachable</strong></span> object
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>terminate-when-unreachable</strong></span> object
</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -14642,15 +14644,15 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526518">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433236">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">object</span></i>---A CLOS object of a class for which there exis=
ts
a method of the generic function
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"fu=
nction">ccl:terminate</strong></span>.
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function">=
<strong>ccl:terminate</strong></span>.
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526546">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433264">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
The "termination" mechanism is a way to have the garbage
@@ -14666,28 +14668,28 @@
When the garbage collector discovers that an object is no
longer referred to anywhere in the program, it deallocates
that object, freeing its memory. However, if
- <span><strong class=3D"function">ccl:terminate-when-unreachable</st=
rong></span> has been
+ <span class=3D"function"><strong>ccl:terminate-when-unreachable</st=
rong></span> has been
called on the object at any time, the garbage collector first
- invokes the generic function <span><strong class=3D"function">ccl:t=
erminate</strong></span>,
+ invokes the generic function <span class=3D"function"><strong>ccl:t=
erminate</strong></span>,
passing it the object as a parameter.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Therefore, to make termination do something useful, you need to
- define a method on <span><strong class=3D"function">ccl:terminate</=
strong></span>.
+ define a method on <span class=3D"function"><strong>ccl:terminate</=
strong></span>.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Because calling
- <span><strong class=3D"function">ccl:terminate-when-unreachable</st=
rong></span> only
+ <span class=3D"function"><strong>ccl:terminate-when-unreachable</st=
rong></span> only
affects a single object, rather than all objects of its
class, you
may wish to put a call to it in the
- <span><strong class=3D"function">initialize-instance</strong></span=
> method of a
+ <span class=3D"function"><strong>initialize-instance</strong></span=
> method of a
class. Of course, this is only appropriate if you do in fact
want to use termination for all objects of a given class.
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526595">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433320">=
</a>
<div class=3D"header">Example:</div>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"progr=
amlisting">
(defclass resource-wrapper ()
@@ -14701,10 +14703,10 @@
(deallocate (resource x))))</pre>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526612">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433335">=
</a>
<div class=3D"header">See Also:</div>
<span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simp=
lelist">
- <a href=3D"#Tutorial--Allocating-Foreign-Data-on-the-Lis=
p-Heap" title=3D"12.11.=C3=82=C2=A0Tutorial: Allocating Foreign Data on the=
Lisp Heap">Section=C3=82=C2=A012.11, =C3=A2=C2=80=C2=9CTutorial: Allocatin=
g Foreign Data on the Lisp Heap =C3=A2=C2=80=C2=9D</a>
+ <a class=3D"xref" href=3D"#Tutorial--Allocating-Foreign-=
Data-on-the-Lisp-Heap" title=3D"12.11.=C3=82=C2=A0Tutorial: Allocating Fore=
ign Data on the Lisp Heap">Section=C3=82=C2=A012.11, =C3=A2=C2=80=C2=9CTuto=
rial: Allocating Foreign Data on the Lisp Heap =C3=A2=C2=80=C2=9D</a>
</span>
</div>
</div>
@@ -14715,7 +14717,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">unuse-interface-dir</strong></span> dir-id
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>unuse-interface-dir</strong></span> dir-id
</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -14723,14 +14725,14 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526663">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433395">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">dir-id</span></i>---A keyword whose pname, mapped to lower case, =
names a
subdirectory of "ccl:headers;" (or
"ccl:darwin-headers;")</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526688">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433419">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Tells <code clas=
s=3D"literal">CCL</code> to remove the interface directory denoted by
dir-id from the list of interface directories which are
@@ -14746,7 +14748,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"funct=
ion">use-interface-dir</strong></span> dir-id
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><st=
rong>use-interface-dir</strong></span> dir-id
</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -14754,20 +14756,20 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526740">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433479">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">dir-id</span></i>---A keyword whose pname, mapped to lower case, =
names a
subdirectory of "ccl:headers;" (or
"ccl:darwin-headers;")</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526765">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433502">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Tells <code clas=
s=3D"literal">CCL</code> to add the interface directory denoted by
dir-id to the list of interface directories which it consults for
foreign type and function information. Arranges that that
directory is searched before any others.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">Note that <span>=
<strong class=3D"function">use-interface-dir</strong></span>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">Note that <span =
class=3D"function"><strong>use-interface-dir</strong></span>
merely adds an entry
to a search list.
If the named directory doesn't exist in the file system
@@ -14778,12 +14780,12 @@
will try to
open such a database file whenever it needs to find any
foreign type or
- function information. <a href=3D"#f_unuse-interface-dir" title=3D"F=
unction UNUSE-INTERFACE-DIR"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transi=
tional">unuse-interface-dir</b></a>
+ function information. <a class=3D"xref" href=3D"#f_unuse-interface-=
dir" title=3D"Function UNUSE-INTERFACE-DIR"><b xmlns=3D"http://www.w3.org/T=
R/xhtml1/transitional">unuse-interface-dir</b></a>
may come in
handy in that case.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id526801">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id433541">=
</a>
<div class=3D"header">Examples:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">One typically wa=
nts interface information to be
available at compile-time (or, in many cases, at read-time).
@@ -14886,12 +14888,12 @@
<dl>
<dt>
<span class=3D"sect2">
- <a href=3D"#id514534">13.6.1. Using <code class=3D"lit=
eral">define-objc-method</code></a>
+ <a href=3D"#id412131">13.6.1. Using <code class=3D"lit=
eral">define-objc-method</code></a>
</span>
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id429654">13.6.2. Using <code class=3D"lit=
eral">objc:defmethod</code></a>
+ <a href=3D"#id412374">13.6.2. Using <code class=3D"lit=
eral">objc:defmethod</code></a>
</span>
</dt>
<dt>
@@ -14945,7 +14947,7 @@
convenient than before to refer to several classes of symbols used
with the Objective-C bridge. For a full description of these
reader-macros, see
- the <a href=3D"#anchor_Foreign-Function-Interface-Dictionary">Foreign-=
Function-Interface
+ the <a class=3D"link" href=3D"#anchor_Foreign-Function-Interface-Dicti=
onary">Foreign-Function-Interface
Dictionary</a>, especially the entries at the beginning,
describing reader macros.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">As in previous release=
s, 32-bit versions of Clozure CL use 32-bit
@@ -14969,7 +14971,7 @@
<code class=3D"literal">NS:+NS-OBJECT</code>) which defines the clas=
s from Lisp.
The class's Lisp name is now proclaimed to be a "static"
variable (as if by <code class=3D"literal">DEFSTATIC</code>, as desc=
ribed in the
- <a href=3D"#Static_Variables" title=3D"4.6.=C3=82=C2=A0Static Variab=
les">"Static Variables"
+ <a class=3D"link" href=3D"#Static_Variables" title=3D"4.6.=C3=82=C2=
=A0Static Variables">"Static Variables"
section</a>) and given the class object as its value. In
other words:</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programlist=
ing">
@@ -15206,7 +15208,7 @@
[v2 setBounds r];
</pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In Lisp, we must exp=
licitly allocate the memory, which
- is done most easily and safely with <a href=3D"#m_rlet" title=3D"M=
acro RLET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">rlet</b></=
a>.
+ is done most easily and safely with <a class=3D"xref" href=3D"#m_r=
let" title=3D"Macro RLET"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transitio=
nal">rlet</b></a>.
We do it like this:</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programli=
sting">
(rlet ((r :<NSR>ect))
@@ -15497,12 +15499,12 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id514534"></a>13.6.1.=C3=82=
=C2=A0Using <code class=3D"literal">define-objc-method</code></h3>
+ <h3 class=3D"title"><a id=3D"id412131"></a>13.6.1.=C3=82=
=C2=A0Using <code class=3D"literal">define-objc-method</code></h3>
</div>
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">As described in the
- section <a href=3D"#Calling-Objective-C-Methods" title=3D"13.4.=C3=
=82=C2=A0Calling Objective-C Methods">Calling
+ section <a class=3D"link" href=3D"#Calling-Objective-C-Methods" ti=
tle=3D"13.4.=C3=82=C2=A0Calling Objective-C Methods">Calling
Objective-C Methods</a>, the names of Objective-C methods
are broken into pieces, each piece followed by a parameter.
The types of all parameters must be explicitly
@@ -15614,7 +15616,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id429654"></a>13.6.2.=C3=82=
=C2=A0Using <code class=3D"literal">objc:defmethod</code></h3>
+ <h3 class=3D"title"><a id=3D"id412374"></a>13.6.2.=C3=82=
=C2=A0Using <code class=3D"literal">objc:defmethod</code></h3>
</div>
</div>
</div>
@@ -15771,7 +15773,7 @@
<p xmlns=3D"http://www.w3.org/1999/xhtml">If interface databases=
don't exist for a framework you want
to use, you will need to create them. For more information about
creating interface databases,
- see <a href=3D"#Creating-new-interface-directories" title=3D"12.5.2.=
=C3=82=C2=A0Creating new interface directories">Creating
+ see <a class=3D"link" href=3D"#Creating-new-interface-directories" tit=
le=3D"12.5.2.=C3=82=C2=A0Creating new interface directories">Creating
new interface directories</a>.</p>
</div>
<div class=3D"sect1" lang=3D"en" xml:lang=3D"en">
@@ -15974,7 +15976,7 @@
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Fixnums on 32-bit sy=
stems use 30 bits and are in the
range XXX through YYY. Fixnums on 64-bit systems use 61-bits
- and are in the range XXX through YYY. (see <a href=3D"#Tagging-scheme=
" title=3D"16.2.4.=C3=82=C2=A0Tagging scheme">Section=C3=82=C2=A016.2.4, =
=C3=A2=C2=80=C2=9CTagging scheme=C3=A2=C2=80=C2=9D</a>)</p>
+ and are in the range XXX through YYY. (see <a class=3D"xref" href=3D"=
#Tagging-scheme" title=3D"16.2.4.=C3=82=C2=A0Tagging scheme">Section=C3=82=
=C2=A016.2.4, =C3=A2=C2=80=C2=9CTagging scheme=C3=A2=C2=80=C2=9D</a>)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Since we have much l=
arger fixnums on 64-bit systems,
<em class=3D"varname">INTERNAL-TIME-UNITS-PER-SECOND</em> is 1000000
on 64-bit systems but remains 1000 on 32-bit systems. This
@@ -16122,7 +16124,7 @@
<p xmlns=3D"http://www.w3.org/1999/xhtml">For process IDs, there=
is CCL::GETPID.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">For the <code class=3D=
"literal">system()</code> function, there is
CCL::OS-COMMAND. Ordinarily, it is better - both more efficient
- and more predictable - to use the features described in <a href=3D"#=
Running-Other-Programs-as-Subprocesses" title=3D"Chapter=C3=82=C2=A09.=C3=
=82=C2=A0Running Other Programs as Subprocesses">Chapter=C3=82=C2=A09, <i>R=
unning Other Programs as Subprocesses</i></a>. However,
+ and more predictable - to use the features described in <a class=3D"=
xref" href=3D"#Running-Other-Programs-as-Subprocesses" title=3D"Chapter=C3=
=82=C2=A09.=C3=82=C2=A0Running Other Programs as Subprocesses">Chapter=C3=
=82=C2=A09, <i>Running Other Programs as Subprocesses</i></a>. However,
sometimes you may want to specifically ask the shell to invoke a
command for you.</p>
</div>
@@ -16203,28 +16205,28 @@
<table xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"simplel=
ist" border=3D"0" summary=3D"Simple list">
<tr>
<td>
- <a href=3D"#m_class" title=3D"Macro CCL::@CLASS">
+ <a class=3D"xref" href=3D"#m_class" title=3D"Macro CCL::=
@CLASS">
<b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
ccl::@class</b>
</a>
</td>
</tr>
<tr>
<td>
- <a href=3D"#m_selector" title=3D"Macro CCL::@SELECTOR">
+ <a class=3D"xref" href=3D"#m_selector" title=3D"Macro CC=
L::@SELECTOR">
<b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
ccl::@selector</b>
</a>
</td>
</tr>
<tr>
<td>
- <a href=3D"#m_define-objc-method" title=3D"Macro CCL::DE=
FINE-OBJC-METHOD">
+ <a class=3D"xref" href=3D"#m_define-objc-method" title=
=3D"Macro CCL::DEFINE-OBJC-METHOD">
<b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
ccl::define-objc-method</b>
</a>
</td>
</tr>
<tr>
<td>
- <a href=3D"#m_define-objc-class-method" title=3D"Macro C=
CL::DEFINE-OBJC-CLASS-METHOD">
+ <a class=3D"xref" href=3D"#m_define-objc-class-method" t=
itle=3D"Macro CCL::DEFINE-OBJC-CLASS-METHOD">
<b xmlns=3D"http://www.w3.org/TR/xhtml1/transitional">=
ccl::define-objc-class-method</b>
</a>
</td>
@@ -16368,7 +16370,7 @@
<dl>
<dt>
<span class=3D"term">
- <a href=3D"http://developer.apple.com/documentation/Cocoa/" target=
=3D"_top">Cocoa Documentation</a>
+ <a class=3D"ulink" href=3D"http://developer.apple.com/documentation=
/Cocoa/" target=3D"_top">Cocoa Documentation</a>
</span>
</dt>
<dd>
@@ -16380,7 +16382,7 @@
</dd>
<dt>
<span class=3D"term">
- <a href=3D"http://developer.apple.com/documentation/Cocoa/Reference=
/Foundation/ObjC_classic/index.html" target=3D"_top">Foundation Reference f=
or Objective-C</a>
+ <a class=3D"ulink" href=3D"http://developer.apple.com/documentation=
/Cocoa/Reference/Foundation/ObjC_classic/index.html" target=3D"_top">Founda=
tion Reference for Objective-C</a>
</span>
</dt>
<dd>
@@ -16392,7 +16394,7 @@
</dd>
<dt>
<span class=3D"term">
- <a href=3D"http://developer.apple.com/documentation/Cocoa/Reference=
/ApplicationKit/ObjC_classic/index.html" target=3D"_top">Application Kit Re=
ference for Objective-C</a>
+ <a class=3D"ulink" href=3D"http://developer.apple.com/documentation=
/Cocoa/Reference/ApplicationKit/ObjC_classic/index.html" target=3D"_top">Ap=
plication Kit Reference for Objective-C</a>
</span>
</dt>
<dd>
@@ -16403,7 +16405,7 @@
</dd>
<dt>
<span class=3D"term">
- <a href=3D"http://developer.apple.com/documentation/index.html" tar=
get=3D"_top">Apple Developer Documentation</a>
+ <a class=3D"ulink" href=3D"http://developer.apple.com/documentation=
/index.html" target=3D"_top">Apple Developer Documentation</a>
</span>
</dt>
<dd>
@@ -16430,14 +16432,14 @@
<a id=3D"f_getenv"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">getenv</strong></span> name =3D> value</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>getenv</strong></span> name =3D> value</code>
</div>
<div class=3D"refentrytitle"></div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id514161">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id424628">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">name</span></i>---a string which is the name of an existing
environment variable;
@@ -16447,7 +16449,7 @@
is not, NIL</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id442162">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id424673">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Looks up the value of the environment variable named by
@@ -16461,14 +16463,14 @@
<a id=3D"f_setenv"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">setenv</strong></span> name value =3D> errno</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>setenv</strong></span> name value =3D> errno</code>
</div>
<div class=3D"refentrytitle"></div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id429403">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id424734">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">name</span></i>---a string which is the name of a new or existing
environment variable;
@@ -16481,7 +16483,7 @@
the problem</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id457013">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id424794">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Sets the value of the environment variable named by
@@ -16497,7 +16499,7 @@
<a id=3D"f_current-directory-name"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">current-directory-name</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>current-directory-name</strong></span>
=3D> path</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -16505,13 +16507,13 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id459722">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id424856">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">path</span></i>---a string, an absolute pathname in Posix format =
- with
directory components separated by slashes</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id435895">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id424883">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Looks up the current working directory of the Clozure CL process;
@@ -16526,20 +16528,20 @@
<a id=3D"f_getuid"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">getuid</strong></span> =3D> uid</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>getuid</strong></span> =3D> uid</code>
</div>
<div class=3D"refentrytitle"></div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id499197">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id424942">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">uid</span></i>---a non-negative integer, identifying a specific u=
ser
account as defined in the OS user database</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id453781">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id424969">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Returns the ("real") user ID of the current user.
@@ -16552,14 +16554,14 @@
<a id=3D"f_setuid"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">setuid</strong></span> uid =3D> errno</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>setuid</strong></span> uid =3D> errno</code>
</div>
<div class=3D"refentrytitle"></div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id518744">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425026">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">uid</span></i>---a non-negative integer, identifying a specific u=
ser
account as defined in the OS user database</p>
@@ -16568,7 +16570,7 @@
the problem</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id475192">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425069">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Attempts to change the current user ID (both "real" and
@@ -16584,14 +16586,14 @@
<a id=3D"f_setgid"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">setgid</strong></span> gid =3D> errno</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>setgid</strong></span> gid =3D> errno</code>
</div>
<div class=3D"refentrytitle"></div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id489525">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425128">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">gid</span></i>---a non-negative integer, identifying a specific
group as defined in the OS user database</p>
@@ -16600,7 +16602,7 @@
the problem</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id501016">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425171">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Attempts to change the current group ID (both "real" and
@@ -16616,19 +16618,19 @@
<a id=3D"f_getpid"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">getpid</strong></span> =3D> pid</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>getpid</strong></span> =3D> pid</code>
</div>
<div class=3D"refentrytitle"></div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id500633">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425230">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">pid</span></i>---a non-negative integer, identifying an OS proces=
s</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id500657">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425256">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Returns the ID of the Clozure CL OS process.
@@ -16641,7 +16643,7 @@
<a id=3D"f_get-user-home-dir"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">get-user-home-dir</strong></span> =
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>get-user-home-dir</strong></span> =
uid =3D> path</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -16649,7 +16651,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id428957">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425590">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">uid</span></i>---a non-negative integer, identifying a specific u=
ser
account as defined in the OS user database</p>
@@ -16657,7 +16659,7 @@
directory components separated by slashes; or NIL</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id510273">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425633">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Looks up and returns the defined home directory of the user
@@ -16674,7 +16676,7 @@
<a id=3D"f_os-command"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">os-command</strong></span> command-line
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>os-command</strong></span> command-line
=3D> exit-code</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -16682,7 +16684,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id499360">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425702">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">command-line</span></i>---a string, obeying all the whitespace and
escaping
@@ -16691,10 +16693,10 @@
code of a subprocess; zero indicates success</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id502706">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425744">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- Invokes the Posix function <span><strong class=3D"function">system(=
)</strong></span>, which
+ Invokes the Posix function <span class=3D"function"><strong>system(=
)</strong></span>, which
invokes the user's default system shell (such as
sh or tcsh) as a new process, and has that shell execute
<em class=3D"varname">command-line</em>.
@@ -16707,7 +16709,7 @@
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id452659">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425778">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
By convention, an exit code of 0 indicates success. There are
@@ -16725,27 +16727,27 @@
<a id=3D"m_class"></a>
<strong>[Macro]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">@class</strong></span> class-name</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>@class</strong></span> class-name</code>
</div>
<div class=3D"refentrytitle"></div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id474077">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425838">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">class-name</span></i>---a string which denotes an existing class =
name, or a
symbol which can be mapped to such a string via the standard
name-mapping conventions for class names</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id493721">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425866">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Used to refer to=
a known ObjC class by name. (Via the use
LOAD-TIME-VALUE, the results of a class-name -> class lookup
are cached.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <span><strong class=3D"function">@class</strong></span> is obsolete=
as of late 2004, because
+ <span class=3D"function"><strong>@class</strong></span> is obsolete=
as of late 2004, because
find-class now works on ObjC classes. It is described here
only because some old code still uses it.
</p>
@@ -16757,20 +16759,20 @@
<a id=3D"m_selector"></a>
<strong>[Macro]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">@selector</strong></span> string</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>@selector</strong></span> string</code>
</div>
<div class=3D"refentrytitle"></div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id427151">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425935">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">string</span></i>---a string constant, used to canonically refer =
to an
ObjC method selector</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id492449">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id425961">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Used to refer to=
an ObjC method selector (method name). Uses
LOAD-TIME-VALUE to cache the result of a string -> selector
@@ -16783,7 +16785,7 @@
<a id=3D"m_objc-defmethod"></a>
<strong>[Macro]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">objc:defmethod</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>objc:defmethod</strong></span>
name-and-result-type ((receiver-arg-and-class) <em xmlns=3D"http://=
www.w3.org/1999/xhtml" class=3D"varname">&rest</em>
other-args) <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"var=
name">&body</em> body</code>
</div>
@@ -16792,7 +16794,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id430630">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426027">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">name-and-result-type</span></i>---either an Objective-C message n=
ame, for methods
that return a value of type <code xmlns=3D"http://www.w3.o=
rg/1999/xhtml" class=3D"literal">:ID</code>, or
@@ -16814,7 +16816,7 @@
is a foreign type specifier.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id465085">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426108">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Defines an Objec=
tive-C-callable method which implements
the specified message selector for instances of the existing
@@ -16822,7 +16824,7 @@
<p xmlns=3D"http://www.w3.org/1999/xhtml">For a detailed d=
escription of the features and
restrictions of the <code class=3D"literal">OBJC:DEFMETHOD</code=
> macro,
see the
- section <a href=3D"#anchor_Using-objc-defmethod">Using <code cla=
ss=3D"literal">objc:defmethod</code></a>.</p>
+ section <a class=3D"link" href=3D"#anchor_Using-objc-defmethod">=
Using <code class=3D"literal">objc:defmethod</code></a>.</p>
</div>
</div>
</p>
@@ -16831,7 +16833,7 @@
<a id=3D"m_define-objc-method"></a>
<strong>[Macro]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">define-objc-method</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>define-objc-method</strong></span>
(selector class-name) <em xmlns=3D"http://www.w3.org/1999/xhtml" =
class=3D"varname">&body</em> body</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -16839,7 +16841,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id485793">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426191">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">selector</span></i>---either a string which represents the name o=
f the
selector or a list which describes the method's return
@@ -16854,7 +16856,7 @@
symbol)</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id474449">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426237">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Defines an ObjC-=
callable method which implements the
specified message selector for instances of the existing ObjC
@@ -16867,7 +16869,7 @@
<a id=3D"m_define-objc-class-method"></a>
<strong>[Macro]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">define-objc-class-method</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>define-objc-class-method</strong></span>
(selector class-name) <em xmlns=3D"http://www.w3.org/1999/xhtml" =
class=3D"varname">&body</em> body</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -16875,12 +16877,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id502664">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426301">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">As per DEFINE-OB=
JC-METHOD</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id502674">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426312">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Like DEFINE-OBJC=
-METHOD, only used to define methods on the
<span class=3D"emphasis"><em>class</em></span> named by class-nam=
e and on its
@@ -16922,7 +16924,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id471502">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426388">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">This variable is=
currently only used by the standard reader macro
function for #\; (single-line comments); that function reads succ=
essive
@@ -16957,7 +16959,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id501658">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426446">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Per ANSI CL, Clo=
zure CL supports the :EXTERNAL-FORMAT keyword
argument to the functions OPEN, LOAD, and COMPILE-FILE. This argu=
ment is
@@ -17001,7 +17003,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id485472">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426526">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The value of thi=
s variable is used when :EXTERNAL-FORMAT is
unspecified or specified as :DEFAULT. It can meaningfully be give=
n any
@@ -17025,12 +17027,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id477065">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426576">=
</a>
<div class=3D"header">Superclasses:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">NS:NS-STRING</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id494573">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426587">=
</a>
<div class=3D"header">Initargs:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">:string</span></i>---
a Lisp string which is to be the content of
@@ -17038,7 +17040,7 @@
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id485513">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426614">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
This class
@@ -17056,11 +17058,11 @@
</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id458150">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426634">=
</a>
<div class=3D"header">Examples:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
You can create an ns-lisp-string with
- <span><strong class=3D"function">make-instance</strong></span>, j=
ust like
+ <span class=3D"function"><strong>make-instance</strong></span>, j=
ust like
any normal Lisp class:
</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"progr=
amlisting">? (defvar *the-string*
@@ -17073,7 +17075,7 @@
</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"progr=
amlisting">? (ccl::send *the-string* 'dealloc)</pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- You may wish to use an <span><strong class=3D"function">unwind-pr=
otect</strong></span>
+ You may wish to use an <span class=3D"function"><strong>unwind-pr=
otect</strong></span>
form to ensure that this happens:
</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"progr=
amlisting">(let (*the-string*)
@@ -17087,7 +17089,7 @@
</pre>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id449276">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426687">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Currently, ns-lisp-string is defined in
@@ -17429,8 +17431,8 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml">
- <strong class=3D"function">lisp-heap-gc-threshold</stron=
g>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"func=
tion">
+ <strong>lisp-heap-gc-threshold</strong>
</span>
</code>
</div>
@@ -17439,7 +17441,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id476448">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id424183">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns the valu=
e of the kernel variable that specifies the
amount of free space to leave in the heap after full GC.</p>
@@ -17452,7 +17454,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"functio=
n">lisp-heap-gc-threshold new-threshold</strong></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><stro=
ng>lisp-heap-gc-threshold new-threshold</strong></span>
</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -17460,12 +17462,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id437150">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id424243">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">new-value</span></i>---The requested new lisp-heap-gc-threshold.<=
/p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id495213">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id427960">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Sets the value o=
f the kernel variable that specifies the
amount of free space to leave in the heap after full GC to
@@ -17481,7 +17483,7 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml"><strong class=3D"functio=
n">use-lisp-heap-gc-threshold</strong></span>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"function"><stro=
ng>use-lisp-heap-gc-threshold</strong></span>
</code>
</div>
<div class=3D"refentrytitle"></div>
@@ -17489,7 +17491,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id432552">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id428022">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Tries to grow or=
shrink lisp's heap space, so that the
free space is (approximately) equal to the current heap threshold.
@@ -17502,19 +17504,19 @@
<a id=3D"f_egc"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">egc</strong></span> arg</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>egc</strong></span> arg</code>
</div>
<div class=3D"refentrytitle"></div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id482542">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id428081">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">arg</span></i>---a generalized boolean</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id443639">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id428107">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Enables the EGC =
if arg is non-nil, disables the EGC
otherwise. Returns the previous enabled status. Although this
@@ -17530,8 +17532,8 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml">
- <strong class=3D"function">egc-enabled-p</strong>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"func=
tion">
+ <strong>egc-enabled-p</strong>
</span>
</code>
</div>
@@ -17540,7 +17542,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id440822">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id428165">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns T if the=
EGC was enabled at the time of the call,
NIL otherwise.</p>
@@ -17553,8 +17555,8 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml">
- <strong class=3D"function">egc-active-p</strong>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"func=
tion">
+ <strong>egc-active-p</strong>
</span>
</code>
</div>
@@ -17563,7 +17565,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id513501">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id428222">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns T if the=
EGC was active at the time of the call, NIL
otherwise. Since this is generally a volatile piece of
@@ -17578,8 +17580,8 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml">
- <strong class=3D"function">egc-configuration</strong>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"func=
tion">
+ <strong>egc-configuration</strong>
</span>
</code>
</div>
@@ -17588,7 +17590,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id462585">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id428280">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns, as mult=
iple values, the sizes in kilobytes of the
thresholds associated with the youngest ephemeral generation, the
@@ -17601,7 +17603,7 @@
<a id=3D"f_configure-gcc"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">configure-egc</strong></span>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>configure-egc</strong></span>
generation-0-size generation-1-size
generation-2-size</code>
</div>
@@ -17610,7 +17612,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id519891">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426748">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">generation-0-size</span></i>---the requested threshold size of th=
e youngest
generation, in kilobytes</p>
@@ -17620,7 +17622,7 @@
in kilobytes</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id495105">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426803">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If the EGC is cu=
rrently disabled, puts the indicated
threshold sizes in effect and returns T, otherwise, returns NIL.
@@ -17635,19 +17637,19 @@
<a id=3D"f_gc-retain-pages"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">gc-retain-pages</strong></span> arg</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>gc-retain-pages</strong></span> arg</code>
</div>
<div class=3D"refentrytitle"></div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id456402">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426868">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">arg</span></i>---a generalized boolean</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id510638">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426894">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Tries to influen=
ce the GC to retain/recycle the pages
allocated between GCs if arg is true, and to release them
@@ -17662,8 +17664,8 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml">
- <strong class=3D"function">gc-retaining-pages</strong>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"func=
tion">
+ <strong>gc-retaining-pages</strong>
</span>
</code>
</div>
@@ -17672,7 +17674,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id463001">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426951">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns T if the=
GC tries to retain pages between full GCs
and NIL if it's trying to release them to improve VM paging
@@ -17827,7 +17829,7 @@
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id529071">16.7.2. Recommended Reading</a>
+ <a href=3D"#id418917">16.7.2. Recommended Reading</a>
</span>
</dt>
</dl>
@@ -17853,27 +17855,27 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL's threads a=
re "native" (meaning that they're
- scheduled and controlled by the operating system.) Most of the
- implications of this are discussed elsewhere; this section tries
- to describe how threads look from the lisp kernel's perspective
- (and especially from the GC's point of view.)</p>
+ scheduled and controlled by the operating system.) Most of the
+ implications of this are discussed elsewhere; this section tries
+ to describe how threads look from the lisp kernel's perspective
+ (and especially from the GC's point of view.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL's runtime s=
ystem tries to use machine-level
- exception mechanisms (conditional traps when available, illegal
- instructions, memory access protection in some cases) to detect
- and handle ... exceptional situations. These situations
- include some TYPE-ERRORs and PROGRAM-ERRORS (notably
- wrong-number-of-args errors), and also include cases like "not
- being able to allocate memory without GCing or obtaining more
- memory from the OS." The general idea is that it's usually
- faster to pay (very occasional) exception-processing overhead
- and figure out what's going on in an exception handler than it
- is to maintain enough state and context to handle an exceptional
- case via a lighter-weight mechanism when that exceptional case
- (by definition) rarely occurs.</p>
+ exception mechanisms (conditional traps when available,
+ illegal instructions, memory access protection in some cases)
+ to detect and handle exceptional situations. These situations
+ include some TYPE-ERRORs and PROGRAM-ERRORS (notably
+ wrong-number-of-args errors), and also include cases like "not
+ being able to allocate memory without GCing or obtaining more
+ memory from the OS." The general idea is that it's usually
+ faster to pay (very occasional) exception-processing overhead
+ and figure out what's going on in an exception handler than it
+ is to maintain enough state and context to handle an
+ exceptional case via a lighter-weight mechanism when that
+ exceptional case (by definition) rarely occurs.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Some emulated executio=
n environments (the Rosetta PPC
- emulator on x86 versions of Mac OS X) don't provide accurate
- exception information to exception handling functions. Clozure CL
- can't run in such environments.</p>
+ emulator on x86 versions of Mac OS X) don't provide accurate
+ exception information to exception handling functions. Clozure CL
+ can't run in such environments.</p>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
@@ -17883,59 +17885,60 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">When a lisp thread i=
s first created (or when a thread
- created by foreign code first calls back to lisp), a data
- structure called a Thread Context Record (or TCR) is allocated
- and initialized. On modern versions of Linux and FreeBSD, the
- allocation actually happens via a set of thread-local-storage
- ABI extensions, so a thread's TCR is created when the thread
- is created and dies when the thread dies. (The World's Most
- Advanced Operating System - as Apple's marketing literature
- refers to Darwin - is not very advanced in this regard, and I
- know of no reason to assume that advances will be made in this
- area anytime soon.)</p>
+ created by foreign code first calls back to lisp), a data
+ structure called a Thread Context Record (or TCR) is
+ allocated and initialized. On modern versions of Linux and
+ FreeBSD, the allocation actually happens via a set of
+ thread-local-storage ABI extensions, so a thread's TCR is
+ created when the thread is created and dies when the thread
+ dies. (The World's Most Advanced Operating System=C3=A2=C2=80=
=C2=94as
+ Apple's marketing literature refers to Darwin=C3=A2=C2=80=C2=94i=
s not
+ very advanced in this regard, and I know of no reason to
+ assume that advances will be made in this area anytime
+ soon.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A TCR contains a few=
dozen fields (and is therefore a
- few hundred bytes in size.) The fields are mostly
- thread-specific information about the thread's stacks'
- locations and sizes, information about the underlying (POSIX)
- thread, and information about the thread's dynamic binding
- history and pending CATCH/UNWIND-PROTECTs. Some of this
- information could be kept in individual machine registers
- while the thread is running (and the PPC - which has more
- registers available - keeps a few things in registers that the
- X86-64 has to access via the TCR), but it's important to
- remember that the information is thread-specific and can't
- (for instance) be kept in a fixed global memory
- location.</p>
+ few hundred bytes in size.) The fields are mostly
+ thread-specific information about the thread's stacks'
+ locations and sizes, information about the underlying (POSIX)
+ thread, and information about the thread's dynamic binding
+ history and pending CATCH/UNWIND-PROTECTs. Some of this
+ information could be kept in individual machine registers
+ while the thread is running (and the PPC - which has more
+ registers available - keeps a few things in registers that the
+ X86-64 has to access via the TCR), but it's important to
+ remember that the information is thread-specific and can't
+ (for instance) be kept in a fixed global memory
+ location.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">When lisp code is ru=
nning, the current thread's TCR is
- kept in a register. On PPC platforms, a general purpose
- register is used; on x86-64, an (otherwise nearly useless)
- segment register works well (prevents the expenditure of a
- more generally useful general- purpose register for this
- purpose.)</p>
+ kept in a register. On PPC platforms, a general purpose
+ register is used; on x86-64, an (otherwise nearly useless)
+ segment register works well (prevents the expenditure of a
+ more generally useful general- purpose register for this
+ purpose.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The address of a TCR=
is aligned in memory in such a way
- that a FIXNUM can be used to represent it. The lisp function
- CCL::%CURRENT-TCR returns the calling thread's TCR as a
- fixnum; actual value of the TCR's address is 4 or 8 times the
- value of this fixnum.</p>
+ that a FIXNUM can be used to represent it. The lisp function
+ CCL::%CURRENT-TCR returns the calling thread's TCR as a
+ fixnum; actual value of the TCR's address is 4 or 8 times the
+ value of this fixnum.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">When the lisp kernel=
initializes a new TCR, it's added
- to a global list maintained by the kernel; when a thread
- exits, its TCR is removed from this list.</p>
+ to a global list maintained by the kernel; when a thread
+ exits, its TCR is removed from this list.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">When a thread calls =
foreign code, lisp stack pointers
- are saved in its TCR, lisp registers (at least those whose
- value should be preserved across the call) are saved on the
- thread's value stack, and (on x86-64) RSP is switched to the
- control stack. A field in the TCR (tcr.valence) is then set
- to indicate that the thread is running foreign code, foreign
- argument registers are loaded from a frame on the foreign
- stack, and the foreign function is called. (That's a little
- oversimplified and possibly inaccurate, but the important
- things to note are that the thread "stops following lisp stack
- and register usage conventions" and that it advertises the
- fact that it's done so. Similar transitions in a thread's
- state ("valence") occur when it enters of exits an exception
- handler (which is sort of an OS/hardware-mandated foreign
- function call where the OS thoughtfully saves the thread's
- register state for it beforehand.)</p>
+ are saved in its TCR, lisp registers (at least those whose
+ value should be preserved across the call) are saved on the
+ thread's value stack, and (on x86-64) RSP is switched to the
+ control stack. A field in the TCR (tcr.valence) is then set
+ to indicate that the thread is running foreign code, foreign
+ argument registers are loaded from a frame on the foreign
+ stack, and the foreign function is called. (That's a little
+ oversimplified and possibly inaccurate, but the important
+ things to note are that the thread "stops following lisp
+ stack and register usage conventions" and that it advertises
+ the fact that it's done so. Similar transitions in a
+ thread's state ("valence") occur when it enters or exits an
+ exception handler (which is sort of an OS/hardware-mandated
+ foreign function call where the OS thoughtfully saves the
+ thread's register state for it beforehand.)</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -17946,118 +17949,120 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Unix-like OSes tend =
to refer to exceptions as "signals";
- the same general mechanism ("signal handling") is used to
- process both asynchronous OS-level events (such as the result
- of the keyboard driver noticing that ^C or ^Z has been
- pressed) and synchronous hardware-level events (like trying to
- execute an illegal instruction or access protected memory.)
- It makes some sense to defer ("block") handling of
- asynchronous signals so that some critical code sequences
- complete without interruption; since it's generally not
- possible for a thread to proceed after a synchronous exception
- unless and until its state is modified by an exception
- handler, it makes no sense to talk about blocking synchronous
- signals (though some OSes will let you do so and doing so can
- have mysterious effects.)</p>
+ the same general mechanism ("signal handling") is used to
+ process both asynchronous OS-level events (such as the result
+ of the keyboard driver noticing that ^C or ^Z has been
+ pressed) and synchronous hardware-level events (like trying to
+ execute an illegal instruction or access protected memory.)
+ It makes some sense to defer ("block") handling of
+ asynchronous signals so that some critical code sequences
+ complete without interruption; since it's generally not
+ possible for a thread to proceed after a synchronous exception
+ unless and until its state is modified by an exception
+ handler, it makes no sense to talk about blocking synchronous
+ signals (though some OSes will let you do so and doing so can
+ have mysterious effects.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On OSX/Darwin, the P=
OSIX signal handling facilities
- coexist with lower-level Mach-based exception handling
- facilities. Unfortunately, the way that this is implemented
- interacts poorly with debugging tools: GDB will generally stop
- whenever the target program encounters a Mach-level exception
- and offers no way to proceed from that point (and let the
- program's POSIX signal handler try to handle the exception);
- Apple's CrashReporter program has had a similar issue and,
- depending on how it's configured, may bombard the user with
- alert dialogs which falsely claim that an application has
- crashed (when in fact the application in question has
- routinely handled a routine exception.) On Darwin/OSX,
- Clozure CL uses Mach thread-level exception handling facilities
- which run before GDB or CrashReporter get a chance to confuse
- themselves; Clozure CL's Mach exception handling tries to force
- the thread which received a synchronous exception to invoke a
- signal handling function ("as if" signal handling worked more
- usefully under Darwin.) Mach exception handlers run in a
- dedicated thread (which basically does nothing but wait for
- exception messages from the lisp kernel, obtain and modify
- information about the state of threads in which exceptions
- have occurred, and reply to the exception messages with an
- indication that the exception has been handled. The reply
- from a thread-level exception handler keeps the exception from
- being reported to GDB or CrashReporter and avoids the problems
- related to those programs. Since Clozure CL's Mach exception
- handler doesn't claim to handle debugging-related exceptions
- (from breakpoints or single-step operations), it's possible to
- use GDB to debug Clozure CL.</p>
+ coexist with lower-level Mach-based exception handling
+ facilities. Unfortunately, the way that this is implemented
+ interacts poorly with debugging tools: GDB will generally stop
+ whenever the target program encounters a Mach-level exception
+ and offers no way to proceed from that point (and let the
+ program's POSIX signal handler try to handle the exception);
+ Apple's CrashReporter program has had a similar issue and,
+ depending on how it's configured, may bombard the user with
+ alert dialogs which falsely claim that an application has
+ crashed (when in fact the application in question has
+ routinely handled a routine exception.) On Darwin/OSX,
+ Clozure CL uses Mach thread-level exception handling facilities
+ which run before GDB or CrashReporter get a chance to confuse
+ themselves; Clozure CL's Mach exception handling tries to force
+ the thread which received a synchronous exception to invoke a
+ signal handling function ("as if" signal handling worked more
+ usefully under Darwin.) Mach exception handlers run in a
+ dedicated thread (which basically does nothing but wait for
+ exception messages from the lisp kernel, obtain and modify
+ information about the state of threads in which exceptions
+ have occurred, and reply to the exception messages with an
+ indication that the exception has been handled. The reply
+ from a thread-level exception handler keeps the exception from
+ being reported to GDB or CrashReporter and avoids the problems
+ related to those programs. Since Clozure CL's Mach exception
+ handler doesn't claim to handle debugging-related exceptions
+ (from breakpoints or single-step operations), it's possible to
+ use GDB to debug Clozure CL.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On platforms where s=
ignal handling and debugging don't
- get in each other's way, a signal handler is entered with all
- signals blocked. (This behavior is specified in the call to
- the sigaction() function which established the signal
- handler.) The signal handler receives three arguments from
- the OS kernel; the first is an integer which identifies the
- signal, the second is a pointer to an object of type
- "siginfo_t", which may or may not contain a few fields that
- would help to identify the cause of the exception, and the
- third argument is a pointer to a data structure (called a
- "ucontext" or something similar) which contains
- machine-dependent information about the state of the tread at
- the time that the exception/signal occurred. While
- asynchronous signals are blocked, the signal handler stores
- the pointer to its third argument (the "signal context") in a
- field in the current thread's TCR, sets some bits in another
- TCR field to indicate that the thread is now waiting to handle
- an exception, unblocks asynchronous signals, and waits for a
- global exception lock which serializes exception
- processing.</p>
+ get in each other's way, a signal handler is entered with
+ all signals blocked. (This behavior is specified in the
+ call to the sigaction() function which established the
+ signal handler.) The signal handler receives three
+ arguments from the OS kernel; the first is an integer that
+ identifies the signal, the second is a pointer to an object
+ of type "siginfo_t", which may or may not contain a few
+ fields that would help to identify the cause of the
+ exception, and the third argument is a pointer to a data
+ structure (called a "ucontext" or something similar), which
+ contains machine-dependent information about the state of
+ the thread at the time that the exception/signal occurred.
+ While asynchronous signals are blocked, the signal handler
+ stores the pointer to its third argument (the "signal
+ context") in a field in the current thread's TCR, sets some
+ bits in another TCR field to indicate that the thread is now
+ waiting to handle an exception, unblocks asynchronous
+ signals, and waits for a global exception lock that
+ serializes exception processing.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On Darwin, the Mach =
exception thread creates a signal
- context (and maybe a siginfo_t structure), stores the signal
- context in the thread's TCR, sets the TCR field which describes
- the thread's state, and arranges that the thread resume
- execution at its signal handling function (with a signal
- handler, possibly NULL siginfo_t, and signal context as
- arguments. When the thread resumes, it waits for the global
- exception lock.</p>
+ context (and maybe a siginfo_t structure), stores the signal
+ context in the thread's TCR, sets the TCR field which describes
+ the thread's state, and arranges that the thread resume
+ execution at its signal handling function (with a signal
+ handler, possibly NULL siginfo_t, and signal context as
+ arguments. When the thread resumes, it waits for the global
+ exception lock.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On x86-64 platforms =
where signal handing can be used to
- handle synchronous exceptions, there's an additional
- complication: the OS kernel ordinarily allocates the signal
- context and siginfo structures on the stack of the thread
- which received the signal; in practice, that means "wherever
- RSP is pointing." Clozure CL's <a href=3D"#Register-and-stack-usa=
ge-conventions" title=3D"16.2.3.=C3=82=C2=A0Register and stack usage conven=
tions">Section=C3=82=C2=A016.2.3, =C3=A2=C2=80=C2=9CRegister and stack usag=
e conventions=C3=A2=C2=80=C2=9D</a> require that
- the thread's value stack - where RSP is usually pointing while
- lisp code is running - contain only "nodes" (properly tagged
- lisp objects), and scribbling a signal context all over the
- value stack would violate this requirement. To maintain
- consistency, the sigaltstack() mechanism is used to cause the
- signal to be delivered on (and the signal context and siginfo
- to be allocated on) a special stack area (the last few pages
- of the thread's control stack, in practice. When the signal
- handler runs, it (carefully) copies the signal context and
- siginfo to the thread's control stack and makes RSP point into
- that stack before invoking the "real" signal handler. (The
- effect of this hack is that the "real" signal handler always
- runs on the thread's control stack.)</p>
+ handle synchronous exceptions, there's an additional
+ complication: the OS kernel ordinarily allocates the signal
+ context and siginfo structures on the stack of the thread
+ that received the signal; in practice, that means "wherever
+ RSP is pointing." Clozure CL's
+ <a class=3D"xref" href=3D"#Register-and-stack-usage-conventions"=
title=3D"16.2.3.=C3=82=C2=A0Register and stack usage conventions">Section=
=C3=82=C2=A016.2.3, =C3=A2=C2=80=C2=9CRegister and stack usage conventions=
=C3=A2=C2=80=C2=9D</a>
+ require that the thread's value stack=C3=A2=C2=80=C2=94where RSP=
is
+ usually pointing while lisp code is running=C3=A2=C2=80=C2=94con=
tain
+ only "nodes" (properly tagged lisp objects), and scribbling
+ a signal context all over the value stack would violate this
+ requirement. To maintain consistency, the sigaltstack()
+ mechanism is used to cause the signal to be delivered on
+ (and the signal context and siginfo to be allocated on) a
+ special stack area (the last few pages of the thread's
+ control stack, in practice). When the signal handler runs,
+ it (carefully) copies the signal context and siginfo to the
+ thread's control stack and makes RSP point into that stack
+ before invoking the "real" signal handler. The effect of
+ this hack is that the "real" signal handler always runs on
+ the thread's control stack.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Once the exception h=
andler has obtained the global
- exception lock, it uses the values of the signal number,
- siginfo_t, and signal context arguments to determine the
- (logical) cause of the exception. Some exceptions may be
- caused by factors that should generate lisp errors or other
- serious conditions (stack overflow); if this is the case, the
- kernel code may release the global exception lock and call out
- to lisp code. (The lisp code in question may need to repeat
- some of the exception decoding process; in particular, it
- needs to be able to interpret register values in the signal
- context that it receives as an argument.)</p>
+ exception lock, it uses the values of the signal number,
+ siginfo_t, and signal context arguments to determine the
+ (logical) cause of the exception. Some exceptions may be
+ caused by factors that should generate lisp errors or other
+ serious conditions (stack overflow); if this is the case, the
+ kernel code may release the global exception lock and call out
+ to lisp code. (The lisp code in question may need to repeat
+ some of the exception decoding process; in particular, it
+ needs to be able to interpret register values in the signal
+ context that it receives as an argument.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In some cases, the l=
isp kernel exception handler may not
- be able to recover from the exception (this is currently true
- of some types of memory-access fault and is also true of traps
- or illegal instructions that occur during foreign code
- execution. In such cases, the kernel exception handler
- reports the exception as "unhandled", and the kernel debugger
- is invoked.</p>
+ be able to recover from the exception (this is currently true
+ of some types of memory-access fault and is also true of traps
+ or illegal instructions that occur during foreign code
+ execution. In such cases, the kernel exception handler
+ reports the exception as "unhandled", and the kernel debugger
+ is invoked.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If the kernel except=
ion handler identifies the
- exception's cause as being a transient out-of-memory condition
- (indicating that the current thread needs more memory to cons
- in), it tries to make that memory available. In some cases,
- doing so involves invoking the GC.</p>
+ exception's cause as being a transient out-of-memory condition
+ (indicating that the current thread needs more memory to cons
+ in), it tries to make that memory available. In some cases,
+ doing so involves invoking the GC.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -18068,31 +18073,31 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL's GC is n=
ot concurrent: when the GC is invoked in
- response to an exception in a particular thread, all other
- lisp threads must stop until the GC's work is done. The
- thread that triggered the GC iterates over the global TCR
- list, sending each other thread a distinguished "suspend"
- signal, then iterates over the list again, waiting for a
- per-thread semaphore that indicates that the thread has
- received the "suspend" signal and responded appropriately.
- Once all other threads have acknowledged the request to
- suspend themselves, the GC thread can run the GC proper (after
- doing any necessary <a href=3D"#PC-lusering" title=3D"16.1.4.=C3=
=82=C2=A0PC-lusering">Section=C3=82=C2=A016.1.4, =C3=A2=C2=80=C2=9CPC-luser=
ing=C3=A2=C2=80=C2=9D</a>.) Once the
- GC's completed its work, the thread that invoked the GC
- iterates over the global TCR list, raising a per-thread
- "resume" semaphore for each other thread.</p>
+ response to an exception in a particular thread, all other
+ lisp threads must stop until the GC's work is done. The
+ thread that triggered the GC iterates over the global TCR
+ list, sending each other thread a distinguished "suspend"
+ signal, then iterates over the list again, waiting for a
+ per-thread semaphore that indicates that the thread has
+ received the "suspend" signal and responded appropriately.
+ Once all other threads have acknowledged the request to
+ suspend themselves, the GC thread can run the GC proper (after
+ doing any necessary <a class=3D"xref" href=3D"#PC-lusering" titl=
e=3D"16.1.4.=C3=82=C2=A0PC-lusering">Section=C3=82=C2=A016.1.4, =C3=A2=C2=
=80=C2=9CPC-lusering=C3=A2=C2=80=C2=9D</a>.) Once the
+ GC's completed its work, the thread that invoked the GC
+ iterates over the global TCR list, raising a per-thread
+ "resume" semaphore for each other thread.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The signal handler f=
or the asynchronous "suspend" signal
- is entered with all asynchronous signals blocked. It saves
- its signal-context argument in a TCR slot, raises the tcr's
- "suspend" semaphore, then waits on the TCR's "resume"
- semaphore.</p>
+ is entered with all asynchronous signals blocked. It saves
+ its signal-context argument in a TCR slot, raises the tcr's
+ "suspend" semaphore, then waits on the TCR's "resume"
+ semaphore.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The GC thread has ac=
cess to the signal contexts of all
- TCRs (including its own) at the time when the thread received
- an exception or acknowledged a request to suspend itself.
- This information (and information about stack areas in the TCR
- itself) allows the GC to identify the "stack locations and
- register contents" that are elements of the GC's root
- set.</p>
+ TCRs (including its own) at the time when the thread received
+ an exception or acknowledged a request to suspend itself.
+ This information (and information about stack areas in the TCR
+ itself) allows the GC to identify the "stack locations and
+ register contents" that are elements of the GC's root
+ set.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -18103,45 +18108,45 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">It's not quite accur=
ate to say that Clozure CL's compiler
- and runtime follow precise stack and register usage
- conventions at all times; there are a few exceptions:</p>
+ and runtime follow precise stack and register usage
+ conventions at all times; there are a few exceptions:</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"itemizedl=
ist">
<ul type=3D"disc">
<li>
<p>On both PPC and x86-64 platforms, consing isn't
- fully atomic.It takes at least a few instructions to
- allocate an object in memory(and slap a header on it if
- necessary); if a thread is interrupted in the middle of
- that instruction sequence, the new object may or may
- not have been created or fully initialized at the point in
- time that the interrupt occurred. (There are actually a
- few different states of partial initialization)</p>
+ fully atomic.It takes at least a few instructions to
+ allocate an object in memory(and slap a header on it if
+ necessary); if a thread is interrupted in the middle of
+ that instruction sequence, the new object may or may
+ not have been created or fully initialized at the point in
+ time that the interrupt occurred. (There are actually a
+ few different states of partial initialization)</p>
</li>
<li>
<p>On the PPC, the common act of building a lisp
- control stack frame involves allocating a four-word frame
- and storing three register values into that frame. (The
- fourth word - the back pointer to the previous frame - is
- automatically set when the frame is allocated.) The
- previous contents of those three words are unknown (there
- might have been a foreign stack frame at the same address a
- few instructions earlier),so interrupting a thread that's
- in the process of initializing a PPC control stack frame
- isn't GC-safe.</p>
+ control stack frame involves allocating a four-word frame
+ and storing three register values into that frame. (The
+ fourth word - the back pointer to the previous frame - is
+ automatically set when the frame is allocated.) The
+ previous contents of those three words are unknown (there
+ might have been a foreign stack frame at the same address a
+ few instructions earlier),so interrupting a thread that's
+ in the process of initializing a PPC control stack frame
+ isn't GC-safe.</p>
</li>
<li>
<p>There are similar problems with the initialization
- of temp stackframes on the PPC. (Allocation and
- initialization doesn't happen atomically, and the newly
- allocated stack memory may have undefined contents.)</p>
+ of temp stackframes on the PPC. (Allocation and
+ initialization doesn't happen atomically, and the newly
+ allocated stack memory may have undefined contents.)</p>
</li>
<li>
- <p><a href=3D"#The-ephemeral-GC" title=3D"16.5.=C3=82=C2=
=A0The ephemeral GC">Section=C3=82=C2=A016.5, =C3=A2=C2=80=C2=9CThe ephemer=
al GC=C3=A2=C2=80=C2=9D</a>'s write barrier
- has to be implemented atomically (i.e.,both an
- intergenerational store and the update of a
- corresponding reference bit has to happen without
- interruption, or neither of these events can
- happen.)</p>
+ <p><a class=3D"xref" href=3D"#The-ephemeral-GC" title=3D=
"16.5.=C3=82=C2=A0The ephemeral GC">Section=C3=82=C2=A016.5, =C3=A2=C2=80=
=C2=9CThe ephemeral GC=C3=A2=C2=80=C2=9D</a>'s write barrier
+ has to be implemented atomically (i.e.,both an
+ intergenerational store and the update of a
+ corresponding reference bit has to happen without
+ interruption, or neither of these events can
+ happen.)</p>
</li>
<li>
<p>There are a few more similar cases.</p>
@@ -18149,19 +18154,19 @@
</ul>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Fortunately, the num=
ber of these non-atomic instruction
- sequences is small, and fortunately it's fairly easy for the
- interrupting thread to recognize when the interrupted thread
- is in the middle of such a sequence. When this is detected,
- the interrupting thread modifies the state of the interrupted
- thread (modifying its PC and other registers) so that it is no
- longer in the middle of such a sequence (it's either backed
- out of it or the remaining instructions are emulated.)</p>
+ sequences is small, and fortunately it's fairly easy for the
+ interrupting thread to recognize when the interrupted thread
+ is in the middle of such a sequence. When this is detected,
+ the interrupting thread modifies the state of the interrupted
+ thread (modifying its PC and other registers) so that it is no
+ longer in the middle of such a sequence (it's either backed
+ out of it or the remaining instructions are emulated.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">This works because (=
a) many of the troublesome
- instruction sequences are PPC-specific and it's relatively
- easy to partially disassemble the instructions surrounding the
- interrupted thread's PC on the PPC and (b) those instruction
- sequences are heavily stylized and intended to be easily
- recognized.</p>
+ instruction sequences are PPC-specific and it's relatively
+ easy to partially disassemble the instructions surrounding the
+ interrupted thread's PC on the PPC and (b) those instruction
+ sequences are heavily stylized and intended to be easily
+ recognized.</p>
</div>
</div>
<div class=3D"sect1" lang=3D"en" xml:lang=3D"en">
@@ -18181,71 +18186,72 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Regardless of other =
details of its implementation, a
- garbage collector's job is to partition the set of all
- heap-allocated lisp objects (CONSes, STRINGs, INSTANCEs, etc.)
- into two subsets. The first subset contains all objects that
- are transitively referenced from a small set of "root" objects
- (the contents of the stacks and registers of all active
- threads at the time the GC occurs and the values of some
- global variables.) The second subset contains everything
- else: those lisp objects that are not transitively reachable
- from the roots are garbage, and the memory occupied by garbage
- objects can be reclaimed (since the GC has just proven that
- it's impossible to reference them.)</p>
+ garbage collector's job is to partition the set of all
+ heap-allocated lisp objects (CONSes, STRINGs, INSTANCEs, etc.)
+ into two subsets. The first subset contains all objects that
+ are transitively referenced from a small set of "root" objects
+ (the contents of the stacks and registers of all active
+ threads at the time the GC occurs and the values of some
+ global variables.) The second subset contains everything
+ else: those lisp objects that are not transitively reachable
+ from the roots are garbage, and the memory occupied by garbage
+ objects can be reclaimed (since the GC has just proven that
+ it's impossible to reference them.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The set of live, rea=
chable lisp objects basically form
- the nodes of a (usually large) graph, with edges from each
- node A to any other objects (nodes) that object A
- references.</p>
+ the nodes of a (usually large) graph, with edges from each
+ node A to any other objects (nodes) that object A
+ references.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Some nodes in this g=
raph can never have outgoing edges:
- an array with a specialized numeric or character type usually
- represents its elements in some (possibly more compact)
- specialized way. Some nodes may refer to lisp objects that
- are never allocated in memory (FIXNUMs, CHARACTERs,
- SINGLE-FLOATs on 64-bit platforms ..) This latter class of
- objects are sometimes called "immediates", but that's a little
- confusing because the term "immediate" is sometimes used to
- refer to things that can never be part of the big connectivity
- graph (e.g., the "raw" bits that make up a floating-point
- value, foreign address, or numeric value that needs to be used
- - at least fleetingly - in compiled code.)</p>
+ an array with a specialized numeric or character type usually
+ represents its elements in some (possibly more compact)
+ specialized way. Some nodes may refer to lisp objects that
+ are never allocated in memory (FIXNUMs, CHARACTERs,
+ SINGLE-FLOATs on 64-bit platforms ..) This latter class of
+ objects are sometimes called "immediates", but that's a little
+ confusing because the term "immediate" is sometimes used to
+ refer to things that can never be part of the big connectivity
+ graph (e.g., the "raw" bits that make up a floating-point
+ value, foreign address, or numeric value that needs to be used
+ - at least fleetingly - in compiled code.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">For the GC to be abl=
e to build the connectivity graph
- reliably, it's necessary for it to be able to reliably tell
- (a) whether or not a "potential root" - the contents of a
- machine register or stack location - is in fact a node and (b)
- for any node, whether it may have components that refer to
- other nodes.</p>
+ reliably, it's necessary for it to be able to reliably tell
+ (a) whether or not a "potential root" - the contents of a
+ machine register or stack location - is in fact a node and (b)
+ for any node, whether it may have components that refer to
+ other nodes.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">There's no reliable =
way to answer the first question on
- stock hardware. (If everything was a node, as might be the
- case on specially microcoded "lisp machine" hardware, it
- wouldn't even need to be asked.) Since there's no way to just
- look at a machine word (the contents of a machine register or
- stack location) and tell whether or not it's a node or just
- some random non-node value, we have to either adopt and
- enforce strict conventions on register and stack usage or
- tolerate ambiguity.</p>
+ stock hardware. (If everything was a node, as might be the
+ case on specially microcoded "lisp machine" hardware, it
+ wouldn't even need to be asked.) Since there's no way to just
+ look at a machine word (the contents of a machine register or
+ stack location) and tell whether or not it's a node or just
+ some random non-node value, we have to either adopt and
+ enforce strict conventions on register and stack usage or
+ tolerate ambiguity.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">"Tolerating ambiguit=
y" is an approach taken by some
- ("conservative") GC schemes; by contrast, Clozure CL's GC is
- "precise", which in this case means that it believes that the
- contents of certain machine registers and stack locations are
- always nodes and that other registers and stack locations are
- never nodes and that these conventions are never violated by
- the compiler or runtime system. The fact that threads are
- preemptively scheduled means that a GC could occur (because of
- activity in some other thread) on any instruction boundary,
- which in turn means that the compiler and runtime system must
- follow precise <a href=3D"#Register-and-stack-usage-conventions" t=
itle=3D"16.2.3.=C3=82=C2=A0Register and stack usage conventions">Section=C3=
=82=C2=A016.2.3, =C3=A2=C2=80=C2=9CRegister and stack usage conventions=C3=
=A2=C2=80=C2=9D</a> at all
- times.</p>
+ ("conservative") GC schemes; by contrast, Clozure CL's GC is
+ "precise", which in this case means that it believes that the
+ contents of certain machine registers and stack locations are
+ always nodes and that other registers and stack locations are
+ never nodes and that these conventions are never violated by
+ the compiler or runtime system. The fact that threads are
+ preemptively scheduled means that a GC could occur (because of
+ activity in some other thread) on any instruction boundary,
+ which in turn means that the compiler and runtime system must
+ follow precise <a class=3D"xref" href=3D"#Register-and-stack-usa=
ge-conventions" title=3D"16.2.3.=C3=82=C2=A0Register and stack usage conven=
tions">Section=C3=82=C2=A016.2.3, =C3=A2=C2=80=C2=9CRegister and stack usag=
e conventions=C3=A2=C2=80=C2=9D</a> at all
+ times.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Once we've decided t=
hat a given machine word is a node,
- a <a href=3D"#Tagging-scheme" title=3D"16.2.4.=C3=82=C2=A0Tagging =
scheme">Section=C3=82=C2=A016.2.4, =C3=A2=C2=80=C2=9CTagging scheme=C3=A2=
=C2=80=C2=9D</a> describes how the node's
- value and type are encoded in that machine word.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">Most of this - so fa=
r - has discussed things from the
- GC's very low-level perspective. From a much higher point of
- view, lisp functions accept nodes as arguments, return nodes
- as values, and (usually) perform some operations on those
- arguments in order to produce those results. (In many cases,
- the operations in question involve raw non-node values.)
- Higher-level parts of the lisp type system (functions like
- TYPE-OF and CLASS-OF, etc.) depend on the <a href=3D"#Tagging-sche=
me" title=3D"16.2.4.=C3=82=C2=A0Tagging scheme">Section=C3=82=C2=A016.2.4, =
=C3=A2=C2=80=C2=9CTagging scheme=C3=A2=C2=80=C2=9D</a>.</p>
+ a <a class=3D"xref" href=3D"#Tagging-scheme" title=3D"16.2.4.=C3=
=82=C2=A0Tagging scheme">Section=C3=82=C2=A016.2.4, =C3=A2=C2=80=C2=9CTaggi=
ng scheme=C3=A2=C2=80=C2=9D</a> describes how the node's
+ value and type are encoded in that machine word.</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">Most of this discuss=
ion=C3=A2=C2=80=C2=94so far=C3=A2=C2=80=C2=94has treated
+ things from the GC's very low-level perspective. From a much
+ higher point of view, lisp functions accept nodes as
+ arguments, return nodes as values, and (usually) perform
+ some operations on those arguments in order to produce those
+ results. (In many cases, the operations in question involve
+ raw non-node values.) Higher-level parts of the lisp type
+ system (functions like TYPE-OF and CLASS-OF, etc.) depend on
+ the <a class=3D"xref" href=3D"#Tagging-scheme" title=3D"16.2.4.=
=C3=82=C2=A0Tagging scheme">Section=C3=82=C2=A016.2.4, =C3=A2=C2=80=C2=9CTa=
gging scheme=C3=A2=C2=80=C2=9D</a>.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -18256,53 +18262,54 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On the PPC, there's =
a third case (besides "node" and
- "immediate" values). As discussed below, a node that denotes
- a memory-allocated lisp object is a biased (tagged) pointer
- -to- that object; it's not generally possible to point -into-
- some composite (multi-element) object (such a pointer would
- not be a node, and the GC would have no way to update the
- pointer if it were to move the underlying object.)</p>
+ "immediate" values). As discussed below, a node that denotes
+ a memory-allocated lisp object is a biased (tagged) pointer
+ -to- that object; it's not generally possible to point -into-
+ some composite (multi-element) object (such a pointer would
+ not be a node, and the GC would have no way to update the
+ pointer if it were to move the underlying object.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Such a pointer ("int=
o" the interior of a heap-allocated
- object) is often called a <span class=3D"emphasis"><em>locative</e=
m></span>; the
- cases where locatives are allowed in Clozure CL mostly involve
- the behavior of function call and return instructions. (To be
- technically accurate, the other case also arises on x86-64, but
- that case isn't as user-visible.)</p>
+ object) is often called a <span class=3D"emphasis"><em>locative<=
/em></span>; the
+ cases where locatives are allowed in Clozure CL mostly involve
+ the behavior of function call and return instructions. (To be
+ technically accurate, the other case also arises on x86-64, but
+ that case isn't as user-visible.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On the PowerPC (both=
PPC32 and PPC64), all machine
- instructions are 32 bits wide and all instruction words are
- allocated on 32-bit boundaries. In PPC Clozure CL, a CODE-VECTOR
- is a specialized type of vector-like object; its elements are
- 32-bit PPC machine instructions. A CODE-VECTOR is an
- attribute of FUNCTION object; a function call involves
- accessing the function's code-vector and jumping to the
- address of its first instruction.</p>
+ instructions are 32 bits wide and all instruction words are
+ allocated on 32-bit boundaries. In PPC Clozure CL, a CODE-VECTOR
+ is a specialized type of vector-like object; its elements
+ are 32-bit PPC machine instructions. A CODE-VECTOR is an
+ attribute of a FUNCTION object; a function call involves
+ accessing the function's code-vector and jumping to the
+ address of its first instruction.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">As each instruction =
in the code vector sequentially
- executes, the hardware program counter (PC) register advances
- to the address of the next instruction (a locative into the
- code vector); since PPC instructions are always 32 bits wide
- and aligned on 32-bit boundaries, the low two bits of the PC
- are always 0. If the function executes a call (simple call
- instructions have the mnemonic "bl" on the PPC, which stands
- for "branch and link"), the address of the next instruction
- (also a word-aligned locative into a code-vector) is copied
- into the special- purpose PPC "link register" (lr); a function
- returns to its caller via a "branch to link register" (blr)
- instruction. Some cases of function call and return might
- also use the PPC's "count register" (ctr), and if either the
- lr or ctr needs to be stored in memory it needs to first be
- copied to a general-purpose register.</p>
+ executes, the hardware program counter (PC) register advances
+ to the address of the next instruction (a locative into the
+ code vector); since PPC instructions are always 32 bits wide
+ and aligned on 32-bit boundaries, the low two bits of the PC
+ are always 0. If the function executes a call (simple call
+ instructions have the mnemonic "bl" on the PPC, which stands
+ for "branch and link"), the address of the next instruction
+ (also a word-aligned locative into a code-vector) is copied
+ into the special- purpose PPC "link register" (lr); a function
+ returns to its caller via a "branch to link register" (blr)
+ instruction. Some cases of function call and return might
+ also use the PPC's "count register" (ctr), and if either the
+ lr or ctr needs to be stored in memory it needs to first be
+ copied to a general-purpose register.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL's GC unde=
rstands that certain registers contain
- these special "pc-locatives" (locatives that point into
- CODE-VECTOR objects); it contains special support for finding
- the containing CODE-VECTOR object and for adjusting all of
- these "pc-locatives" if the containing object is moved in
- memory. The first part of that - finding the containing
- object - is possible and practical on the PPC because of
- architectural artifacts (fixed-width instructions and arcana
- of instruction encoding.) It's not possible on x86-64, but
- fortunately not necessary either (though the second part -
- adjusting the PC/RIP when the containing object moves) is both
- necessary and simple.</p>
+ these special "pc-locatives" (locatives that point into
+ CODE-VECTOR objects); it contains special support for
+ finding the containing CODE-VECTOR object and for adjusting
+ all of these "pc-locatives" if the containing object is
+ moved in memory. The first part of that
+ operation=C3=A2=C2=80=C2=94finding the containing object=C3=A2=
=C2=80=C2=94is
+ possible and practical on the PPC because of architectural
+ artifacts (fixed-width instructions and arcana of
+ instruction encoding.) It's not possible on x86-64, but
+ fortunately not necessary either (though the second part -
+ adjusting the PC/RIP when the containing object moves) is
+ both necessary and simple.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -18321,99 +18328,100 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On both PPC and X8=
6 platforms, each lisp thread uses 3
- stacks; the ways in which these stacks are used differs
- between the PPC and X86.</p>
+ stacks; the ways in which these stacks are used differs
+ between the PPC and X86.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Each thread has:</=
p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"itemize=
dlist">
<ul type=3D"disc">
<li>
<p>A "control stack". On both platforms, this is
- "the stack" used by foreign code. On the PPC, it
- consists of a linked list of frames where the first word
- in each frame points to the first word in the previous
- frame (and the outermost frame points to 0.) Some
- frames on a PPC control stack are lisp frames; lisp
- frames are always 4 words in size and contain (in
- addition to the back pointer to the previous frame) the
- calling function (a node), the return address (a
- "locative" into the calling function's code-vector), and
- the value to which the value-stack pointer (see below)
- should be restored on function exit. On the PPC, the GC
- has to look at control-stack frames, identify which of
- those frames are lisp frames, and treat the contents of
- the saved function slot as a node (and handle the return
- address locative specially.) On x86-64, the control
- stack is used for dynamic-extent allocation of immediate
- objects. Since the control stack never contains nodes
- on x86-64, the GC ignores it on that platform.
- Alignment of the control stack follows the ABI
- conventions of the platform (at least at any point in
- time where foreign code could run.) On PPC, the r1
- register always points to the top of the current
- thread's control stack; on x86-64, the RSP register
- points to the top of the current thread's control stack
- when the thread is running foreign code and the address
- of the top of the control stack is kept in the thread's
- TCR (see <a href=3D"#The-Thread-Context-Record" title=3D"16.1.1.=C3=
=82=C2=A0The Thread Context Record">Section=C3=82=C2=A016.1.1, =C3=A2=C2=80=
=C2=9CThe Thread Context Record=C3=A2=C2=80=C2=9D</a>
- when not running foreign code. The control stack "grows
- down."</p>
+ "the stack" used by foreign code. On the PPC, it
+ consists of a linked list of frames where the first word
+ in each frame points to the first word in the previous
+ frame (and the outermost frame points to 0.) Some
+ frames on a PPC control stack are lisp frames; lisp
+ frames are always 4 words in size and contain (in
+ addition to the back pointer to the previous frame) the
+ calling function (a node), the return address (a
+ "locative" into the calling function's code-vector), and
+ the value to which the value-stack pointer (see below)
+ should be restored on function exit. On the PPC, the GC
+ has to look at control-stack frames, identify which of
+ those frames are lisp frames, and treat the contents of
+ the saved function slot as a node (and handle the return
+ address locative specially.) On x86-64, the control
+ stack is used for dynamic-extent allocation of immediate
+ objects. Since the control stack never contains nodes
+ on x86-64, the GC ignores it on that platform.
+ Alignment of the control stack follows the ABI
+ conventions of the platform (at least at any point in
+ time where foreign code could run.) On PPC, the r1
+ register always points to the top of the current
+ thread's control stack; on x86-64, the RSP register
+ points to the top of the current thread's control stack
+ when the thread is running foreign code and the address
+ of the top of the control stack is kept in the thread's
+ TCR (see <a class=3D"xref" href=3D"#The-Thread-Context-Record=
" title=3D"16.1.1.=C3=82=C2=A0The Thread Context Record">Section=C3=82=C2=
=A016.1.1, =C3=A2=C2=80=C2=9CThe Thread Context Record=C3=A2=C2=80=C2=9D</a>
+ when not running foreign code. The control stack "grows
+ down."</p>
</li>
<li>
<p>A "value stack". On both platforms, all values on
- the value stack are nodes (including "tagged return
- addresses" on x86-64.) The value stack is always
- aligned to the native word size; objects are always
- pushed on the value stack using atomic instructions
- ("stwu"/"stdu" on PPC, "push" on x86-64), so the
- contents of the value stack between its bottom and top
- are always unambiguously nodes; the compiler usually
- tries to pop or discard nodes from the value stack as
- soon as possible after their last use (as soon as they
- may have become garbage.) On x86-64, the RSP register
- addresses the top of the value stack when running lisp
- code; that address is saved in the TCR when running
- foreign code. On the PPC, a dedicated register (VSP,
- currently r15) is used to address the top of the value
- stack when running lisp code, and the VSP value is saved
- in the TCR when running foreign code. The value stack
- grows down.</p>
+ the value stack are nodes (including "tagged return
+ addresses" on x86-64.) The value stack is always
+ aligned to the native word size; objects are always
+ pushed on the value stack using atomic instructions
+ ("stwu"/"stdu" on PPC, "push" on x86-64), so the
+ contents of the value stack between its bottom and top
+ are always unambiguously nodes; the compiler usually
+ tries to pop or discard nodes from the value stack as
+ soon as possible after their last use (as soon as they
+ may have become garbage.) On x86-64, the RSP register
+ addresses the top of the value stack when running lisp
+ code; that address is saved in the TCR when running
+ foreign code. On the PPC, a dedicated register (VSP,
+ currently r15) is used to address the top of the value
+ stack when running lisp code, and the VSP value is saved
+ in the TCR when running foreign code. The value stack
+ grows down.</p>
</li>
<li>
<p>A "temp stack". The temp stack consists of a
- linked list of frames, each of which points to the
- previous temp stack frame. The number of native machine
- words in each temp stack frame is always even, so the
- temp stack is aligned on a two-word (64- or 128-bit)
- boundary. The temp stack is used for dynamic-extent
- objects on both platforms; on the PPC, it's used for
- essentially all such objects (regardless of whether or
- not the objects contain nodes); on the x86-64, immediate
- dynamic-extent objects (strings, foreign pointers, etc.)
- are allocated on the control stack and only
- node-containing dynamic-extent objects are allocated on
- the temp stack. Data structures used to implement CATCH
- and UNWIND-PROTECT are stored on the temp stack on both
- ppc and x86-64. Temp stack frames are always doublenode
- aligned and objects within a temp stack frame are
- aligned on doublenode boundaries. The first word in
- each frame contains a back pointer to the previous
- frame; on the PPC, the second word is used to indicate
- to the GC whether the remaining objects are nodes (if
- the second word is 0) or immediate (otherwise.) On
- x86-64, where temp stack frames always contain nodes,
- the second word is always 0. The temp stack grows down.
- It usually takes several instructions to allocate and
- safely initialize a temp stack frame that's intended to
- contain nodes, and the GC has to recognize the case
- where a thread is in the process of allocating and
- initializing a temp stack frame and take care not to
- interpret any uninitialized words in the frame as nodes.
- See (someplace). The PPC keeps the current top of the
- temp stack in a dedicated register (TSP, currently r12)
- when running lisp code and saves this register's value
- in the TCR when running foreign code. The x86-64 keeps
- the address of the top of each thread's temp stack in
- the thread's TCR.</p>
+ linked list of frames, each of which points to the
+ previous temp stack frame. The number of native
+ machine words in each temp stack frame is always even,
+ so the temp stack is aligned on a two-word (64- or
+ 128-bit) boundary. The temp stack is used for
+ dynamic-extent objects on both platforms; on the PPC,
+ it's used for essentially all such objects (regardless
+ of whether or not the objects contain nodes); on the
+ x86-64, immediate dynamic-extent objects (strings,
+ foreign pointers, etc.) are allocated on the control
+ stack and only node-containing dynamic-extent objects
+ are allocated on the temp stack. Data structures used
+ to implement CATCH and UNWIND-PROTECT are stored on
+ the temp stack on both ppc and x86-64. Temp stack
+ frames are always doublenode aligned and objects
+ within a temp stack frame are aligned on doublenode
+ boundaries. The first word in each frame contains a
+ back pointer to the previous frame; on the PPC, the
+ second word is used to indicate to the GC whether the
+ remaining objects are nodes (if the second word is 0)
+ or immediate (otherwise.) On x86-64, where temp stack
+ frames always contain nodes, the second word is always
+ 0. The temp stack grows down. It usually takes
+ several instructions to allocate and safely initialize
+ a temp stack frame that's intended to contain nodes,
+ and the GC has to recognize the case where a thread is
+ in the process of allocating and initializing a temp
+ stack frame and take care not to interpret any
+ uninitialized words in the frame as nodes. The PPC
+ keeps the current top of the temp stack in a dedicated
+ register (TSP, currently r12) when running lisp code
+ and saves this register's value in the TCR when
+ running foreign code. The x86-64 keeps the address of
+ the top of each thread's temp stack in the thread's
+ TCR.</p>
</li>
</ul>
</div>
@@ -18427,139 +18435,139 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If there are a "re=
asonable" (for some value of
- "reasonable") number or general-purpose registers and the
- instruction set is "reasonably" orthogonal (most
- instructions that operate on GPRs can operate on any GPR),
- then it's possible to statically partition the GPRs into at
- least two sets: "immediate registers" never contain nodes,
- and "node registers" always contain nodes. (On the PPC, a
- few registers are members of a third set of "PC locatives",
- and on both platforms some registers may have dedicated
- roles as stack or heap pointers; the latter class is treated
- as immediates by the GC proper but may be used to help
- determine the bounds of stack and heap memory areas.)</p>
+ "reasonable") number of general-purpose registers and the
+ instruction set is "reasonably" orthogonal (most
+ instructions that operate on GPRs can operate on any GPR),
+ then it's possible to statically partition the GPRs into at
+ least two sets: "immediate registers" never contain nodes,
+ and "node registers" always contain nodes. (On the PPC, a
+ few registers are members of a third set of "PC locatives",
+ and on both platforms some registers may have dedicated
+ roles as stack or heap pointers; the latter class is treated
+ as immediates by the GC proper but may be used to help
+ determine the bounds of stack and heap memory areas.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The ultimate defin=
ition of register partitioning is
- hardwired into the GC in functions like "mark_xp()" and
- "forward_xp()", which process the values of some of the
- registers in an exception frame as nodes and may give some
- sort of special treatment to other register values they
- encounter there.)</p>
+ hardwired into the GC in functions like "mark_xp()" and
+ "forward_xp()", which process the values of some of the
+ registers in an exception frame as nodes and may give some
+ sort of special treatment to other register values they
+ encounter there.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On x86-64, the sta=
tic register partitioning scheme involves:</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"itemize=
dlist">
<ul type=3D"disc">
<li>
<p>(only) three "immediate" registers.</p>
<p>The RAX, RCX, and RDX registers are used as the
- implicit operands and results of some extended-precision
- multiply and divide instructions which generally involve
- non-node values; since their use in these instructions
- means that they can't be guaranteed to contain node
- values at all times, it's natural to put these registers
- in the "immediate" set. RAX is generally given the
- symbolic name "imm0", RDX is given the symbolic name
- "imm1" and RCX is given the symbolic name "imm2"; you
- may see these names in disassembled code, usually in
- operations involving type checking, array indexing, and
- foreign memory and function access.</p>
+ implicit operands and results of some extended-precision
+ multiply and divide instructions which generally involve
+ non-node values; since their use in these instructions
+ means that they can't be guaranteed to contain node
+ values at all times, it's natural to put these registers
+ in the "immediate" set. RAX is generally given the
+ symbolic name "imm0", RDX is given the symbolic name
+ "imm1" and RCX is given the symbolic name "imm2"; you
+ may see these names in disassembled code, usually in
+ operations involving type checking, array indexing, and
+ foreign memory and function access.</p>
</li>
<li>
<p>(only) two "dedicated" registers.</p>
<p>RSP and RBP have
- dedicated functionality dictated by the hardware and
- calling conventions.</p>
+ dedicated functionality dictated by the hardware and
+ calling conventions.</p>
</li>
<li>
<p>11 "node" registers.</p>
<p>All other registers (RBX, RSI, RDI, and R8-R15)
- are asserted to contain node values at (almost) all
- times; legacy "string" operations that implicitly use RSI
- and/or RDI are not used.</p>
+ are asserted to contain node values at (almost) all
+ times; legacy "string" operations that implicitly use RSI
+ and/or RDI are not used.</p>
</li>
</ul>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On the PPC, the st=
atic register partitioning scheme
- involves:</p>
+ involves:</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"itemize=
dlist">
<ul type=3D"disc">
<li>
<p>6 "immediate" registers.</p>
<p>Registers r3-r8 are given
- the symbolic names imm0-imm5. As a RISC architecture
- with simpler addressing modes, the PPC probably
- uses immediate registers a bit more often than the CISC
- x86-64 does, but they're generally used for the same sort
- of things (type checking, array indexing, FFI,
- etc.)</p>
+ the symbolic names imm0-imm5. As a RISC architecture
+ with simpler addressing modes, the PPC probably
+ uses immediate registers a bit more often than the CISC
+ x86-64 does, but they're generally used for the same sort
+ of things (type checking, array indexing, FFI,
+ etc.)</p>
</li>
<li>
<p>9 dedicated registers
- </p>
+ </p>
<div class=3D"itemizedlist">
<ul type=3D"circle">
<li>
<p>r0 (symbolic name rzero) always contains the
- value 0 when running lisp code. Its value is
- sometimes read as 0 when it's used as the base
- register in a memory address; keeping the value 0
- there is sometimes convenient and avoids
- asymmetry.</p>
+ value 0 when running lisp code. Its value is
+ sometimes read as 0 when it's used as the base
+ register in a memory address; keeping the value 0
+ there is sometimes convenient and avoids
+ asymmetry.</p>
</li>
<li>
<p>r1 (symbolic name sp) is the control stack
- pointer, by PPC convention.</p>
+ pointer, by PPC convention.</p>
</li>
<li>
<p>r2 is used to hold the current thread's TCR on
- ppc64 systems; it's not used on ppc32.</p>
+ ppc64 systems; it's not used on ppc32.</p>
</li>
<li>
<p>r9 and r10 (symbolic names allocptr and
- allocbase) are used to do per-thread memory
- allocation</p>
+ allocbase) are used to do per-thread memory
+ allocation</p>
</li>
<li>
<p>r11 (symbolic name nargs) contains the number
- of function arguments on entry and the number of
- return values in multiple-value returning
- constructs. It's not used more generally as either
- a node or immediate register because of the way that
- certain trap instruction encodings are
- interpreted.</p>
+ of function arguments on entry and the number of
+ return values in multiple-value returning
+ constructs. It's not used more generally as either
+ a node or immediate register because of the way that
+ certain trap instruction encodings are
+ interpreted.</p>
</li>
<li>
<p>r12 (symbolic name tsp) holds the top of the
- current thread's temp stack.</p>
+ current thread's temp stack.</p>
</li>
<li>
<p>r13 is used to hold the TCR on PPC32 systems;
- it's not used on PPC64.</p>
+ it's not used on PPC64.</p>
</li>
<li>
<p>r14 (symbolic name loc-pc) is used to copy
- "pc-locative" values between main memory and
- special-purpose PPC registers (LR and CTR) used in
- function-call and return instructions.</p>
+ "pc-locative" values between main memory and
+ special-purpose PPC registers (LR and CTR) used in
+ function-call and return instructions.</p>
</li>
<li>
<p>r15 (symbolic name vsp) addresses the top of
- the current thread's value stack.</p>
+ the current thread's value stack.</p>
</li>
<li>
<p>lr and ctr are PPC branch-unit registers used
- in function call and return instructions; they're
- always treated as "pc-locatives", which precludes
- the use of the ctr in some PPC looping
- constructs.</p>
+ in function call and return instructions; they're
+ always treated as "pc-locatives", which precludes
+ the use of the ctr in some PPC looping
+ constructs.</p>
</li>
</ul>
</div>
<p>
- </p>
+ </p>
</li>
<li>
<p>17 "node" registers</p>
<p>r15-r31 are always treated as node
- registers</p>
+ registers</p>
</li>
</ul>
</div>
@@ -18574,180 +18582,187 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL always al=
locates lisp objects on double-node
- (64-bit for 32-bit platforms, 128-bit for 64-bit platforms)
- boundaries; this mean that the low 3 bits (32-bit lisp) or 4
- bits (64-bit lisp) are always 0 and are therefore redundant
- (we only really need to know the upper 29 or 60 bits in order
- to identify the aligned object address.) The extra bits in a
- lisp node can be used to encode at least some information
- about the node's type, and the other 29/60 bits represent
- either an immediate value or a doublenode-aligned memory
- address. The low 3 or 4 bits of a node are called the node's
- "tag bits", and the conventions used to encode type
- information in those tag bits are called a "tagging
- scheme."</p>
+ (64-bit for 32-bit platforms, 128-bit for 64-bit platforms)
+ boundaries; this mean that the low 3 bits (32-bit lisp) or 4
+ bits (64-bit lisp) are always 0 and are therefore redundant
+ (we only really need to know the upper 29 or 60 bits in order
+ to identify the aligned object address.) The extra bits in a
+ lisp node can be used to encode at least some information
+ about the node's type, and the other 29/60 bits represent
+ either an immediate value or a doublenode-aligned memory
+ address. The low 3 or 4 bits of a node are called the node's
+ "tag bits", and the conventions used to encode type
+ information in those tag bits are called a "tagging
+ scheme."</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">It might be possible=
to use the same tagging scheme on
- all platforms (at least on all platforms with the same word
- size and/or the same number of available tag bits), but there
- are often some strong reasons for not doing so. These
- arguments tend to be very machine-specific: sometimes, there
- are fairly obvious machine-dependent tricks that can be
- exploited to make common operations on some types of tagged
- objects faster; other times, there are architectural
- restrictions that make it impractical to use certain tags for
- certain types. (On PPC64, the "ld" (load doubleword) and
- "std" (store doubleword) instructions - which load and store a
- GPR operand at the effective address formed by adding the
- value of another GPR operand and a 16-bit constant operand -
- require that the low two bits of that constant operand be 0.
- Since such instructions would typically be used to access the
- fields of things like CONS cells and structures, it's
- desirable that that the tags chosen for CONS cells and
- structures allow the use of these instructions as opposed to
- more expensive alternatives.)</p>
+ all platforms (at least on all platforms with the same word
+ size and/or the same number of available tag bits), but there
+ are often some strong reasons for not doing so. These
+ arguments tend to be very machine-specific: sometimes, there
+ are fairly obvious machine-dependent tricks that can be
+ exploited to make common operations on some types of tagged
+ objects faster; other times, there are architectural
+ restrictions that make it impractical to use certain tags for
+ certain types. (On PPC64, the "ld" (load doubleword) and
+ "std" (store doubleword) instructions - which load and store a
+ GPR operand at the effective address formed by adding the
+ value of another GPR operand and a 16-bit constant operand -
+ require that the low two bits of that constant operand be 0.
+ Since such instructions would typically be used to access the
+ fields of things like CONS cells and structures, it's
+ desirable that that the tags chosen for CONS cells and
+ structures allow the use of these instructions as opposed to
+ more expensive alternatives.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">One architecture-dep=
endent tagging trick that works well
- on all architectures is to use a tag of 0 for FIXNUMs: a
- fixnum basically encodes its value shifted left a few bits and
- keeps those low bits clear. FIXNUM addition, subtraction, and
- binary logical operations can operate directly on the node
- operands, addition and subtraction can exploit hardware-based
- overflow detection, and (in the absence of overflow) the
- hardware result of those operations is a node (fixnum). Some
- other slightly-less-common operations may require a few extra
- instructions, but arithmetic operations on FIXNUMs should be
- as cheap as possible and using a tag of zero for FIXNUMs helps
- to ensure that it will be.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">If we have N availab=
le tag bits (N =3D 3 for 32-bit
- Clozure CL and N =3D 4 for 64-bit Clozure CL), this way of
- representing fixnums with the low M bits forced to 0 works as
- long as M <=3D N. The smaller we make M, the larger the
- values of MOST-POSITIVE-FIXNUM and MOST-NEGATIVE become; the
- larger we make N, the more distinct non-FIXNUM tags become
- available. A reasonable compromise is to choose M =3D N-1; this
- basically yields two distinct FIXNUM tags (one for even
- fixnums, one for odd fixnums), gives 30-bit fixnums on 32-bit
- platforms and 61-bit fixnums on 64-bit platforms, and leaves
- us with 6 or 14 tags to encoded other types.</p>
+ on all architectures is to use a tag of 0 for FIXNUMs: a
+ fixnum basically encodes its value shifted left a few bits
+ and keeps those low bits clear. FIXNUM addition,
+ subtraction, and binary logical operations can operate
+ directly on the node operands, addition and subtraction can
+ exploit hardware-based overflow detection, and (in the
+ absence of overflow) the hardware result of those operations
+ is a node (fixnum). Some other slightly-less-common
+ operations may require a few extra instructions, but
+ arithmetic operations on FIXNUMs should be as cheap as
+ possible and using a tag of zero for FIXNUMs helps to ensure
+ that it will be.</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">If we have N availab=
le tag bits (N =3D 3 for 32-bit Clozure CL
+ and N =3D 4 for 64-bit Clozure CL), this way of representing
+ fixnums with the low M bits forced to 0 works as long as M
+ <=3D N. The smaller we make M, the larger the values of
+ MOST-POSITIVE-FIXNUM and MOST-NEGATIVE become; the larger we
+ make N, the more distinct non-FIXNUM tags become available.
+ A reasonable compromise is to choose M =3D N-1; this basically
+ yields two distinct FIXNUM tags (one for even fixnums, one
+ for odd fixnums), gives 30-bit fixnums on 32-bit platforms
+ and 61-bit fixnums on 64-bit platforms, and leaves us with 6
+ or 14 tags to encoded other types.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Once we get past the=
assignment of FIXNUM tags, things
- quickly devolve into machine-dependencies. We can fairly
- easily see that we can't directly all other primitive lisp
- object types with only 6 or 14 available tag values; the
- details of how types are encoded vary between the ppc32,
- ppc64, and x86-64 implementations, but there are some general
- common principles:</p>
+ quickly devolve into machine-dependencies. We can fairly
+ easily see that we can't directly tag all other primitive
+ lisp object types with only 6 or 14 available tag values;
+ the details of how types are encoded vary between the ppc32,
+ ppc64, and x86-64 implementations, but there are some
+ general common principles:</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"itemizedl=
ist">
<ul type=3D"disc">
<li>
<p>CONS cells always contain exactly 2 elements and are
- usually fairly common.It therefore makes sense to give
- CONS cells their own tag. Unlike the fixnum case - where a
- tag value of 0 had positive implications - there doesn't
- seem to be any advantage to using any particular value.
- (A longtime ago - in the case of 68K MCL - the CONS tag
- and the order of CAR and CDR in memory were chosen to allow
- smaller, cheaper addressing modes to be used to "cdr down a
- list." That's not a factor on ppc or x86-64,but all
- versions of Clozure CL still store the CDR of a CONS cell
- first in memory. It doesn't matter, but doing it the way
- that the host system did made boostrapping to a new target
- system a little easier.)
- </p>
+ usually fairly common.It therefore makes sense to give
+ CONS cells their own tag. Unlike the fixnum case -
+ where a tag value of 0 had positive implications - there
+ doesn't seem to be any advantage to using any particular
+ value. (A longtime ago - in the case of 68K MCL - the
+ CONS tag and the order of CAR and CDR in memory were
+ chosen to allow smaller, cheaper addressing modes to be
+ used to "cdr down a list." That's not a factor on ppc
+ or x86-64, but all versions of Clozure CL still store the CDR
+ of a CONS cell first in memory. It doesn't matter, but
+ doing it the way that the host system did made
+ boostrapping to a new target system a little easier.)
+ </p>
</li>
<li>
- <p>Any way you look at it, NIL is a bit ... unusual. NIL
- is both a SYMBOL and a LIST (as well as being a canonical
- truth value and probably a few other things.) Its role as
- a LIST is probably much more important to most programs
- than its role as a SYMBOL is:LISTP has to be true of NIL
- and primitives like CAR and CDR do LISTP implicitly when
- safe and want that operation to be fast.There are several
- possible approaches to this; Clozure CL uses two of them. On
- PPC32 and X86-64, NIL is basically a weird CONS cell that
- straddles two doublenodes; the tag of NIL is unique and
- congruent modulo 4 (modulo 8 on 64-bit) with the tag used
- for CONS cells. LISTP is therefore true of any node whose
- low 2 (or 3) bits contain the appropriate tag value (it's
- not otherwise necessary to special-case NIL.)
- SYMBOL accessors (SYMBOL-NAME, SYMBOL-VALUE, SYMBOL-PLIST
- ..) -do- have to special-case NIL (and access the
- components of an internal proxy symbol.) On PPC64 (where
- architectural restrictions dictate the set of tags that can
- be used to access fixed components of an object),
- that approach wasn't practical. NIL is just a
- distinguished SYMBOL,and it just happens to be the case
- that its pname slot and values lots are at the same offsets
- from a tagged pointer as a CONS cell's CDR and CAR would be.
- NIL's pname is set to NIL (SYMBOL-NAME checks for this and
- returns the string "NIL"), and LISTP (and therefore safe
- CAR and CDR) have to check for (OR NULL CONSP). At least in
- the case of CAR and CDR, the fact that the PPC has multiple
- condition-code fields keeps that extra test from
- being prohibitively expensive.</p>
+ <p>Any way you look at it, NIL is a bit
+ ... unusual. NIL is both a SYMBOL and a LIST (as well as
+ being a canonical truth value and probably a few other
+ things.) Its role as a LIST is probably much more
+ important to most programs than its role as a SYMBOL is:
+ LISTP has to be true of NIL and primitives like CAR and
+ CDR do LISTP implicitly when safe and want that
+ operation to be fast. There are several possible
+ approaches to this problem; Clozure CL uses two of them. On
+ PPC32 and X86-64, NIL is basically a weird CONS cell
+ that straddles two doublenodes; the tag of NIL is unique
+ and congruent modulo 4 (modulo 8 on 64-bit) with the tag
+ used for CONS cells. LISTP is therefore true of any
+ node whose low 2 (or 3) bits contain the appropriate tag
+ value (it's not otherwise necessary to special-case
+ NIL.) SYMBOL accessors (SYMBOL-NAME, SYMBOL-VALUE,
+ SYMBOL-PLIST ..) -do- have to special-case NIL (and
+ access the components of an internal proxy symbol.) On
+ PPC64 (where architectural restrictions dictate the set
+ of tags that can be used to access fixed components of
+ an object), that approach wasn't practical. NIL is just
+ a distinguished SYMBOL,and it just happens to be the
+ case that its pname slot and values slot are at the same
+ offsets from a tagged pointer as a CONS cell's CDR and
+ CAR would be. NIL's pname is set to NIL (SYMBOL-NAME
+ checks for this and returns the string "NIL"), and LISTP
+ (and therefore safe CAR and CDR) has to check for (OR
+ NULL CONSP). At least in the case of CAR and CDR, the
+ fact that the PPC has multiple condition-code fields
+ keeps that extra test from being prohibitively
+ expensive.</p>
</li>
<li>
- <p>Some objects are immediate (but not FIXNUMs).This is
- true of CHARACTERs and, on 64-bit platforms,
- SINGLE-FLOATs.It's also true of some nodes used in the
- runtime system (special values used to indicate unbound
- variables and slots, for instance.) On 64-bit platforms,
- SINGLE-FLOATs have their own unique tag (making them a
- little easier to recognize; on all platforms, CHARACTERs
- share a tag with other immediate objects (unbound markers)
- but are easy to recognize (by looking at several of their
- low bits.) The GC treats any node with an immediate tag
- (and any node with a fixnum tag) as a leaf.</p>
+ <p>Some objects are immediate (but not FIXNUMs). This
+ is true of CHARACTERs and, on 64-bit platforms,
+ SINGLE-FLOATs. It's also true of some nodes used in the
+ runtime system (special values used to indicate unbound
+ variables and slots, for instance.) On 64-bit platforms,
+ SINGLE-FLOATs have their own unique tag (making them a
+ little easier to recognize; on all platforms, CHARACTERs
+ share a tag with other immediate objects (unbound
+ markers) but are easy to recognize (by looking at
+ several of their low bits.) The GC treats any node with
+ an immediate tag (and any node with a fixnum tag) as a
+ leaf.</p>
</li>
<li>
<p>There are some advantages to treating everything
- else - memory-allocated objects that aren't CONS cells -
- uniformly.There are some disadvantages to that uniform
- treatment as well, and the treatment of "memory-allocated
- non-CONS objects" isn't entirely uniform across all
- Clozure CL implementations. Let's first pretend that
- the treatment is uniform, then discuss the ways in which it
- isn't.The "uniform approach" is to treat all
- memory-allocated non-CONS objects as if they were vectors;
- this use of the term is a little looser than what's implied
- by the CL VECTOR type. Clozure CL actually uses the
- term "uvector" to mean "a memory-allocated lisp object
- other than a CONS cell,whose first word is a header which
- describes the object's type and the number of elements that
- it contains." In this view, a SYMBOL is a UVECTOR, as is a
- STRING, a STANDARD-INSTANCE, a CL array or vector,a
- FUNCTION, and even a DOUBLE-FLOAT.In the PPC
- implementations (where things are a little more
- ... uniform),a single tag value is used to denote any
- uvector; in order to determine something more specific
- about the type of the object in question, it's necessary to
- fetch the low byte of the header word from memory. On
- the x86-64 platform, certain types of uvectors - SYMBOLs
- and FUNCTIONs -are given their own unique tags. The good
- news about the x86-64 approach is that SYMBOLs and
- FUNCTIONs can be recognized without referencing memory; the
- slightly bad news is that primitive operations that work on
- UVECTOR-tagged objects - like the function CCL:UVREF -
- don't work on SYMBOLs or FUNCTIONs on x86-64 (but -do- work
- on those types of objects in the PPC ports.) The header word
- which precedes a UVECTOR's data in memory contains 8 bits
- of type information in the low byte and either 24 or 56
- bits of"element-count" information in the rest of the
- word. (This is where the sometimes-limiting value of 2^24
- for ARRAY-TOTAL-SIZE-LIMIT on PPC32 platforms comes from.)
- The low byte of the header - sometimes called the uvector's
- subtag - is itself tagged (which means that the header is
- tagged.) The (3 or 4) tag bits in the subtag are used to
- determine whether the uvector's elements are nodes or
- immediates.(A UVECTOR whose elements are nodes is called a
- GVECTOR; a UVECTOR whose elements are immediates is called
- an IVECTOR. This terminology came from Spice Lisp, which
- was a predecessor of CMUCL.) Even though a uvector header
- is tagged, a header is not a node. There's no (supported)
- way to get your hands on one in lisp and doing so could be
- dangerous. (If the value of a header wound up in a lisp
- node register and that register wound up getting pushed on
- a thread's value stack, the GC might misinterpret that
- situation to mean that there was a stack-allocated UVECTOR
- on the value stack.)</p>
+ else=C3=A2=C2=80=C2=94memory-allocated objects that aren't CONS
+ cells=C3=A2=C2=80=C2=94uniformly.There are some disadvantages to
+ that uniform treatment as well, and the treatment of
+ "memory-allocated non-CONS objects" isn't entirely
+ uniform across all Clozure CL implementations. Let's first
+ pretend that the treatment is uniform, then discuss the
+ ways in which it isn't.The "uniform approach" is to
+ treat all memory-allocated non-CONS objects as if they
+ were vectors; this use of the term is a little looser
+ than what's implied by the CL VECTOR type. Clozure CL
+ actually uses the term "uvector" to mean "a
+ memory-allocated lisp object other than a CONS cell,
+ whose first word is a header that describes the object's
+ type and the number of elements that it contains." In
+ this view, a SYMBOL is a UVECTOR, as is a STRING, a
+ STANDARD-INSTANCE, a CL array or vector, a FUNCTION, and
+ even a DOUBLE-FLOAT. In the PPC implementations (where
+ things are a little more ... uniform), a single tag
+ value is used to denote any uvector; in order to
+ determine something more specific about the type of the
+ object in question, it's necessary to fetch the low byte
+ of the header word from memory. On the x86-64 platform,
+ certain types of uvectors - SYMBOLs and FUNCTIONs -are
+ given their own unique tags. The good news about the
+ x86-64 approach is that SYMBOLs and FUNCTIONs can be
+ recognized without referencing memory; the slightly bad
+ news is that primitive operations that work on
+ UVECTOR-tagged objects=C3=A2=C2=80=C2=94like the function
+ CCL:UVREF=C3=A2=C2=80=C2=94don't work on SYMBOLs or FUNCTIONs on
+ x86-64 (but -do- work on those types of objects in the
+ PPC ports.) The header word that precedes a UVECTOR's
+ data in memory contains 8 bits of type information in
+ the low byte and either 24 or 56 bits of "element-count"
+ information in the rest of the word. (This is where the
+ sometimes-limiting value of 2^24 for
+ ARRAY-TOTAL-SIZE-LIMIT on PPC32 platforms comes from.)
+ The low byte of the header=C3=A2=C2=80=C2=94sometimes called the
+ uvector's subtag=C3=A2=C2=80=C2=94is itself tagged (which means
+ that the header is tagged.) The (3 or 4) tag bits in
+ the subtag are used to determine whether the uvector's
+ elements are nodes or immediates. (A UVECTOR whose
+ elements are nodes is called a GVECTOR; a UVECTOR whose
+ elements are immediates is called an IVECTOR. This
+ terminology came from Spice Lisp, which was a
+ predecessor of CMUCL.) Even though a uvector header is
+ tagged, a header is not a node. There's no (supported)
+ way to get your hands on one in lisp and doing so could
+ be dangerous. (If the value of a header wound up in a
+ lisp node register and that register wound up getting
+ pushed on a thread's value stack, the GC might
+ misinterpret that situation to mean that there was a
+ stack-allocated UVECTOR on the value stack.)</p>
</li>
</ul>
</div>
@@ -18762,34 +18777,35 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">When the Clozure CL ke=
rnel first
- starts up, a large contiguous chunk of the process's address
- space is mapped as "anonymous, no access" memory. ("Large" means
- different things in different contexts; on LinuxPPC32, it means
- "about 1 gigabyte", on DarwinPPC32, it means "about 2
- gigabytes", and on current 64-bit platforms it ranges from 128
- to 512 gigabytes, depending on OS. These values are both
- defaults and upper limits; the --heap-reserve argument can be
- used to try to reserve less than the default.)</p>
+ starts up, a large contiguous chunk of the process's address
+ space is mapped as "anonymous, no access" memory. ("Large"
+ means different things in different contexts; on LinuxPPC32,
+ it means "about 1 gigabyte", on DarwinPPC32, it means "about 2
+ gigabytes", and on current 64-bit platforms it ranges from 128
+ to 512 gigabytes, depending on OS. These values are both
+ defaults and upper limits;
+ the <code class=3D"literal">--heap-reserve</code> argument can be =
used to
+ try to reserve less than the default.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Reserving address spac=
e that can't (yet) be read or
- written to doesn't cost much; in particular, it doesn't require
- that corresponding swap space or physical memory be available.
- Marking the address range as being "mapped" helps to ensure that
- other things (results from random calls to malloc(), dynamically
- loaded shared libraries) won't be allocated in this region that
- lisp has reserved for its own heap growth.</p>
+ written to doesn't cost much; in particular, it doesn't require
+ that corresponding swap space or physical memory be available.
+ Marking the address range as being "mapped" helps to ensure that
+ other things (results from random calls to malloc(), dynamically
+ loaded shared libraries) won't be allocated in this region that
+ lisp has reserved for its own heap growth.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A small portion (aroun=
d 1/32 on 32-bit platforms and 1/64
- on 64-bit platforms) of that large chunk of address space is
- reserved for GC data structures. Memory pages reserved for
- these data structures are mapped read-write as pages made
- writable in the main portion of the heap.</p>
+ on 64-bit platforms) of that large chunk of address space is
+ reserved for GC data structures. Memory pages reserved for
+ these data structures are mapped read-write as pages are made
+ writable in the main portion of the heap.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The initial heap image=
is mapped into this reserved
- address space and an additional (LISP-HEAP-GC-THRESHOLD) bytes
- are mapped read-write. GC data structures grow to match the
- amount of GC-able memory in the initial image + the gc
- threshold, and control is transferred to lisp code. Inevitably,
- that code spoils everything and starts consing; there are
- basically three layers of memory allocation that can go
- on.</p>
+ address space and an additional (LISP-HEAP-GC-THRESHOLD) bytes
+ are mapped read-write. GC data structures grow to match the
+ amount of GC-able memory in the initial image plus the gc
+ threshold, and control is transferred to lisp code.
+ Inevitably, that code spoils everything and starts consing;
+ there are basically three layers of memory allocation that can
+ go on.</p>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
@@ -18799,17 +18815,17 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Each lisp thread has=
a private "reserved memory
- segment"; when a thread starts up, its reserved memory segment
- is empty. PPC ports maintain the highest unallocated address
- and the lowest allocatable address in the current segment in
- registers when running lisp code; on x86-664, these values are
- maintained in the current threads's TCR. (An "empty" heap
- segment is one whose high pointer and low pointer are equal.)
- When a thread is not in the middle of allocating something, the
- low 3 or 4 bits of the high and low pointers are clear (the
- pointers are doublenode-aligned.)</p>
+ segment"; when a thread starts up, its reserved memory segment
+ is empty. PPC ports maintain the highest unallocated address
+ and the lowest allocatable address in the current segment in
+ registers when running lisp code; on x86-664, these values are
+ maintained in the current threads's TCR. (An "empty" heap
+ segment is one whose high pointer and low pointer are equal.)
+ When a thread is not in the middle of allocating something, the
+ low 3 or 4 bits of the high and low pointers are clear (the
+ pointers are doublenode-aligned.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A thread tries to al=
locate an object whose physical size
- in bytes is X and whose tag is Y by:</p>
+ in bytes is X and whose tag is Y by:</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"orderedli=
st">
<ol type=3D"1">
<li>
@@ -18817,11 +18833,11 @@
</li>
<li>
<p>trapping if the high pointer is less than the low
- pointer</p>
+ pointer</p>
</li>
<li>
<p>using the (tagged) high pointer to initialize the
- object, if necessary</p>
+ object, if necessary</p>
</li>
<li>
<p>clearing the low bits of the high pointer</p>
@@ -18829,9 +18845,9 @@
</ol>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On PPC32, where the =
size of a CONS cell is 8 bytes and
- the tag of a CONS cell is 1, machine code which sets the arg_z
- register to the result of doing (CONS arg_y arg_z) looks
- like:</p>
+ the tag of a CONS cell is 1, machine code which sets the arg_z
+ register to the result of doing (CONS arg_y arg_z) looks
+ like:</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programli=
sting">
(SUBI ALLOCPTR ALLOCPTR 7) ; decrement the high pointer by (- 8 1)
(TWLLT ALLOCPTR ALLOCBASE) ; trap if the high pointer is below the ba=
se
@@ -18839,13 +18855,13 @@
(STW ARG_Y 3 ALLOCPTR) ; set the CAR
(MR ARG_Z ALLOCPTR) ; arg_z is the new CONS cell
(RLWINM ALLOCPTR ALLOCPTR 0 0 28) ; clear tag bits
- </pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On x86-64, the idea'=
s similar but the implementation is
- different. The high and low pointers to the current thread's
- reserved segment are kept in the TCR, which is addressed by
- the gs segment register. An x86-64 CONS cell is 16 bytes wide
- and has a tag of 3; we canonically use the temp0 register to
- initialize the object</p>
+ different. The high and low pointers to the current thread's
+ reserved segment are kept in the TCR, which is addressed by
+ the gs segment register. An x86-64 CONS cell is 16 bytes wide
+ and has a tag of 3; we canonically use the temp0 register to
+ initialize the object</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programli=
sting">
(subq ($ 13) ((% gs) 216)) ; decrement allocptr
(movq ((% gs) 216) (% temp0)) ; load allocptr into temp0
@@ -18857,12 +18873,12 @@
(movq (% arg_y) (5 (% temp0))) ; set the car
(movq (% arg_z) (-3 (% temp0))); set the cdr
(movq (% temp0) (% arg_z)) ; return the cons
- </pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If we don't take the=
trap (if allocating 8-16 bytes
- doesn't exhaust the thread's reserved memory segment), that's
- a fairly short and simple instruction sequence. If we do take
- the trap, we'll have to do some additional work in order to
- get a new segment for the current thread.</p>
+ doesn't exhaust the thread's reserved memory segment), that's
+ a fairly short and simple instruction sequence. If we do take
+ the trap, we'll have to do some additional work in order to
+ get a new segment for the current thread.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -18873,31 +18889,31 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">After the lisp image=
is first mapped into memory - and after
- each full GC - the lisp kernel ensures that
- (LISP-HEAP-GC-TRESHOLD) additional bytes beyond the current
- end of the heap are mapped read-write.</p>
+ each full GC - the lisp kernel ensures that
+ (LISP-HEAP-GC-TRESHOLD) additional bytes beyond the current
+ end of the heap are mapped read-write.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If a thread traps wh=
ile trying to allocate memory, the
- thread goes through the usual exception-handling protocol (to
- ensure that any other thread that GCs "sees" the state of the
- trapping thread and to serialize exception handling.) When
- the exception handler runs, it determines the nature and size
- of the failed allocation and tries to complete the allocation
- on the thread's behalf (and leave it with a reasonably large
- thread-specific memory segment so that the next small
- allocation is unlikely to trap.</p>
+ thread goes through the usual exception-handling protocol (to
+ ensure that any other thread that GCs "sees" the state of the
+ trapping thread and to serialize exception handling.) When
+ the exception handler runs, it determines the nature and size
+ of the failed allocation and tries to complete the allocation
+ on the thread's behalf (and leave it with a reasonably large
+ thread-specific memory segment so that the next small
+ allocation is unlikely to trap.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Depending on the siz=
e of the requested segment
- allocation, the number of segment allocations that have
- occurred since the last GC, and the EGC and GC thresholds, the
- segment allocation trap handler may invoke a full or ephemeral
- GC before returning a new segment. It's worth noting that the
- [E]GC is triggered based on the number of and size of these
- segments that have been allocated since the last GC; it doesn't
- have much to do with how "full" each of those per-thread
- segments are. It's possible for a large number of threads to
- do fairly incidental memory allocation and trigger the GC as a
- result; avoiding this involves tuning the per-thread
- allocation quantum and the GC/EGC thresholds
- appropriately.</p>
+ allocation, the number of segment allocations that have
+ occurred since the last GC, and the EGC and GC thresholds, the
+ segment allocation trap handler may invoke a full or ephemeral
+ GC before returning a new segment. It's worth noting that the
+ [E]GC is triggered based on the number of and size of these
+ segments that have been allocated since the last GC; it doesn't
+ have much to do with how "full" each of those per-thread
+ segments are. It's possible for a large number of threads to
+ do fairly incidental memory allocation and trigger the GC as a
+ result; avoiding this involves tuning the per-thread
+ allocation quantum and the GC/EGC thresholds
+ appropriately.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -18908,27 +18924,27 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">All OSes on which Cl=
ozure CL currently runs use an
- "overcommit" memory allocation strategy by default (though
- some of them provide ways of overriding that default.) What
- this means in general is that the OS doesn't necessarily
- ensure that backing store is available when asked to map pages
- as read-write; it'll often return a success indicator from the
- mapping attempt (mapping the pages as "zero-fill,
- copy-on-write"), and only try to allocate the backing store
- (swap space and/or physical memory) when non-zero contents are
- written to the pages.</p>
+ "overcommit" memory allocation strategy by default (though
+ some of them provide ways of overriding that default.) What
+ this means in general is that the OS doesn't necessarily
+ ensure that backing store is available when asked to map pages
+ as read-write; it'll often return a success indicator from the
+ mapping attempt (mapping the pages as "zero-fill,
+ copy-on-write"), and only try to allocate the backing store
+ (swap space and/or physical memory) when non-zero contents are
+ written to the pages.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">It -sounds- like it'=
d be better to have the mmap() call
- fail immediately, but it's actually a complicated issue.
- (It's possible that other applications will stop using some
- backing store before lisp code actually touches the pages that
- need it, for instance.) It's also not guaranteed that lisp
- code would be able to "cleanly" signal an out-of-memory
- condition if lisp is ... out of memory</p>
+ fail immediately, but it's actually a complicated issue.
+ (It's possible that other applications will stop using some
+ backing store before lisp code actually touches the pages that
+ need it, for instance.) It's also not guaranteed that lisp
+ code would be able to "cleanly" signal an out-of-memory
+ condition if lisp is ... out of memory</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">I don't know that I'=
ve ever seen an abrupt out-of-memory
- failure that wasn't preceded by several minutes of excessive
- paging activity. The most expedient course in cases like this
- is to either (a) use less memory or (b) get more memory; it's
- generally hard to use memory that you don't have.</p>
+ failure that wasn't preceded by several minutes of excessive
+ paging activity. The most expedient course in cases like this
+ is to either (a) use less memory or (b) get more memory; it's
+ generally hard to use memory that you don't have.</p>
</div>
</div>
<div class=3D"sect1" lang=3D"en" xml:lang=3D"en">
@@ -18940,31 +18956,31 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The GC uses a Mark/Com=
pact algorithm; its
- execution time is essentially a factor of the amount of live
- data in the heap. (The somewhat better-known Mark/Sweep
- algorithms don't compact the live data but instead traverse the
- garbage to rebuild free-lists; their execution time is therefore
- a factor of the total heap size.)</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">As mentioned in <a hre=
f=3D"#Heap-Allocation" title=3D"16.3.=C3=82=C2=A0Heap Allocation">Section=
=C3=82=C2=A016.3, =C3=A2=C2=80=C2=9CHeap Allocation=C3=A2=C2=80=C2=9D</a>, =
two
- auxiliary data structures (proportional to the size of the lisp
- heap) are maintained. These are</p>
+ execution time is essentially a factor of the amount of live
+ data in the heap. (The somewhat better-known Mark/Sweep
+ algorithms don't compact the live data but instead traverse the
+ garbage to rebuild free-lists; their execution time is therefore
+ a factor of the total heap size.)</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">As mentioned in <a cla=
ss=3D"xref" href=3D"#Heap-Allocation" title=3D"16.3.=C3=82=C2=A0Heap Alloca=
tion">Section=C3=82=C2=A016.3, =C3=A2=C2=80=C2=9CHeap Allocation=C3=A2=C2=
=80=C2=9D</a>, two
+ auxiliary data structures (proportional to the size of the lisp
+ heap) are maintained. These are</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"orderedlist=
">
<ol type=3D"1">
<li>
<p>the markbits bitvector, which contains a bit for
- every doublenode in the dynamic heap (plus a few extra words
- for alignment and so that sub-bitvectors can start on word
- boundaries.)</p>
+ every doublenode in the dynamic heap (plus a few extra words
+ for alignment and so that sub-bitvectors can start on word
+ boundaries.)</p>
</li>
<li>
<p>the relocation table, which contains a native word for
- every 32 or 64 doublenodes in the dynamic heap, plus an
- extra word used to keep track of the end of the heap.</p>
+ every 32 or 64 doublenodes in the dynamic heap, plus an
+ extra word used to keep track of the end of the heap.</p>
</li>
</ol>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The total GC space ove=
rhead is therefore on the order of
- 3% (2/64 or 1/32).</p>
+ 3% (2/64 or 1/32).</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The general algorithm =
proceeds as follows:</p>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -18975,23 +18991,23 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Each doublenode in t=
he dynamic heap has a corresponding
- bit in the markbits vector. (For any doublenode in the heap,
- the index of its mark bit is determined by subtracting the
- address of the start of the heap from the address of the
- object and dividing the result by 8 or 16.) The GC knows the
- markbit index of the free pointer, so determining that the
- markbit index of a doubleword address is between the start of
- the heap and the free pointer can be done with a single
- unsigned comparison.</p>
+ bit in the markbits vector. (For any doublenode in the heap,
+ the index of its mark bit is determined by subtracting the
+ address of the start of the heap from the address of the
+ object and dividing the result by 8 or 16.) The GC knows the
+ markbit index of the free pointer, so determining that the
+ markbit index of a doubleword address is between the start of
+ the heap and the free pointer can be done with a single
+ unsigned comparison.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The markbits of all =
doublenodes in the dynamic heap are
- zeroed before the mark phase begins. An object is
- <span class=3D"emphasis"><em>marked</em></span> if the markbits of=
all of its
- constituent doublewords are set and unmarked otherwise;
- setting an object's markbits involves setting the corresponding
- markbits of all constituent doublenodes in the object.</p>
+ zeroed before the mark phase begins. An object is
+ <span class=3D"emphasis"><em>marked</em></span> if the markbits =
of all of its
+ constituent doublewords are set and unmarked otherwise;
+ setting an object's markbits involves setting the corresponding
+ markbits of all constituent doublenodes in the object.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The mark phase trave=
rses each root. If the tag of the
- value of the root indicates that it's a non-immediate node
- whose address lies in the lisp heap, then:</p>
+ value of the root indicates that it's a non-immediate node
+ whose address lies in the lisp heap, then:</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"orderedli=
st">
<ol type=3D"1">
<li>
@@ -19005,63 +19021,63 @@
</li>
<li>
<p>If the object is a cons cell, recursively mark its
- car and cdr.</p>
+ car and cdr.</p>
</li>
<li>
<p>Otherwise, the object is a gvector. Recursively mark
- its elements.</p>
+ its elements.</p>
</li>
</ol>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Marking an object th=
us involves ensuring that its mark
- bits are set and then recursively marking any pointers
- contained within the object if the object was originally
- unmarked. If this recursive step was implemented in the
- obvious manner, marking an object would take stack space
- proportional to the length of the pointer chain from some root
- to that object. Rather than storing that pointer chain
- implicitly on the stack (in a series of recursive calls to the
- mark subroutine), the Clozure CL marker uses mixture of recursion
- and a technique called <span class=3D"emphasis"><em>link inversion=
</em></span> to
- store the pointer chain in the objects themselves. (Recursion
- tends to be simpler and faster; if a recursive step notes that
- stack space is becoming limited, the link-inversion technique
- is used.)</p>
+ bits are set and then recursively marking any pointers
+ contained within the object if the object was originally
+ unmarked. If this recursive step was implemented in the
+ obvious manner, marking an object would take stack space
+ proportional to the length of the pointer chain from some root
+ to that object. Rather than storing that pointer chain
+ implicitly on the stack (in a series of recursive calls to the
+ mark subroutine), the Clozure CL marker uses mixture of recursion
+ and a technique called <span class=3D"emphasis"><em>link inversi=
on</em></span> to
+ store the pointer chain in the objects themselves. (Recursion
+ tends to be simpler and faster; if a recursive step notes that
+ stack space is becoming limited, the link-inversion technique
+ is used.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Certain types of obj=
ects are treated a little specially:</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"orderedli=
st">
<ol type=3D"1">
<li>
<p>To support a feature called <span class=3D"emphasis">=
<em>GCTWA
- <sup>[<a id=3D"id439619" href=3D"#ftn.id439619">1</a>]</sup>
- , </em></span>the vector which contains the
- internal symbols of the current package is marked on
- entry to the mark phase, but the symbols themselves are
- not marked at this time. Near the end of the mark phase,
- symbols referenced from this vector which are
- not otherwise marked are marked if and only if they're
- somehow distinguishable from newly created symbols (by
- virtue of their having function bindings, value bindings,
- plists, or other attributes.)</p>
+ <sup>[<a id=3D"id418468" href=3D"#ftn.id418468" class=3D"f=
ootnote">1</a>]</sup>
+ , </em></span>the vector that contains the internal
+ symbols of the current package is marked on entry to the
+ mark phase, but the symbols themselves are not marked at
+ this time. Near the end of the mark phase, symbols
+ referenced from this vector which are not otherwise
+ marked are marked if and only if they're somehow
+ distinguishable from newly created symbols (by virtue of
+ their having function bindings, value bindings, plists,
+ or other attributes.)</p>
</li>
<li>
<p>Pools have their first element set to NIL before any
- other elements are marked.</p>
+ other elements are marked.</p>
</li>
<li>
<p>All hash tables have certain fields (used to cache
- previous results) invalidated.</p>
+ previous results) invalidated.</p>
</li>
<li>
<p>Weak Hash Tables and other weak objects are put on a
- linkedlist as they're encountered; their contents are only
- retained if there are other (non-weak) references to
- them.</p>
+ linkedlist as they're encountered; their contents are only
+ retained if there are other (non-weak) references to
+ them.</p>
</li>
</ol>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">At the end of the ma=
rk phase, the markbits of all
- objects which are transitively reachable from the roots are
- set and all other markbits are clear.</p>
+ objects that are transitively reachable from the roots are
+ set and all other markbits are clear.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -19072,36 +19088,36 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The <span class=3D"e=
mphasis"><em>forwarding address</em></span> of a
- doublenode in the dynamic heap is (<its current address> -
- (size_of_doublenode * <the number of unmarked markbits that
- precede it>)) or alternately (<the base of the heap> +
- (size_of_doublenode * <the number of marked markbits that
- precede it >)). Rather than count the number of preceding
- markbits each time, the relocation table is used to precompute
- an approximation of the forwarding addresses for all
- doublewords. Given this approximate address and a pointer into
- the markbits vector, it's relatively easy to compute the exact
- forwarding address.</p>
+ doublenode in the dynamic heap is (<its current address> -
+ (size_of_doublenode * <the number of unmarked markbits that
+ precede it>)) or alternately (<the base of the heap> +
+ (size_of_doublenode * <the number of marked markbits that
+ precede it >)). Rather than count the number of preceding
+ markbits each time, the relocation table is used to precompute
+ an approximation of the forwarding addresses for all
+ doublewords. Given this approximate address and a pointer into
+ the markbits vector, it's relatively easy to compute the exact
+ forwarding address.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The relocation table=
contains the forwarding addresses
- of each <span class=3D"emphasis"><em>pagelet</em></span>, where a pagelet=
is 256
- bytes (or 32 doublenodes). The forwarding address of the first
- pagelet is the base of the heap. The forwarding address of the
- second pagelet is the sum of the forwarding address of the
- first and 8 bytes for each mark bit set in the first 32-bit
- word in the markbits table. The last entry in the relocation
- table contains the forwarding address that the freepointer
- would have, e.g., the new value of the freepointer after
- compaction.</p>
+ of each <span class=3D"emphasis"><em>pagelet</em></span>, where a p=
agelet is 256
+ bytes (or 32 doublenodes). The forwarding address of the first
+ pagelet is the base of the heap. The forwarding address of the
+ second pagelet is the sum of the forwarding address of the
+ first and 8 bytes for each mark bit set in the first 32-bit
+ word in the markbits table. The last entry in the relocation
+ table contains the forwarding address that the freepointer
+ would have, e.g., the new value of the freepointer after
+ compaction.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In many programs, ol=
d objects rarely become garbage and
- new objects often do. When building the relocation table, the
- relocation phase notes the address of the first unmarked
- object in the dynamic heap. Only the area of the heap between
- the first unmarked object and the freepointer needs to be
- compacted; only pointers to this area will need to be
- forwarded (the forwarding address of all other pointers to the
- dynamic heap is the address of that pointer.) Often, the
- first unmarked object is much nearer the free pointer than it
- is to the base of the heap.</p>
+ new objects often do. When building the relocation table, the
+ relocation phase notes the address of the first unmarked
+ object in the dynamic heap. Only the area of the heap between
+ the first unmarked object and the freepointer needs to be
+ compacted; only pointers to this area will need to be
+ forwarded (the forwarding address of all other pointers to the
+ dynamic heap is the address of that pointer.) Often, the
+ first unmarked object is much nearer the free pointer than it
+ is to the base of the heap.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -19112,33 +19128,33 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The forwarding phase=
traverses all roots and the "old"
- part of the dynamic heap (the part between the base of the
- heap and the first unmarked object.) All references to objects
- whose address is between the first unmarked object and the
- free pointer are updated to point to the address the object
- will have after compaction by using the relocation table and
- the markbits vector and interpolating.</p>
+ part of the dynamic heap (the part between the base of the
+ heap and the first unmarked object.) All references to objects
+ whose address is between the first unmarked object and the
+ free pointer are updated to point to the address the object
+ will have after compaction by using the relocation table and
+ the markbits vector and interpolating.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The relocation table=
entry for the pagelet nearest the
- object is found. If the pagelet's address is less than the
- object's address, the number of set markbits that precede the
- object on the pagelet is used to determine the object's
- address; otherwise, the number of set markbits the follow the
- object on the pagelet is used.</p>
+ object is found. If the pagelet's address is less than the
+ object's address, the number of set markbits that precede
+ the object on the pagelet is used to determine the object's
+ address; otherwise, the number of set markbits that follow
+ the object on the pagelet is used.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Since forwarding vie=
ws the heap as a set of doublewords,
- locatives are (mostly) treated like any other pointers. (The
- basic difference is that locatives may appear to be tagged as
- fixnums, in which case they're treated as word-aligned
- pointers into the object.)</p>
+ locatives are (mostly) treated like any other pointers. (The
+ basic difference is that locatives may appear to be tagged as
+ fixnums, in which case they're treated as word-aligned
+ pointers into the object.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If the forward phase=
changes the address of any hash
- table key in a hash table that hashes by address (e.g., an EQ
- hash table), it sets a bit in the hash table's header. The
- hash table code will rehash the hash table's contents if it
- tries to do a lookup on a key in such a table.</p>
+ table key in a hash table that hashes by address (e.g., an EQ
+ hash table), it sets a bit in the hash table's header. The
+ hash table code will rehash the hash table's contents if it
+ tries to do a lookup on a key in such a table.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Profiling reveals th=
at about half of the total time
- spent in the GC is spent in the subroutine which determines a
- pointer's forwarding address. Exploiting GCC-specific idioms,
- hand-coding the routine, and inlining calls to it could all be
- expected to improve GC performance.</p>
+ spent in the GC is spent in the subroutine which determines a
+ pointer's forwarding address. Exploiting GCC-specific idioms,
+ hand-coding the routine, and inlining calls to it could all be
+ expected to improve GC performance.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -19149,25 +19165,25 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The compact phase co=
mpacts the area between the first
- unmarked object and the freepointer so that it contains only
- marked objects. While doing so, it forwards any pointers it
- finds in the objects it copies.</p>
+ unmarked object and the freepointer so that it contains only
+ marked objects. While doing so, it forwards any pointers it
+ finds in the objects it copies.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">When the compact pha=
se is finished, so is the GC (more
- or less): the free pointer and some other data structures are
- updated and control returns to the exception handler that
- invoked the GC. If sufficient memory has been freed to satisfy
- any allocation request that may have triggered the GC, the
- exception handler returns; otherwise, a "seriously low on
- memory" condition is signaled, possibly after releasing a
- small emergency pool of memory.</p>
- </div>
- <div xmlns=3D"" class=3D"footnotes">
+ or less): the free pointer and some other data structures are
+ updated and control returns to the exception handler that
+ invoked the GC. If sufficient memory has been freed to satisfy
+ any allocation request that may have triggered the GC, the
+ exception handler returns; otherwise, a "seriously low on
+ memory" condition is signaled, possibly after releasing a
+ small emergency pool of memory.</p>
+ </div>
+ <div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"footnotes">
<br />
<hr width=3D"100" align=3D"left" />
- <div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"footnote">
- <p><sup>[<a id=3D"ftn.id439619" href=3D"#id439619">1</a>] </=
sup>I believe that the acronym comes from MACLISP,
- where it stood for "Garbage Collection of Truly
- Worthless Atoms".</p>
+ <div class=3D"footnote">
+ <p><sup>[<a id=3D"ftn.id418468" href=3D"#id418468" class=3D"=
para">1</a>] </sup>I believe that the acronym comes from MACLISP,
+ where it stood for "Garbage Collection of Truly
+ Worthless Atoms".</p>
</div>
</div>
</div>
@@ -19180,126 +19196,130 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In the Clozure CL memo=
ry management scheme, the relative age
- of two objects in the dynamic heap can be determined by their
- addresses: if addresses X and Y are both addresses in the
- dynamic heap, X is younger than Y (X was created more recently
- than Y) if it is nearer to the free pointer (and farther from
- the base of the heap) than Y.</p>
+ of two objects in the dynamic heap can be determined by their
+ addresses: if addresses X and Y are both addresses in the
+ dynamic heap, X is younger than Y (X was created more recently
+ than Y) if it is nearer to the free pointer (and farther from
+ the base of the heap) than Y.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Ephemeral (or generati=
onal) garbage collectors attempt to
- exploit the following assumptions:</p>
+ exploit the following assumptions:</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"itemizedlis=
t">
<ul type=3D"disc">
<li>
<p>most newly created objects become garbage soon after
- they'recreated.</p>
+ they'recreated.</p>
</li>
<li>
<p>most objects that have already survived several GCs
- are unlikely to ever become garbage.</p>
+ are unlikely to ever become garbage.</p>
</li>
<li>
<p>old objects can only point to newer objects as the
- result of a destructive modification (e.g., via
- SETF.)</p>
+ result of a destructive modification (e.g., via
+ SETF.)</p>
</li>
</ul>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">By concentrating its e=
fforts on (frequently and quickly)
- reclaiming newly created garbage, an ephemeral collector hopes
- to postpone the more costly full GC as long as possible. It's
- important to note that most programs create some long-lived
- garbage, so an EGC can't typically eliminate the need for full
- GC.</p>
+ reclaiming newly created garbage, an ephemeral collector hopes
+ to postpone the more costly full GC as long as possible. It's
+ important to note that most programs create some long-lived
+ garbage, so an EGC can't typically eliminate the need for full
+ GC.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">An EGC views each obje=
ct in the heap as belonging to
- exactly one <span class=3D"emphasis"><em>generation</em></span>; gen=
erations are
- sets of objects that are related to each other by age: some
- generation is the youngest, some the oldest, and there's an age
- relationship between any intervening generations. Objects are
- typically assigned to the youngest generation when first
- allocated; any object that has survived some number of GCs in
- its current generation is promoted (or
- <span class=3D"emphasis"><em>tenured</em></span>) into an older gene=
ration.</p>
+ exactly one <span class=3D"emphasis"><em>generation</em></span>; g=
enerations are
+ sets of objects that are related to each other by age: some
+ generation is the youngest, some the oldest, and there's an age
+ relationship between any intervening generations. Objects are
+ typically assigned to the youngest generation when first
+ allocated; any object that has survived some number of GCs in
+ its current generation is promoted (or
+ <span class=3D"emphasis"><em>tenured</em></span>) into an older ge=
neration.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">When a generation is G=
Ced, the roots consist of the
- stacks, registers, and global variables as always and also of
- any pointers to objects in that generation from other
- generations. To avoid the need to scan those (often large) other
- generations looking for such intergenerational references, the
- runtime system must note all such intergenerational references
- at the point where they're created (via Setf).<sup>[<a id=3D"id52885=
2" href=3D"#ftn.id528852">2</a>]</sup> The
- set of pointers that may contain intergenerational references is
- sometimes called <span class=3D"emphasis"><em>the remembered set</em=
></span>.</p>
+ stacks, registers, and global variables as always and also of
+ any pointers to objects in that generation from other
+ generations. To avoid the need to scan those (often large) other
+ generations looking for such intergenerational references, the
+ runtime system must note all such intergenerational references
+ at the point where they're created (via Setf).<sup>[<a id=3D"id418=
704" href=3D"#ftn.id418704" class=3D"footnote">2</a>]</sup> The
+ set of pointers that may contain intergenerational references is
+ sometimes called <span class=3D"emphasis"><em>the remembered set</=
em></span>.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In Clozure CL's EGC, t=
he heap is organized exactly the same
- as otherwise; "generations" are merely structures which contain
- pointers to regions of the heap (which is already ordered by
- age.) When a generation needs to be GCed, any younger generation
- is incorporated into it; all objects which survive a GC of a
- given generation are promoted into the next older
- generation. The only intergenerational references that can exist
- are therefore those where an old object is modified to contain a
- pointer to a new object.</p>
+ as otherwise; "generations" are merely structures which contain
+ pointers to regions of the heap (which is already ordered by
+ age.) When a generation needs to be GCed, any younger generation
+ is incorporated into it; all objects which survive a GC of a
+ given generation are promoted into the next older
+ generation. The only intergenerational references that can exist
+ are therefore those where an old object is modified to contain a
+ pointer to a new object.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The EGC uses exactly t=
he same code as the full GC. When a
- given GC is "ephemeral",</p>
+ given GC is "ephemeral",</p>
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"itemizedlis=
t">
<ul type=3D"disc">
<li>
<p>the "base of the heap" used to determine an object's
- markbit address is the base of the generation
- being collected;</p>
+ markbit address is the base of the generation
+ being collected;</p>
</li>
<li>
<p>the markbits vector is actually a pointer into the
- middle of the global markbits table; preceding entries in
- this table are used to note doubleword addresses in older
- generations that (may) contain intergenerational
- references;</p>
+ middle of the global markbits table; preceding entries in
+ this table are used to note doubleword addresses in older
+ generations that (may) contain intergenerational
+ references;</p>
</li>
<li>
<p>some steps (notably GCTWA and the handling of weak
- objects) are not performed;</p>
+ objects) are not performed;</p>
</li>
<li>
<p>the intergenerational references table is used to
- find additional roots for the mark and forward phases. If a
- bit is set inthe intergenerational references table, that
- means that the corresponding doubleword (in some "old"
- generation, in some "earlier" part of the heap) may have had
- a pointer to an object in a younger generation stored into
- it.</p>
+ find additional roots for the mark and forward phases. If a
+ bit is set in the intergenerational references table, that
+ means that the corresponding doubleword (in some "old"
+ generation, in some "earlier" part of the heap) may have had
+ a pointer to an object in a younger generation stored into
+ it.</p>
</li>
</ul>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">With one exception (th=
e implicit setfs that occur on entry
- to and exit from the binding of a special variable), all setfs
- that might introduce an intergenerational reference must be
- memoized. at footnote{Note that the implicit setfs that occur when
- initializing an object - as in the case of a call to cons or
- vector - can't introduce intergenerational references, since the
- newly created object is always younger than the objects used to
- initialize it.} It's always safe to push any cons cell or
- gvector locative onto the memo stack; it's never safe to push
- anything else.
+ to and exit from the binding of a special variable), all setfs
+ that might introduce an intergenerational reference must be
+ memoized.
+ <sup>[<a id=3D"id418773" href=3D"#ftn.id418773" class=3D"footnote"=
>3</a>]</sup> It's always safe to
+ push any cons cell or gvector locative onto the memo stack;
+ it's never safe to push anything else.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Typically, the interge=
nerational references bitvector is
- sparse: a relatively small number of old locations are stored
- into, although some of them may have been stored into many
- times. The routine that scans the memoization buffer does a lot
- of work and usually does it fairly often; it uses a simple,
- brute-force method but might run faster if it was smarter about
- recognizing addresses that it'd already seen.
+ sparse: a relatively small number of old locations are stored
+ into, although some of them may have been stored into many
+ times. The routine that scans the memoization buffer does a lot
+ of work and usually does it fairly often; it uses a simple,
+ brute-force method but might run faster if it was smarter about
+ recognizing addresses that it'd already seen.
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">When the EGC mark and =
forward phases scan the
- intergenerational reference bits, they can clear any bits that
- denote doublewords that definitely do not contain
- intergenerational references.
+ intergenerational reference bits, they can clear any bits that
+ denote doublewords that definitely do not contain
+ intergenerational references.
</p>
- <div xmlns=3D"" class=3D"footnotes">
+ <div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"footnotes">
<br />
<hr width=3D"100" align=3D"left" />
- <div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"footnote">
- <p><sup>[<a id=3D"ftn.id528852" href=3D"#id528852">2</a>] </=
sup>This is
- sometimes called "The Write Barrier": all assignments which
- might result in intergenerational references must be noted, as
- if the other generations were write-protected.</p>
+ <div class=3D"footnote">
+ <p><sup>[<a id=3D"ftn.id418704" href=3D"#id418704" class=3D"=
para">2</a>] </sup>This is
+ sometimes called "The Write Barrier": all assignments which
+ might result in intergenerational references must be noted, as
+ if the other generations were write-protected.</p>
+ </div>
+ <div class=3D"footnote">
+ <p><sup>[<a id=3D"ftn.id418773" href=3D"#id418773" class=3D"=
para">3</a>] </sup>Note that the implicit setfs that occur when
+ initializing an object - as in the case of a call to cons or
+ vector - can't introduce intergenerational references, since
+ the newly created object is always younger than the objects
+ used to initialize it.</p>
</div>
</div>
</div>
@@ -19312,43 +19332,43 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Saving and loading of =
Fasl files is implemented in
- xdump/faslenv.lisp, level-0/nfasload.lisp, and lib/nfcomp.lisp.
- The information here is only an overview, which might help when
- reading the source.</p>
+ xdump/faslenv.lisp, level-0/nfasload.lisp, and lib/nfcomp.lisp.
+ The information here is only an overview, which might help when
+ reading the source.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The Clozure CL Fasl fo=
rmat is forked from the old MCL Fasl
- format; there are a few differences, but they are minor. The
- name "nfasload" comes from the fact that this is the so-called
- "new" Fasl system, which was true in 1986 or so. </p>
+ format; there are a few differences, but they are minor. The
+ name "nfasload" comes from the fact that this is the so-called
+ "new" Fasl system, which was true in 1986 or so. </p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">A Fasl file begins wit=
h a "file header", which contains
- version information and a count of the following "blocks".
- There's typically only one "block" per Fasl file. The blocks
- are part of a mechanism for combining multiple logical files
- into a single physical file, in order to simplify the
- distribution of precompiled programs. </p>
+ version information and a count of the following "blocks".
+ There's typically only one "block" per Fasl file. The blocks
+ are part of a mechanism for combining multiple logical files
+ into a single physical file, in order to simplify the
+ distribution of precompiled programs. </p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Each block begins with=
a header for itself, which just
- describes the size of the data that follows.</p>
+ describes the size of the data that follows.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The data in each block=
is treated as a simple stream of
- bytes, which define a bytecode program. The actual bytecodes,
- "fasl operators", are defined in xdump/faslenv.lisp. The
- descriptions in the source file are terse, but, according to
- Gary, "probably accurate".</p>
+ bytes, which define a bytecode program. The actual bytecodes,
+ "fasl operators", are defined in xdump/faslenv.lisp. The
+ descriptions in the source file are terse, but, according to
+ Gary, "probably accurate".</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Some of the operators =
are used to create a per-block
- "object table", which is a vector used to keep track of
- previously-loaded objects and simplify references to them. When
- the table is created, an index associated with it is set to
- zero; this is analogous to an array fill-pointer, and allows the
- table to be treated like a stack.</p>
+ "object table", which is a vector used to keep track of
+ previously-loaded objects and simplify references to them. When
+ the table is created, an index associated with it is set to
+ zero; this is analogous to an array fill-pointer, and allows the
+ table to be treated like a stack.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The low seven bits of =
each bytecode are used to specify
- the fasl operator; currently, about fifty operators are defined.
- The high byte, when set, indicates that the result of the
- operation should be pushed onto the object table.</p>
+ the fasl operator; currently, about fifty operators are defined.
+ The high byte, when set, indicates that the result of the
+ operation should be pushed onto the object table.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Most bytecodes are fol=
lowed by operands; the operand data
- is byte-aligned. How many operands there are, and their type,
- depend on the bytecode. Operands can be indices into the object
- table, immediate values, or some combination of these.</p>
+ is byte-aligned. How many operands there are, and their type,
+ depend on the bytecode. Operands can be indices into the object
+ table, immediate values, or some combination of these.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">An exception is the by=
tecode #xFF, which has the symbolic
- name ccl::$faslend; it is used to mark the end of the
- block.</p>
+ name ccl::$faslend; it is used to mark the end of the
+ block.</p>
</div>
<div class=3D"sect1" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
@@ -19367,51 +19387,51 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In most cases, point=
ers to instances of Objective-C
- classes are recognized as such; the recognition is (and
- probably always will be) slightly heuristic. Basically, any
- pointer that passes basic sanity checks and whose first word
- is a pointer to a known ObjC class is considered to be an
- instance of that class; the Objective-C runtime system would
- reach the same conclusion.</p>
+ classes are recognized as such; the recognition is (and
+ probably always will be) slightly heuristic. Basically, any
+ pointer that passes basic sanity checks and whose first word
+ is a pointer to a known ObjC class is considered to be an
+ instance of that class; the Objective-C runtime system would
+ reach the same conclusion.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">It's certainly possi=
ble that a random pointer to an
- arbitrary memory address could look enough like an ObjC
- instance to fool the lisp runtime system, and it's possible
- that pointers could have their contents change so that
- something that had either been a true ObjC instance (or had
- looked a lot like one) is changed (possibly by virtue of
- having been deallocated.)</p>
+ arbitrary memory address could look enough like an ObjC
+ instance to fool the lisp runtime system, and it's possible
+ that pointers could have their contents change so that
+ something that had either been a true ObjC instance (or had
+ looked a lot like one) is changed (possibly by virtue of
+ having been deallocated.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">In the first case, w=
e can improve the heuristics
- substantially: we can make stronger assertions that a
- particular pointer is really "of type :ID" when it's a
- parameter to a function declared to take such a pointer as an
- argument or a similarly declared function result; we can be
- more confident of something we obtained via SLOT-VALUE of a
- slot defined to be of type :ID than if we just dug a pointer
- out of memory somewhere.</p>
+ substantially: we can make stronger assertions that a
+ particular pointer is really "of type :ID" when it's a
+ parameter to a function declared to take such a pointer as an
+ argument or a similarly declared function result; we can be
+ more confident of something we obtained via SLOT-VALUE of a
+ slot defined to be of type :ID than if we just dug a pointer
+ out of memory somewhere.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The second case is a=
little more subtle: ObjC memory
- management is based on a reference-counting scheme, and it's
- possible for an object to ... cease to be an object while lisp
- is still referencing it. If we don't want to deal with this
- possibility (and we don't), we'll basically have to ensure
- that the object is not deallocated while lisp is still
- thinking of it as a first-class object. There's some support
- for this in the case of objects created with MAKE-INSTANCE,
- but we may need to give similar treatment to foreign objects
- that are introduced to the lisp runtime in other ways (as
- function arguments, return values, SLOT-VALUE results, etc. as
- well as those instances that are created under lisp
- control.)</p>
+ management is based on a reference-counting scheme, and it's
+ possible for an object to ... cease to be an object while lisp
+ is still referencing it. If we don't want to deal with this
+ possibility (and we don't), we'll basically have to ensure
+ that the object is not deallocated while lisp is still
+ thinking of it as a first-class object. There's some support
+ for this in the case of objects created with MAKE-INSTANCE,
+ but we may need to give similar treatment to foreign objects
+ that are introduced to the lisp runtime in other ways (as
+ function arguments, return values, SLOT-VALUE results, etc. as
+ well as those instances that are created under lisp
+ control.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">This doesn't all wor=
k yet (in fact, not much of it works
- yet); in practice, this has not yet been as much of a problem
- as anticipated, but that may be because existing Cocoa code
- deals primarily with relatively long-lived objects such as
- windows, views, menus, etc.</p>
+ yet); in practice, this has not yet been as much of a problem
+ as anticipated, but that may be because existing Cocoa code
+ deals primarily with relatively long-lived objects such as
+ windows, views, menus, etc.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id529071"></a>16.7.2.=C3=82=
=C2=A0Recommended Reading</h3>
+ <h3 class=3D"title"><a id=3D"id418917"></a>16.7.2.=C3=82=
=C2=A0Recommended Reading</h3>
</div>
</div>
</div>
@@ -19419,27 +19439,27 @@
<dl>
<dt>
<span class=3D"term">
- <a href=3D"http://developer.apple.com/documentation/Cocoa/" target=
=3D"_top">Cocoa Documentation</a>
- </span>
+ <a class=3D"ulink" href=3D"http://developer.apple.com/documenta=
tion/Cocoa/" target=3D"_top">Cocoa Documentation</a>
+ </span>
</dt>
<dd>
<p>
- This is the top page for all of Apple's documentation on
- Cocoa. If you are unfamiliar with Cocoa, it is a good
- place to start.
- </p>
+ This is the top page for all of Apple's documentation on
+ Cocoa. If you are unfamiliar with Cocoa, it is a good
+ place to start.
+ </p>
</dd>
<dt>
<span class=3D"term">
- <a href=3D"http://developer.apple.com/documentation/Cocoa/Reference/F=
oundation/ObjC_classic/index.html" target=3D"_top">Foundation Reference for=
Objective-C</a>
- </span>
+ <a class=3D"ulink" href=3D"http://developer.apple.com/documenta=
tion/Cocoa/Reference/Foundation/ObjC_classic/index.html" target=3D"_top">Fo=
undation Reference for Objective-C</a>
+ </span>
</dt>
<dd>
<p>
- This is one of the two most important Cocoa references; it
- covers all of the basics, except for GUI programming. This is
- a reference, not a tutorial.
- </p>
+ This is one of the two most important Cocoa references; it
+ covers all of the basics, except for GUI programming. This is
+ a reference, not a tutorial.
+ </p>
</dd>
</dl>
</div>
@@ -19517,34 +19537,34 @@
</div>
</div>
</div>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">As it's distributed, C=
lozure CL starts up with *PACKAGE* set
- to the CL-USER package and with most predefined functions and
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">As it's distributed, C=
lozure CL starts up with *PACKAGE* set to
+ the CL-USER package and with most predefined functions and
methods protected against accidental redefinition. The package
- setting is of course a requirement of ANSI CL, while the
- protection protection is intended to catch certain types of
- programming errors (accidentally redefining a CL or CCL
- function) before those errors have a chance to do much
- damage.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">These settings may mak=
e using Clozure CL to develop Clozure CL a
- bit more awkward, since much of that process assumes that the
- CCL package is current (and a primary purpose of that process is
- to redefine some "predefined, builtin functions".) The standard,
- "routine" ways of building Clozure CL from sources (see ) -
- COMPILE-CCL, XCOMPILE-CCL, and XLOAD-LEVEL-0 - bind *PACKAGE* to
- the "CCL" package and enable the redefinition of predefined
- functions; the symbols COMPILE-CCL, XCOMPILE-CCL, and
+ setting is of course a requirement of ANSI CL, and the
+ protection of predifined functions and methods is intended to
+ catch certain types of programming errors (accidentally
+ redefining a CL or CCL function) before those errors have a
+ chance to do much damage.</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">These settings may mak=
e using Clozure CL to develop Clozure CL a bit
+ awkward, because much of that process assumes you are working in
+ the CCL package is current, and a primary purpose of Clozure CL
+ development is to redefine some predefined, builtin functions.
+ The standard, "routine" ways of building Clozure CL from sources (see
+ ) - COMPILE-CCL, XCOMPILE-CCL, and XLOAD-LEVEL-0 - bind
+ *PACKAGE* to the "CCL" package and enable the redefinition of
+ predefined functions; the symbols COMPILE-CCL, XCOMPILE-CCL, and
XLOAD-LEVEL-0 are additionally now exported from the "CCL"
package.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Some other (more ad-ho=
c) ways of doing development on
- Clozure CL - compiling and/or loading individual files,
- incrementally redefining individual functions - may be awkward
- unless one reverts to the mode of operation which was
- traditionally offered in Clozure CL. (Some Clozure CL source files -
+ Clozure CL=C3=A2=C2=80=C2=94compiling and/or loading individual file=
s,
+ incrementally redefining individual functions=C3=A2=C2=80=C2=94may be
+ awkward unless one reverts to the mode of operation which was
+ traditionally offered in Clozure CL. Some Clozure CL source files -
especially those that comprise the bootstrapping image sources
and the first few files in the "cold load" sequence - are
compiled and loaded in the "CCL" package but don't contain
(IN-PACKAGE "CCL") forms, since IN-PACKAGE doesn't work until
- later in the cold load sequence.)</p>
+ later in the cold load sequence.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The somewhat bizarre b=
ehavior of both SET-USER-ENVIRONMENT
and SET-DEVELOPMENT-ENVIRONMENT with respect to the special
variables they affect is intended to allow those constructs to
@@ -19586,24 +19606,24 @@
? (foo -1) ;Oops. Too late ...
Unhandled exception 11 at 0x300e90c8, context->regs at #x7ffff6b8
Continue/Debugger/eXit <enter>?
-</pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">As you may have notice=
d, it's not a perfect world; it's rare
- that the cause (attempting to reference the CDR of -1, and therefo=
re
- accessing unmapped memory near location 0) of this effect (an
- "Unhandled exception ..." message) is so obvious.</p>
+ that the cause (attempting to reference the CDR of -1, and therefore
+ accessing unmapped memory near location 0) of this effect (an
+ "Unhandled exception ..." message) is so obvious.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The addresses printed =
in the message above aren't very useful
- unless you're debugging the kernel with GDB (and they're often
- very useful if you are.)</p>
+ unless you're debugging the kernel with GDB (and they're often
+ very useful if you are.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Aside from causing an =
exception that the lisp kernel doesn't
- know how to handle, one can also enter the kernel debugger (more)
- deliberately:</p>
+ know how to handle, one can also enter the kernel debugger (more)
+ deliberately:</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programlist=
ing">
? (defun classify (n)
- (cond ((> n 0) "Greater")
- ((< n 0) "Less")
- (t
- ;;; Sheesh ! What else could it be ?
- (ccl::bug "I give up. How could this happen ?"))))
+ (cond ((> n 0) "Greater")
+ ((< n 0) "Less")
+ (t
+ ;; Sheesh ! What else could it be ?
+ (ccl::bug "I give up. How could this happen ?"))))
CLASSIFY
=
? (classify 0)
@@ -19611,44 +19631,44 @@
I give up. How could this happen ?
? for help
[12345] Clozure CL kernel debugger:
- </pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">CCL::BUG isn't quite t=
he right tool for this example (a
- call to BREAK or PRINT might do a better job of clearing up the
- mystery), but it's sometimes helpful when those other tools
- can't be used. The lisp error system notices, for instance, if
- attempts to signal errors themselves cause errors to be
- signaled; this sort of thing can happen if CLOS or the I/O
- system are broken or missing. After some small number of
- recursive errors, the error system gives up and calls
- CCL::BUG.</p>
+ call to BREAK or PRINT might do a better job of clearing up the
+ mystery), but it's sometimes helpful when those other tools
+ can't be used. The lisp error system notices, for instance, if
+ attempts to signal errors themselves cause errors to be
+ signaled; this sort of thing can happen if CLOS or the I/O
+ system are broken or missing. After some small number of
+ recursive errors, the error system gives up and calls
+ CCL::BUG.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If one enters a '?' at=
the kernel debugger prompt, one
- will see output like:</p>
+ will see output like:</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programlist=
ing">
(S) Find and describe symbol matching specified name
(B) Show backtrace
(X) Exit from this debugger, asserting that any exception was handled
(K) Kill Clozure CL process
(?) Show this help
- </pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">CCL::BUG just does an =
FF-CALL into the lisp kernel. If
- the kernel debugger was invoked because of an unhandled
- exception (such as an illegal memory reference) the OS kernel
- saves the machine state ("context") in a data structure for us,
- and in that case some additional options can be used to display
- the contents of the registers at the point of the
- exception. Another function - CCL::DBG - causes a special
- exception to be generated and enters the lisp kernel debugger
- with a non-null "context":</p>
+ the kernel debugger was invoked because of an unhandled
+ exception (such as an illegal memory reference) the OS kernel
+ saves the machine state ("context") in a data structure for us,
+ and in that case some additional options can be used to display
+ the contents of the registers at the point of the
+ exception. Another function=C3=A2=C2=80=C2=94CCL::DBG=C3=A2=C2=80=C2=
=94causes a special
+ exception to be generated and enters the lisp kernel debugger
+ with a non-null "context":</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programlist=
ing">
? (defun classify2 (n)
- (cond ((> n 0) "Greater")
- ((< n 0) "Less")
- (t (dbg n))))
+ (cond ((> n 0) "Greater")
+ ((< n 0) "Less")
+ (t (dbg n))))
CLASSIFY2
=
? (classify2 0)
Lisp Breakpoint
- While executing: #<Function CLASSIFY2 #x08476cfe>
+While executing: #<Function CLASSIFY2 #x08476cfe>
? for help
[12345] Clozure CL kernel debugger: ?
(G) Set specified GPR to new value
@@ -19663,11 +19683,11 @@
(P) Propagate the exception to another handler (debugger or OS)
(K) Kill Clozure CL process
(?) Show this help
-</pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">CCL::DBG takes an argu=
ment, whose value is copied into the register
- that Clozure CL uses to return a function's primary value (arg_z, =
which
- is r23 on the PowerPC). If we were to choose the (L) option at thi=
s point,
- we'd see a dislay like:</p>
+ that Clozure CL uses to return a function's primary value (arg_z, wh=
ich
+ is r23 on the PowerPC). If we were to choose the (L) option at this =
point,
+ we'd see a dislay like:</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programlist=
ing">
rnil =3D 0x01836015
nargs =3D 0
@@ -19687,17 +19707,17 @@
r26 (save5) =3D ()
r25 (save6) =3D ()
r24 (save7) =3D ()
- </pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">From this we can concl=
ude that the problematic argument to CLASSIFY2
- was 0 (see r23/arg_z), and that I need to work on a better example=
.</p>
+ was 0 (see r23/arg_z), and that I need to work on a better example.<=
/p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The R option shows the=
values of the ALU (and PPC branch unit)
- registers in hex; the F option shows the values of the FPU registe=
rs.</p>
+ registers in hex; the F option shows the values of the FPU registers=
.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The (B) option shows a=
raw stack backtrace; it'll try to
- identify foreign functions as well as lisp functions. (Foreign fun=
ction
- names are guesses based on the nearest preceding exported symbol.)=
</p>
+ identify foreign functions as well as lisp functions. (Foreign funct=
ion
+ names are guesses based on the nearest preceding exported symbol.)</=
p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">If you ever unexpected=
ly find yourself in the "lisp kernel
- debugger", the output of the (L) and (B) options are often the most
- helpful things to include in a bug report.</p>
+ debugger", the output of the (L) and (B) options are often the most
+ helpful things to include in a bug report.</p>
</div>
<div class=3D"sect1" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage">
@@ -19716,24 +19736,24 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">It's now possible to=
use AltiVec instructions in PPC LAP
- (assembler) functions.</p>
+ (assembler) functions.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The lisp kernel dete=
cts the presence or absence of
- AltiVec and preserves AltiVec state on lisp thread switch and
- in response to exceptions, but the implementation doesn't
- otherwise use vector operations.</p>
+ AltiVec and preserves AltiVec state on lisp thread switch and
+ in response to exceptions, but the implementation doesn't
+ otherwise use vector operations.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">This document doesn'=
t document PPC LAP programming in
- general. Ideally, there would be some document that
- did.</p>
+ general. Ideally, there would be some document that
+ did.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">This document does e=
xplain AltiVec register-usage
- conventions in Clozure CL and explains the use of some lap macros
- that help to enforce those conventions.</p>
+ conventions in Clozure CL and explains the use of some lap macros
+ that help to enforce those conventions.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">All of the global sy=
mbols described below are exported
- from the CCL package. Note that lap macro names, ppc
- instruction names, and (in most cases) register names are
- treated as strings, so this only applies to functions and
- global variable names.</p>
+ from the CCL package. Note that lap macro names, ppc
+ instruction names, and (in most cases) register names are
+ treated as strings, so this only applies to functions and
+ global variable names.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Much of the Clozure =
CL support for AltiVec LAP programming
- is based on work contributed to MCL by Shannon Spires.</p>
+ is based on work contributed to MCL by Shannon Spires.</p>
</div>
<div class=3D"sect2" lang=3D"en" xml:lang=3D"en">
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
@@ -19744,62 +19764,64 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Clozure CL LAP funct=
ions that use AltiVec instructions must
- interoperate with each other and with C functions; that
- suggests that they follow C AltiVec register usage
- conventions. (vr0-vr1 scratch, vr2-vr13 parameters/return
- value, vr14-vr19 temporaries, vr20-vr31 callee-save
- non-volatile registers.)</p>
+ interoperate with each other and with C functions; that fact
+ suggests that they follow C AltiVec register usage
+ conventions. (vr0-vr1 scratch, vr2-vr13 parameters/return
+ value, vr14-vr19 temporaries, vr20-vr31 callee-save
+ non-volatile registers.)</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">The EABI (Embedded A=
pplication Binary Interface) used in
- LinuxPPC doesn't ascribe particular significance to the vrsave
- special-purpose register; on other platforms (notably MacOS),
- it's used as a bitmap which indicates to system-level code
- which vector registers contain meaningful values.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">The WITH-ALTIVEC-REG=
ISTERS lapmacro generates code which
- which saves, updates, and restores VRSAVE on platforms where
- this is required (as indicated by the value of the special
- variable which controls this) and ignores VRSAVE on platforms
- that don't require it to be maintained.</p>
+ LinuxPPC doesn't ascribe particular significance to the vrsave
+ special-purpose register; on other platforms (notably MacOS),
+ it's used as a bitmap which indicates to system-level code
+ which vector registers contain meaningful values.</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">The WITH-ALTIVEC-REG=
ISTERS lap macro generates code that
+ saves, updates, and restores VRSAVE on platforms where this is
+ required (as indicated by the value of the special variable
+ that controls this behavior) and ignores VRSAVE on platforms
+ that don't require it to be maintained.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">On all PPC platforms=
, it's necessary to save any non-volatile
- vector registers (vr20 .. vr31) before assigning to them and to rest=
ore
- such registers before returning to the caller.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">On platforms that re=
quire that VRSAVE be maintained, it's not
- necessary to mention the "use" of vector registers that are
- used as incoming parameters. It's not incorrect to mention their use
- in a WITH-ALTIVEC-REGISTERS form, but it may be unnecessary in many
- interesting cases. One can likewise assume that the caller of any fu=
nction
- that returns a vector value (in vr2 has already set the appropriate =
bit in
- VRSAVE to indicate that this register is live. One could therefore w=
rite a
- leaf function that added the bytes in vr3 and vr2 and returned the r=
esult
- in vr2 as:</p>
+ vector registers (vr20 .. vr31) before assigning to them and to re=
store
+ such registers before returning to the caller.</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">On platforms that re=
quire that VRSAVE be maintained, it's
+ not necessary to mention the "use" of vector registers that
+ are used as incoming parameters. It's not incorrect to mention
+ their use in a WITH-ALTIVEC-REGISTERS form, but it may be
+ unnecessary in many interesting cases. One can likewise assume
+ that the caller of any function that returns a vector value in
+ vr2 has already set the appropriate bit in VRSAVE to indicate
+ that this register is live. One could therefore write a leaf
+ function that added the bytes in vr3 and vr2 and returned the
+ result in vr2 as:</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programli=
sting">
(defppclapfunction vaddubs ((y vr3) (z vr2))
(vaddubs z y z)
(blr))
-</pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">When vector register=
s that aren't incoming parameters are used
- in a LAP function, WITH-ALTIVEC-REGISTERS takes care of maintain=
ing VRSAVE
- and of saving/restoring any non-volatile vector registers:</p>
+ in a LAP function, WITH-ALTIVEC-REGISTERS takes care of maintainin=
g VRSAVE
+ and of saving/restoring any non-volatile vector registers:</p>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"programli=
sting">
(defppclapfunction load-array ((n arg_z))
(check-nargs 1)
(with-altivec-registers (vr1 vr2 vr3 vr27) ; Clobbers imm0
(li imm0 arch::misc-data-offset)
- (lvx vr1 arg_z imm0) ; load MSQ
- (lvsl vr27 arg_z imm0) ; set the permute vector
- (addi imm0 imm0 16) ; address of LSQ
- (lvx vr2 arg_z imm0) ; load LSQ
- (vperm vr3 vr1 vr2 vr27) ; aligned result appears in VR3
- (dbg t)) ; Look at result in some debugger
+ (lvx vr1 arg_z imm0) ; load MSQ
+ (lvsl vr27 arg_z imm0) ; set the permute vector
+ (addi imm0 imm0 16) ; address of LSQ
+ (lvx vr2 arg_z imm0) ; load LSQ
+ (vperm vr3 vr1 vr2 vr27) ; aligned result appears in VR3
+ (dbg t)) ; Look at result in some debugger
(blr))
- </pre>
+ </pre>
<p xmlns=3D"http://www.w3.org/1999/xhtml">AltiVec registers ar=
e not preserved by CATCH and UNWIND-PROTECT.
- Since AltiVec is only accessible from LAP in Clozure CL and sinc=
e LAP
- functions rarely use high- level control structures, this should=
rarely be
- a problem in practice.</p>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">LAP functions which =
use non-volatile vector registers and which call
- (Lisp ?) code which may use CATCH or UNWIND-PROTECT should save =
those
- vector registers before such a call and restore them on return. =
This is
- one of the intended uses of the WITH-VECTOR-BUFFER lap macro.</p>
+ Since AltiVec is only accessible from LAP in Clozure CL and since =
LAP
+ functions rarely use high-level control structures, this should ra=
rely be
+ a problem in practice.</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">LAP functions that u=
se non-volatile vector registers and
+ that call (Lisp ?) code which may use CATCH or UNWIND-PROTECT
+ should save those vector registers before such a call and
+ restore them on return. This is one of the intended uses of
+ the WITH-VECTOR-BUFFER lap macro.</p>
</div>
</div>
<div class=3D"sect1" lang=3D"en" xml:lang=3D"en">
@@ -19822,14 +19844,14 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id469310">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id424347">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">When true, attem=
pts to redefine (via DEFUN or DEFMETHOD)
- functions and methods that are marked as being
- "predefined" signal continuable errors.</p>
+ functions and methods that are marked as being
+ "predefined" signal continuable errors.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Note that these =
are CERRORs, not warnings, and that
- no lisp functions or methods have been defined in the kernel
- in MCL or Clozure CL since 1987 or so.</p>
+ no lisp functions or methods have been defined in the kernel
+ in MCL or Clozure CL since 1987 or so.</p>
</div>
</div>
</p>
@@ -19838,23 +19860,23 @@
<a id=3D"f_set-development-environment"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">set-development-environment</strong></span>
- <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&=
;optional</em>
- unmark-builtin-functions</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>set-development-environment</strong></span>
+ <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&o=
ptional</em>
+ unmark-builtin-functions</code>
</div>
<div class=3D"refentrytitle"></div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id528030">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id408862">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Arranges that th=
e outermost special bindings of *PACKAGE*
- and *WARN-IF-REDEFINE-KERNEL* restore values of the "CCL"
- package and NIL to these variables, respectively. If the optional
- argument is true, marks all globally defined functions and methods
- as being "not predefined" (this is a fairly expensive
- operation.)</p>
+ and *WARN-IF-REDEFINE-KERNEL* restore values of the "CCL"
+ package and NIL to these variables, respectively. If the optional
+ argument is true, marks all globally defined functions and methods
+ as being "not predefined" (this is a fairly expensive
+ operation.)</p>
</div>
</div>
</p>
@@ -19863,22 +19885,22 @@
<a id=3D"f_set-user-environment"></a>
<strong>[Function]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">set-user-environment</strong></span>
- <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&=
;optional</em> mark-builtin-functions</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>set-user-environment</strong></span>
+ <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname">&o=
ptional</em> mark-builtin-functions</code>
</div>
<div class=3D"refentrytitle"></div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id426372">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417395">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Arranges that th=
e outermost special bindings of *PACKAGE*
- and *WARN-IF-REDEFINE-KERNEL* restore values of the
- "CL-USER" package and T to these variables, respectively.
- If the optional argument is true, marks all globally defined
- functions and methods as being "predefined" (this is a
- fairly expensive operation.)</p>
+ and *WARN-IF-REDEFINE-KERNEL* restore values of the
+ "CL-USER" package and T to these variables, respectively.
+ If the optional argument is true, marks all globally defined
+ functions and methods as being "predefined" (this is a
+ fairly expensive operation.)</p>
</div>
</div>
</p>
@@ -19894,12 +19916,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id518558">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417440">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">This variable is=
initialized each time an Clozure CL session
- starts based on information provided by the lisp kernel. Its value
- is true if AltiVec is present and false otherwise. This variable
- shouldn't be set by user code.</p>
+ starts based on information provided by the lisp kernel. Its value
+ is true if AltiVec is present and false otherwise. This variable
+ shouldn't be set by user code.</p>
</div>
</div>
</p>
@@ -19909,8 +19931,8 @@
<strong>[Function]</strong>
<br></br>
<code>
- <span xmlns=3D"http://www.w3.org/1999/xhtml">
- <strong class=3D"function">altivec-available-p</strong>
+ <span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"func=
tion">
+ <strong>altivec-available-p</strong>
</span>
</code>
</div>
@@ -19919,7 +19941,7 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id429384">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417498">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns non-NIL =
if AltiVec is available.</p>
</div>
@@ -19937,12 +19959,12 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id490739">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417641">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Intended to cont=
rol the expansion of certain lap macros.
- Initialized to NIL on LinuxPPC; initialized to T on platforms
- (such as MacOS X/Darwin) that require that the VRSAVE SPR contain
- a bitmask of active vector registers at all times.</p>
+ Initialized to NIL on LinuxPPC; initialized to T on platforms
+ (such as MacOS X/Darwin) that require that the VRSAVE SPR contain
+ a bitmask of active vector registers at all times.</p>
</div>
</div>
</p>
@@ -19951,31 +19973,31 @@
<a id=3D"lapm_with-altivec-registers"></a>
<strong>[LAP Macro]</strong>
<br></br>
- <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong c=
lass=3D"function">with-altivec-registers</strong></span>
- reglist <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varna=
me">&body</em> body</code>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"=
function"><strong>with-altivec-registers</strong></span>
+ reglist <em xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"varname=
">&body</em> body</code>
</div>
<div class=3D"refentrytitle"></div>
</p>
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id430110">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417705">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">reglist</span></i>---A list of vector register names (vr0 .. vr31=
).</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">body</span></i>---A sequence of PPC LAP instructions.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id470124">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417746">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Specifies the se=
t of AltiVec registers used in body. If
- *altivec-lapmacros-maintain-vrsave-p* is true when the macro is
- expanded, generates code to save the VRSAVE SPR and updates VRSAVE
- to include a bitmask generated from the specified register list.
- Generates code which saves any non-volatile vector registers which
- appear in the register list, executes body, and restores the saved
- non-volatile vector registers (and, if
- *altivec-lapmacros-maintain-vrsave-p* is true, restores VRSAVE as
- well. Uses the IMM0 register (r3) as a temporary.</p>
+ *altivec-lapmacros-maintain-vrsave-p* is true when the macro is
+ expanded, generates code to save the VRSAVE SPR and updates VRSAVE
+ to include a bitmask generated from the specified register list.
+ Generates code which saves any non-volatile vector registers which
+ appear in the register list, executes body, and restores the saved
+ non-volatile vector registers (and, if
+ *altivec-lapmacros-maintain-vrsave-p* is true, restores VRSAVE as
+ well. Uses the IMM0 register (r3) as a temporary.</p>
</div>
</div>
</p>
@@ -19991,24 +20013,24 @@
<p>
<div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id470977">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id427200">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">base</span></i>---Any available general-purpose register.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">n</span></i>---An integer between 1 and 254, inclusive. (Should
- typically be much, much closer to 1.) Specifies the size of
- the buffer, in 16-byte units.</p>
+ typically be much, much closer to 1.) Specifies the size of
+ the buffer, in 16-byte units.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">body</span></i>---A sequence of PPC LAP instructions.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id449788">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id427258">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Generates code w=
hich allocates a 16-byte aligned buffer
- large enough to contain N vector registers; the GPR base points to
- the lowest address of this buffer. After processing body, the
- buffer will be deallocated. The body should preserve the value of
- base as long as it needs to reference the buffer. It's
- intended that base be used as a base register in stvx and lvx
- instructions within the body.</p>
+ large enough to contain N vector registers; the GPR base points to
+ the lowest address of this buffer. After processing body, the
+ buffer will be deallocated. The body should preserve the value of
+ base as long as it needs to reference the buffer. It's
+ intended that base be used as a base register in stvx and lvx
+ instructions within the body.</p>
</div>
</div>
</p>
@@ -20029,7 +20051,7 @@
<dd>
<p>A specially-structured directory that Mac OS X
recognizes as a
- launchable <a href=3D"#Cocoa"><em class=3D"glossterm">Cocoa</em></a>
+ launchable <a class=3D"glossterm" href=3D"#Cocoa"><em class=3D"glossterm=
">Cocoa</em></a>
application. Graphical applications on Mac OS X are
represented as application bundles.</p>
</dd>
@@ -20081,7 +20103,7 @@
<p>A text editor, written in Common Lisp, similar in
features to Emacs. Hemlock was originally developed as part of
CMU Common Lisp. A portable version of Hemlock is built into
- the Clozure CL <a href=3D"#IDE"><em class=3D"glossterm">IDE</em></a>.</p>
+ the Clozure CL <a class=3D"glossterm" href=3D"#IDE"><em class=3D"glosste=
rm">IDE</em></a>.</p>
</dd>
</dl>
</div>
@@ -20091,7 +20113,7 @@
<dt><a id=3D"IDE"></a>IDE</dt>
<dd>
<p>"Integrated Development Environment". In the context of
- Clozure CL, "the IDE" refers to the experimental <a href=3D"#Cocoa"><em =
class=3D"glossterm">Cocoa</em></a>
+ Clozure CL, "the IDE" refers to the experimental <a class=3D"glossterm" =
href=3D"#Cocoa"><em class=3D"glossterm">Cocoa</em></a>
windowing development environment provided in source form with
Clozure CL distributions.</p>
</dd>
@@ -20101,15 +20123,15 @@
functions, data structures, variables, and so on. Also, a file
containing archived versions of these data in a format that
can be loaded and reconstituted by the
- Lisp <a href=3D"#lisp_kernel"><em class=3D"glossterm">kernel</em></a>. A
+ Lisp <a class=3D"glossterm" href=3D"#lisp_kernel"><em class=3D"glossterm=
">kernel</em></a>. A
working Clozure CL system consists of the kernel and
- an <a href=3D"#lisp_image"><em class=3D"glossterm">image</em></a>.</p>
+ an <a class=3D"glossterm" href=3D"#lisp_image"><em class=3D"glossterm">i=
mage</em></a>.</p>
</dd>
<dt><a id=3D"InterfaceBuilder"></a>InterfaceBuilder</dt>
<dd>
<p>An application supplied by Apple with their developer
tools that can be used to interactively build user-interface
- elements for <a href=3D"#Cocoa"><em class=3D"glossterm">Cocoa</em></a>
+ elements for <a class=3D"glossterm" href=3D"#Cocoa"><em class=3D"glosste=
rm">Cocoa</em></a>
applications.</p>
</dd>
</dl>
@@ -20122,7 +20144,7 @@
<p>The binary executable program that implements the lowest
levels of the Lisp system. A working Clozure CL system consists of
the kernel and
- an <a href=3D"#lisp_image"><em class=3D"glossterm">image</em></a>.</p>
+ an <a class=3D"glossterm" href=3D"#lisp_image"><em class=3D"glossterm">i=
mage</em></a>.</p>
</dd>
</dl>
</div>
@@ -20131,10 +20153,10 @@
<dl>
<dt><a id=3D"listener_window"></a>listener window</dt>
<dd>
- <p>In the <a href=3D"#IDE"><em class=3D"glossterm">IDE</em><=
/a>,
- a <a href=3D"#Cocoa"><em class=3D"glossterm">Cocoa</em></a>
+ <p>In the <a class=3D"glossterm" href=3D"#IDE"><em class=3D"=
glossterm">IDE</em></a>,
+ a <a class=3D"glossterm" href=3D"#Cocoa"><em class=3D"glossterm">Cocoa</=
em></a>
window that contains a pseudo-terminal session that
- communicates with a Lisp <a href=3D"#REPL"><em class=3D"glossterm">REPL<=
/em></a>.</p>
+ communicates with a Lisp <a class=3D"glossterm" href=3D"#REPL"><em class=
=3D"glossterm">REPL</em></a>.</p>
</dd>
</dl>
</div>
@@ -20160,12 +20182,12 @@
<dt><a id=3D"nibfile"></a>nibfile</dt>
<dd>
<p>A data file created by
- Apple's <a href=3D"#InterfaceBuilder"><em class=3D"glossterm">InterfaceB=
uilder</em></a>
+ Apple's <a class=3D"glossterm" href=3D"#InterfaceBuilder"><em class=3D"g=
lossterm">InterfaceBuilder</em></a>
application, which contains archived Objective-C objects that
define user-interface elements for
- a <a href=3D"#Cocoa"><em class=3D"glossterm">Cocoa</em></a>
+ a <a class=3D"glossterm" href=3D"#Cocoa"><em class=3D"glossterm">Cocoa</=
em></a>
application. Under Mac OS
- X, <a href=3D"#Cocoa"><em class=3D"glossterm">Cocoa</em></a> applications
+ X, <a class=3D"glossterm" href=3D"#Cocoa"><em class=3D"glossterm">Cocoa<=
/em></a> applications
typically create their user interface elements by reading
nibfiles and unarchiving the objects in them.</p>
</dd>
@@ -20217,7 +20239,7 @@
<dd>
<p>The function executed by Lisp automatically once its
startup is complete. Clozure CL's default toplevel is the
- interactive <a href=3D"#REPL"><em class=3D"glossterm">read-eval-print
+ interactive <a class=3D"glossterm" href=3D"#REPL"><em class=3D"glossterm=
">read-eval-print
loop</em></a> that you normally use to interact with
Lisp. You can, however, replace the toplevel with a function
of your own design, changing Clozure CL from a Lisp development
@@ -20228,7 +20250,7 @@
<p>An expression that denotes a type. Type specifiers may
be symbols (such as <code class=3D"code">CONS</code>
and <code class=3D"code">STRING</code>), or they may be more complex
- <a href=3D"#s-expression"><em class=3D"glossterm">S-expressions</em></a>
+ <a class=3D"glossterm" href=3D"#s-expression"><em class=3D"glossterm">S-=
expressions</em></a>
(such as (UNSIGNED-BYTE 8)).</p>
</dd>
</dl>
@@ -20246,271 +20268,271 @@
<div class=3D"indexdiv">
<h3>Symbols</h3>
<dl>
- <dt>#$, <a href=3D"#rm_sharpsign-dollarsign">Reader Macro #$=
</a></dt>
- <dt>#&, <a href=3D"#rm_sharpsign-ampersand">Reader Macro=
#&</a></dt>
- <dt>#/, <a href=3D"#rm_sharpsign-slash">Reader Macro #/</a><=
/dt>
- <dt>#>, <a href=3D"#rm_sharpsign-greaterthan">Reader Macr=
o #></a></dt>
- <dt>#_, <a href=3D"#rm_sharpsign-underscore">Reader Macro #_=
</a></dt>
- <dt>%ff-call, <a href=3D"#f_Pff-call">Function %FF-CALL</a><=
/dt>
- <dt>%reference-external-entry-point, <a href=3D"#f_Preferenc=
e-external-entry-point">Function %REFERENCE-EXTERNAL-ENTRY-POINT</a></dt>
- <dt>*alternate-line-terminator*, <a href=3D"#v_alternate-lin=
e-terminator">Variable CCL:*ALTERNATE-LINE-TERMINATOR*</a></dt>
- <dt>*altivec-available*, <a href=3D"#v_altivec-available">Va=
riable *ALTIVEC-AVAILABLE*</a></dt>
- <dt>*altivec-lapmacros-maintain-vrsave-p*, <a href=3D"#v_alt=
ivec-lapmacros-maintain-vrsave-p">Variable *ALTIVEC-LAPMACROS-MAINTAIN-VRSA=
VE-P*</a></dt>
- <dt>*current-process*, <a href=3D"#v_current-process">Variab=
le *CURRENT-PROCESS*</a></dt>
- <dt>*default-external-format*, <a href=3D"#v_default-externa=
l-format">Variable CCL:*DEFAULT-EXTERNAL-FORMAT*</a></dt>
- <dt>*ticks-per-second*, <a href=3D"#v_ticks-per-second">Vari=
able *TICKS-PER-SECOND*</a></dt>
- <dt>*warn-if-redefine-kernel, <a href=3D"#v_warn-if-redefine=
-kernel">Variable *WARN-IF-REDEFINE-KERNEL*</a></dt>
- <dt>+NULL-PTR+, <a href=3D"#Saving-Applications">Saving Appl=
ications</a></dt>
- <dt>:external-format, <a href=3D"#k_external-format">Keyword=
Argument :EXTERNAL-FORMAT</a></dt>
- <dt>:y, <a href=3D"#cmd_y">Toplevel Command :Y</a></dt>
- <dt>@class, <a href=3D"#m_class">Macro CCL::@CLASS</a></dt>
- <dt>@selector, <a href=3D"#m_selector">Macro CCL::@SELECTOR<=
/a></dt>
- <dt>[fn-name], <a href=3D"#f_describe-character-encodings">F=
unction DESCRIBE-CHARACTER-ENCODINGS</a></dt>
+ <dt>#$, <a class=3D"indexterm" href=3D"#rm_sharpsign-dollars=
ign">Reader Macro #$</a></dt>
+ <dt>#&, <a class=3D"indexterm" href=3D"#rm_sharpsign-amp=
ersand">Reader Macro #&</a></dt>
+ <dt>#/, <a class=3D"indexterm" href=3D"#rm_sharpsign-slash">=
Reader Macro #/</a></dt>
+ <dt>#>, <a class=3D"indexterm" href=3D"#rm_sharpsign-grea=
terthan">Reader Macro #></a></dt>
+ <dt>#_, <a class=3D"indexterm" href=3D"#rm_sharpsign-undersc=
ore">Reader Macro #_</a></dt>
+ <dt>%ff-call, <a class=3D"indexterm" href=3D"#f_Pff-call">Fu=
nction %FF-CALL</a></dt>
+ <dt>%reference-external-entry-point, <a class=3D"indexterm" =
href=3D"#f_Preference-external-entry-point">Function %REFERENCE-EXTERNAL-EN=
TRY-POINT</a></dt>
+ <dt>*alternate-line-terminator*, <a class=3D"indexterm" href=
=3D"#v_alternate-line-terminator">Variable CCL:*ALTERNATE-LINE-TERMINATOR*<=
/a></dt>
+ <dt>*altivec-available*, <a class=3D"indexterm" href=3D"#v_a=
ltivec-available">Variable *ALTIVEC-AVAILABLE*</a></dt>
+ <dt>*altivec-lapmacros-maintain-vrsave-p*, <a class=3D"index=
term" href=3D"#v_altivec-lapmacros-maintain-vrsave-p">Variable *ALTIVEC-LAP=
MACROS-MAINTAIN-VRSAVE-P*</a></dt>
+ <dt>*current-process*, <a class=3D"indexterm" href=3D"#v_cur=
rent-process">Variable *CURRENT-PROCESS*</a></dt>
+ <dt>*default-external-format*, <a class=3D"indexterm" href=
=3D"#v_default-external-format">Variable CCL:*DEFAULT-EXTERNAL-FORMAT*</a><=
/dt>
+ <dt>*ticks-per-second*, <a class=3D"indexterm" href=3D"#v_ti=
cks-per-second">Variable *TICKS-PER-SECOND*</a></dt>
+ <dt>*warn-if-redefine-kernel, <a class=3D"indexterm" href=3D=
"#v_warn-if-redefine-kernel">Variable *WARN-IF-REDEFINE-KERNEL*</a></dt>
+ <dt>+NULL-PTR+, <a class=3D"indexterm" href=3D"#Saving-Appli=
cations">Saving Applications</a></dt>
+ <dt>:external-format, <a class=3D"indexterm" href=3D"#k_exte=
rnal-format">Keyword Argument :EXTERNAL-FORMAT</a></dt>
+ <dt>:y, <a class=3D"indexterm" href=3D"#cmd_y">Toplevel Comm=
and :Y</a></dt>
+ <dt>@class, <a class=3D"indexterm" href=3D"#m_class">Macro C=
CL::@CLASS</a></dt>
+ <dt>@selector, <a class=3D"indexterm" href=3D"#m_selector">M=
acro CCL::@SELECTOR</a></dt>
+ <dt>[fn-name], <a class=3D"indexterm" href=3D"#f_describe-ch=
aracter-encodings">Function DESCRIBE-CHARACTER-ENCODINGS</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3></h3>
<dl>
- <dt>, <a href=3D"#trace">Trace</a>, <a href=3D"#map-file-to-=
ivector">Memory-mapped Files</a>, <a href=3D"#defstatic">Static Variables</=
a>, <a href=3D"#save-application">Saving Applications</a>, <a href=3D"#buil=
d-application">The Application Builder</a></dt>
+ <dt>, <a class=3D"indexterm" href=3D"#trace">Trace</a>, <a c=
lass=3D"indexterm" href=3D"#map-file-to-ivector">Memory-mapped Files</a>, <=
a class=3D"indexterm" href=3D"#defstatic">Static Variables</a>, <a class=3D=
"indexterm" href=3D"#save-application">Saving Applications</a>, <a class=3D=
"indexterm" href=3D"#build-application">The Application Builder</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>A</h3>
<dl>
- <dt>accept-connection, <a href=3D"#f_accept-connection">Func=
tion ACCEPT-CONNECTION</a></dt>
- <dt>all-processes, <a href=3D"#f_all-processes">Function ALL=
-PROCESSES</a></dt>
- <dt>altivec-available-p, <a href=3D"#f_altivec-available-p">=
Function ALTIVEC-AVAILABLE-P</a></dt>
+ <dt>accept-connection, <a class=3D"indexterm" href=3D"#f_acc=
ept-connection">Function ACCEPT-CONNECTION</a></dt>
+ <dt>all-processes, <a class=3D"indexterm" href=3D"#f_all-pro=
cesses">Function ALL-PROCESSES</a></dt>
+ <dt>altivec-available-p, <a class=3D"indexterm" href=3D"#f_a=
ltivec-available-p">Function ALTIVEC-AVAILABLE-P</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>B</h3>
<dl>
<dt>bootstrapping
- image, <a href=3D"#building-definitions">Building Definitions</a></d=
t>
+ image, <a class=3D"indexterm" href=3D"#building-definitions">Bui=
lding Definitions</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>C</h3>
<dl>
- <dt>CCL Logical Host, <a href=3D"#Predefined-Logical-Hosts">=
Predefined Logical Hosts</a></dt>
- <dt>close, <a href=3D"#o_close">Method CLOSE</a></dt>
- <dt>close-shared-library, <a href=3D"#f_close-shared-library=
">Function CLOSE-SHARED-LIBRARY</a></dt>
- <dt>communication-deadline-expired, <a href=3D"#Stream-Timeo=
uts-And-Deadlines">Stream Timeouts and Deadlines</a></dt>
- <dt>configure-gcc, <a href=3D"#f_configure-gcc">Function CON=
FIGURE-GCC</a></dt>
- <dt>current-directory-name, <a href=3D"#f_current-directory-=
name">Function CCL::CURRENT-DIRECTORY-NAME</a></dt>
+ <dt>CCL Logical Host, <a class=3D"indexterm" href=3D"#Predef=
ined-Logical-Hosts">Predefined Logical Hosts</a></dt>
+ <dt>close, <a class=3D"indexterm" href=3D"#o_close">Method C=
LOSE</a></dt>
+ <dt>close-shared-library, <a class=3D"indexterm" href=3D"#f_=
close-shared-library">Function CLOSE-SHARED-LIBRARY</a></dt>
+ <dt>communication-deadline-expired, <a class=3D"indexterm" h=
ref=3D"#Stream-Timeouts-And-Deadlines">Stream Timeouts and Deadlines</a></d=
t>
+ <dt>configure-gcc, <a class=3D"indexterm" href=3D"#f_configu=
re-gcc">Function CONFIGURE-GCC</a></dt>
+ <dt>current-directory-name, <a class=3D"indexterm" href=3D"#=
f_current-directory-name">Function CCL::CURRENT-DIRECTORY-NAME</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>D</h3>
<dl>
- <dt>def-foreign-type, <a href=3D"#m_def-foreign-type">Macro =
DEF-FOREIGN-TYPE</a></dt>
- <dt>defcallback, <a href=3D"#m_defcallback">Macro DEFCALLBAC=
K</a></dt>
- <dt>define-objc-class-method, <a href=3D"#m_define-objc-clas=
s-method">Macro CCL::DEFINE-OBJC-CLASS-METHOD</a></dt>
- <dt>define-objc-method, <a href=3D"#m_define-objc-method">Ma=
cro CCL::DEFINE-OBJC-METHOD</a></dt>
- <dt>dotted-to-ipaddr, <a href=3D"#f_dotted-to-ipaddr">Functi=
on DOTTED-TO-IPADDR</a></dt>
+ <dt>def-foreign-type, <a class=3D"indexterm" href=3D"#m_def-=
foreign-type">Macro DEF-FOREIGN-TYPE</a></dt>
+ <dt>defcallback, <a class=3D"indexterm" href=3D"#m_defcallba=
ck">Macro DEFCALLBACK</a></dt>
+ <dt>define-objc-class-method, <a class=3D"indexterm" href=3D=
"#m_define-objc-class-method">Macro CCL::DEFINE-OBJC-CLASS-METHOD</a></dt>
+ <dt>define-objc-method, <a class=3D"indexterm" href=3D"#m_de=
fine-objc-method">Macro CCL::DEFINE-OBJC-METHOD</a></dt>
+ <dt>dotted-to-ipaddr, <a class=3D"indexterm" href=3D"#f_dott=
ed-to-ipaddr">Function DOTTED-TO-IPADDR</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>E</h3>
<dl>
- <dt>egc, <a href=3D"#f_egc">Function EGC</a></dt>
- <dt>egc-active-p, <a href=3D"#f_egc-active-p">Function EGC-A=
CTIVE-P</a></dt>
- <dt>egc-configuration, <a href=3D"#f_egc-configuration">Func=
tion EGC-CONFIGURATION</a></dt>
- <dt>egc-enabled-p, <a href=3D"#f_egc-enabled-p">Function EGC=
-ENABLED-P</a></dt>
- <dt>external, <a href=3D"#m_external">Macro EXTERNAL</a></dt>
- <dt>external-call, <a href=3D"#m_external-call">Macro EXTERN=
AL-CALL</a></dt>
- <dt>external-process-error-stream, <a href=3D"#f_external-pr=
ocess-error-stream">Function EXTERNAL-PROCESS-ERROR-STREAM</a></dt>
- <dt>external-process-id, <a href=3D"#f_external-process-id">=
Function EXTERNAL-PROCESS-ID</a></dt>
- <dt>external-process-input-stream, <a href=3D"#f_external-pr=
ocess-input-stream">Function EXTERNAL-PROCESS-INPUT-STREAM</a></dt>
- <dt>external-process-output-stream, <a href=3D"#f_external-p=
rocess-output-stream">Function EXTERNAL-PROCESS-OUTPUT-STREAM</a></dt>
- <dt>external-process-status, <a href=3D"#f_external-process-=
status">Function EXTERNAL-PROCESS-STATUS</a></dt>
+ <dt>egc, <a class=3D"indexterm" href=3D"#f_egc">Function EGC=
</a></dt>
+ <dt>egc-active-p, <a class=3D"indexterm" href=3D"#f_egc-acti=
ve-p">Function EGC-ACTIVE-P</a></dt>
+ <dt>egc-configuration, <a class=3D"indexterm" href=3D"#f_egc=
-configuration">Function EGC-CONFIGURATION</a></dt>
+ <dt>egc-enabled-p, <a class=3D"indexterm" href=3D"#f_egc-ena=
bled-p">Function EGC-ENABLED-P</a></dt>
+ <dt>external, <a class=3D"indexterm" href=3D"#m_external">Ma=
cro EXTERNAL</a></dt>
+ <dt>external-call, <a class=3D"indexterm" href=3D"#m_externa=
l-call">Macro EXTERNAL-CALL</a></dt>
+ <dt>external-process-error-stream, <a class=3D"indexterm" hr=
ef=3D"#f_external-process-error-stream">Function EXTERNAL-PROCESS-ERROR-STR=
EAM</a></dt>
+ <dt>external-process-id, <a class=3D"indexterm" href=3D"#f_e=
xternal-process-id">Function EXTERNAL-PROCESS-ID</a></dt>
+ <dt>external-process-input-stream, <a class=3D"indexterm" hr=
ef=3D"#f_external-process-input-stream">Function EXTERNAL-PROCESS-INPUT-STR=
EAM</a></dt>
+ <dt>external-process-output-stream, <a class=3D"indexterm" h=
ref=3D"#f_external-process-output-stream">Function EXTERNAL-PROCESS-OUTPUT-=
STREAM</a></dt>
+ <dt>external-process-status, <a class=3D"indexterm" href=3D"=
#f_external-process-status">Function EXTERNAL-PROCESS-STATUS</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>F</h3>
<dl>
<dt>fasl
- files, <a href=3D"#building-definitions">Building Definitions</a></d=
t>
- <dt>ff-call, <a href=3D"#m_ff-call">Macro FF-CALL</a></dt>
- <dt>foreign-symbol-address, <a href=3D"#f_foreign-symbol-add=
ress">Function FOREIGN-SYMBOL-ADDRESS</a></dt>
- <dt>foreign-symbol-entry, <a href=3D"#f_foreign-symbol-entry=
">Function FOREIGN-SYMBOL-ENTRY</a></dt>
- <dt>free, <a href=3D"#f_free">Function FREE</a></dt>
+ files, <a class=3D"indexterm" href=3D"#building-definitions">Bui=
lding Definitions</a></dt>
+ <dt>ff-call, <a class=3D"indexterm" href=3D"#m_ff-call">Macr=
o FF-CALL</a></dt>
+ <dt>foreign-symbol-address, <a class=3D"indexterm" href=3D"#=
f_foreign-symbol-address">Function FOREIGN-SYMBOL-ADDRESS</a></dt>
+ <dt>foreign-symbol-entry, <a class=3D"indexterm" href=3D"#f_=
foreign-symbol-entry">Function FOREIGN-SYMBOL-ENTRY</a></dt>
+ <dt>free, <a class=3D"indexterm" href=3D"#f_free">Function F=
REE</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>G</h3>
<dl>
- <dt>gc-retain-pages, <a href=3D"#f_gc-retain-pages">Function=
GC-RETAIN-PAGES</a></dt>
- <dt>gc-retaining-pages, <a href=3D"#f_gc-retaining-pages">Fu=
nction GC-RETAINING-PAGES</a></dt>
- <dt>get-user-home-dir, <a href=3D"#f_get-user-home-dir">Func=
tion CCL::GET-USER-HOME-DIR</a></dt>
- <dt>getenv, <a href=3D"#f_getenv">Function CCL::GETENV</a></=
dt>
- <dt>getpid, <a href=3D"#f_getpid">Function CCL::GETPID</a></=
dt>
- <dt>getuid, <a href=3D"#f_getuid">Function CCL::GETUID</a></=
dt>
- <dt>grab-lock, <a href=3D"#f_grab-lock">Function GRAB-LOCK</=
a></dt>
+ <dt>gc-retain-pages, <a class=3D"indexterm" href=3D"#f_gc-re=
tain-pages">Function GC-RETAIN-PAGES</a></dt>
+ <dt>gc-retaining-pages, <a class=3D"indexterm" href=3D"#f_gc=
-retaining-pages">Function GC-RETAINING-PAGES</a></dt>
+ <dt>get-user-home-dir, <a class=3D"indexterm" href=3D"#f_get=
-user-home-dir">Function CCL::GET-USER-HOME-DIR</a></dt>
+ <dt>getenv, <a class=3D"indexterm" href=3D"#f_getenv">Functi=
on CCL::GETENV</a></dt>
+ <dt>getpid, <a class=3D"indexterm" href=3D"#f_getpid">Functi=
on CCL::GETPID</a></dt>
+ <dt>getuid, <a class=3D"indexterm" href=3D"#f_getuid">Functi=
on CCL::GETUID</a></dt>
+ <dt>grab-lock, <a class=3D"indexterm" href=3D"#f_grab-lock">=
Function GRAB-LOCK</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>H</h3>
<dl>
<dt>heap
- image, <a href=3D"#building-definitions">Building Definitions</a></d=
t>
+ image, <a class=3D"indexterm" href=3D"#building-definitions">Bui=
lding Definitions</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>I</h3>
<dl>
- <dt>input-timeout, <a href=3D"#Stream-Timeouts-And-Deadlines=
">Stream Timeouts and Deadlines</a></dt>
- <dt>ipaddr-to-dotted, <a href=3D"#f_ipaddr-to-dotted">Functi=
on IPADDR-TO-DOTTED</a></dt>
- <dt>ipaddr-to-hostname, <a href=3D"#f_ipaddr-to-hostname">Fu=
nction IPADDR-TO-HOSTNAME</a></dt>
+ <dt>input-timeout, <a class=3D"indexterm" href=3D"#Stream-Ti=
meouts-And-Deadlines">Stream Timeouts and Deadlines</a></dt>
+ <dt>ipaddr-to-dotted, <a class=3D"indexterm" href=3D"#f_ipad=
dr-to-dotted">Function IPADDR-TO-DOTTED</a></dt>
+ <dt>ipaddr-to-hostname, <a class=3D"indexterm" href=3D"#f_ip=
addr-to-hostname">Function IPADDR-TO-HOSTNAME</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>K</h3>
<dl>
- <dt>kernel build directory, <a href=3D"#building-definitions=
">Building Definitions</a></dt>
+ <dt>kernel build directory, <a class=3D"indexterm" href=3D"#=
building-definitions">Building Definitions</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>L</h3>
<dl>
<dt>lisp
- kernel, <a href=3D"#building-definitions">Building Definitions</a></=
dt>
- <dt>lisp-heap-gc-threshold, <a href=3D"#f_lisp-heap-gc-thres=
hold">Function LISP-HEAP-GC-THRESHOLD</a></dt>
- <dt>local-host, <a href=3D"#f_local-host">Function LOCAL-HOS=
T</a></dt>
- <dt>local-port, <a href=3D"#f_local-port">Function LOCAL-POR=
T</a></dt>
- <dt>lookup-hostname, <a href=3D"#f_lookup-hostname">Function=
LOOKUP-HOSTNAME</a></dt>
- <dt>lookup-port, <a href=3D"#f_lookup-port">Function LOOKUP-=
PORT</a></dt>
+ kernel, <a class=3D"indexterm" href=3D"#building-definitions">Bu=
ilding Definitions</a></dt>
+ <dt>lisp-heap-gc-threshold, <a class=3D"indexterm" href=3D"#=
f_lisp-heap-gc-threshold">Function LISP-HEAP-GC-THRESHOLD</a></dt>
+ <dt>local-host, <a class=3D"indexterm" href=3D"#f_local-host=
">Function LOCAL-HOST</a></dt>
+ <dt>local-port, <a class=3D"indexterm" href=3D"#f_local-port=
">Function LOCAL-PORT</a></dt>
+ <dt>lookup-hostname, <a class=3D"indexterm" href=3D"#f_looku=
p-hostname">Function LOOKUP-HOSTNAME</a></dt>
+ <dt>lookup-port, <a class=3D"indexterm" href=3D"#f_lookup-po=
rt">Function LOOKUP-PORT</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>M</h3>
<dl>
- <dt>make-external-format, <a href=3D"#f_make-external-format=
">Function MAKE-EXTERNAL-FORMAT</a></dt>
- <dt>make-gcable-record, <a href=3D"#m_make-record">Macro MAK=
E-RECORD</a></dt>
- <dt>make-lock, <a href=3D"#f_make-lock">Function MAKE-LOCK</=
a></dt>
- <dt>make-process, <a href=3D"#f_make-process">Function MAKE-=
PROCESS</a></dt>
- <dt>make-read-write-lock, <a href=3D"#f_make-read-write-lock=
">Function MAKE-READ-WRITE-LOCK</a></dt>
- <dt>make-record, <a href=3D"#m_make-record">Macro MAKE-RECOR=
D</a></dt>
- <dt>make-semaphore, <a href=3D"#f_make-semaphore">Function M=
AKE-SEMAPHORE</a></dt>
- <dt>make-socket, <a href=3D"#f_make-socket">Function MAKE-SO=
CKET</a></dt>
+ <dt>make-external-format, <a class=3D"indexterm" href=3D"#f_=
make-external-format">Function MAKE-EXTERNAL-FORMAT</a></dt>
+ <dt>make-gcable-record, <a class=3D"indexterm" href=3D"#m_ma=
ke-record">Macro MAKE-RECORD</a></dt>
+ <dt>make-lock, <a class=3D"indexterm" href=3D"#f_make-lock">=
Function MAKE-LOCK</a></dt>
+ <dt>make-process, <a class=3D"indexterm" href=3D"#f_make-pro=
cess">Function MAKE-PROCESS</a></dt>
+ <dt>make-read-write-lock, <a class=3D"indexterm" href=3D"#f_=
make-read-write-lock">Function MAKE-READ-WRITE-LOCK</a></dt>
+ <dt>make-record, <a class=3D"indexterm" href=3D"#m_make-reco=
rd">Macro MAKE-RECORD</a></dt>
+ <dt>make-semaphore, <a class=3D"indexterm" href=3D"#f_make-s=
emaphore">Function MAKE-SEMAPHORE</a></dt>
+ <dt>make-socket, <a class=3D"indexterm" href=3D"#f_make-sock=
et">Function MAKE-SOCKET</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>N</h3>
<dl>
- <dt>note-open-file-stream, <a href=3D"#f_note-open-file-stre=
am">Function NOTE-OPEN-FILE-STREAM</a></dt>
- <dt>ns-lisp-string, <a href=3D"#c_ns-lisp-string">Class CCL:=
:NS-LISP-STRING</a></dt>
+ <dt>note-open-file-stream, <a class=3D"indexterm" href=3D"#f=
_note-open-file-stream">Function NOTE-OPEN-FILE-STREAM</a></dt>
+ <dt>ns-lisp-string, <a class=3D"indexterm" href=3D"#c_ns-lis=
p-string">Class CCL::NS-LISP-STRING</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>O</h3>
<dl>
- <dt>objc:defmethod, <a href=3D"#m_objc-defmethod">Macro objc=
:defmethod</a></dt>
- <dt>open-file-streams, <a href=3D"#f_open-file-streams">Func=
tion OPEN-FILE-STREAMS</a></dt>
- <dt>open-shared-library, <a href=3D"#f_open-shared-library">=
Function OPEN-SHARED-LIBRARY</a></dt>
- <dt>os-command, <a href=3D"#f_os-command">Function CCL::OS-C=
OMMAND</a></dt>
- <dt>output-timeout, <a href=3D"#Stream-Timeouts-And-Deadline=
s">Stream Timeouts and Deadlines</a></dt>
+ <dt>objc:defmethod, <a class=3D"indexterm" href=3D"#m_objc-d=
efmethod">Macro objc:defmethod</a></dt>
+ <dt>open-file-streams, <a class=3D"indexterm" href=3D"#f_ope=
n-file-streams">Function OPEN-FILE-STREAMS</a></dt>
+ <dt>open-shared-library, <a class=3D"indexterm" href=3D"#f_o=
pen-shared-library">Function OPEN-SHARED-LIBRARY</a></dt>
+ <dt>os-command, <a class=3D"indexterm" href=3D"#f_os-command=
">Function CCL::OS-COMMAND</a></dt>
+ <dt>output-timeout, <a class=3D"indexterm" href=3D"#Stream-T=
imeouts-And-Deadlines">Stream Timeouts and Deadlines</a></dt>
</dl>
</div>
<div class=3D"indexdiv">
<h3>P</h3>
<dl>
- <dt>pref, <a href=3D"#m_pref">Macro PREF</a></dt>
- <dt>process-abort, <a href=3D"#f_process-abort">Function PRO=
CESS-ABORT</a></dt>
- <dt>process-allow-schedule, <a href=3D"#f_process-allow-sche=
dule">Function PROCESS-ALLOW-SCHEDULE</a></dt>
- <dt>process-enable, <a href=3D"#f_process-enable">Function P=
ROCESS-ENABLE</a></dt>
- <dt>process-input-wait, <a href=3D"#f_process-input-wait">Fu=
nction PROCESS-INPUT-WAIT</a></dt>
- <dt>process-interrupt, <a href=3D"#f_process-interrupt">Func=
tion PROCESS-INTERRUPT</a></dt>
- <dt>process-kill, <a href=3D"#f_process-kill">Function PROCE=
SS-KILL</a></dt>
- <dt>process-output-wait, <a href=3D"#f_process-output-wait">=
Function PROCESS-OUTPUT-WAIT</a></dt>
- <dt>process-preset, <a href=3D"#f_process-preset">Function P=
ROCESS-PRESET</a></dt>
- <dt>process-reset, <a href=3D"#f_process-reset">Function PRO=
CESS-RESET</a></dt>
- <dt>process-resume, <a href=3D"#f_process-resume">Function P=
ROCESS-RESUME</a></dt>
- <dt>process-run-function, <a href=3D"#f_process-run-function=
">Function PROCESS-RUN-FUNCTION</a></dt>
- <dt>process-suspend, <a href=3D"#f_process-suspend">Function=
PROCESS-SUSPEND</a></dt>
- <dt>process-suspend-count, <a href=3D"#f_process-suspend-cou=
nt">Function PROCESS-SUSPEND-COUNT</a></dt>
- <dt>process-wait, <a href=3D"#f_process-wait">Function PROCE=
SS-WAIT</a></dt>
- <dt>process-wait-with-timeout, <a href=3D"#f_process-wait-wi=
th-timeout">Function PROCESS-WAIT-WITH-TIMEOUT</a></dt>
- <dt>process-whostate, <a href=3D"#f_process-whostate">Functi=
on PROCESS-WHOSTATE</a></dt>
+ <dt>pref, <a class=3D"indexterm" href=3D"#m_pref">Macro PREF=
</a></dt>
+ <dt>process-abort, <a class=3D"indexterm" href=3D"#f_process=
-abort">Function PROCESS-ABORT</a></dt>
+ <dt>process-allow-schedule, <a class=3D"indexterm" href=3D"#=
f_process-allow-schedule">Function PROCESS-ALLOW-SCHEDULE</a></dt>
+ <dt>process-enable, <a class=3D"indexterm" href=3D"#f_proces=
s-enable">Function PROCESS-ENABLE</a></dt>
+ <dt>process-input-wait, <a class=3D"indexterm" href=3D"#f_pr=
ocess-input-wait">Function PROCESS-INPUT-WAIT</a></dt>
+ <dt>process-interrupt, <a class=3D"indexterm" href=3D"#f_pro=
cess-interrupt">Function PROCESS-INTERRUPT</a></dt>
+ <dt>process-kill, <a class=3D"indexterm" href=3D"#f_process-=
kill">Function PROCESS-KILL</a></dt>
+ <dt>process-output-wait, <a class=3D"indexterm" href=3D"#f_p=
rocess-output-wait">Function PROCESS-OUTPUT-WAIT</a></dt>
+ <dt>process-preset, <a class=3D"indexterm" href=3D"#f_proces=
s-preset">Function PROCESS-PRESET</a></dt>
+ <dt>process-reset, <a class=3D"indexterm" href=3D"#f_process=
-reset">Function PROCESS-RESET</a></dt>
+ <dt>process-resume, <a class=3D"indexterm" href=3D"#f_proces=
s-resume">Function PROCESS-RESUME</a></dt>
+ <dt>process-run-function, <a class=3D"indexterm" href=3D"#f_=
process-run-function">Function PROCESS-RUN-FUNCTION</a></dt>
+ <dt>process-suspend, <a class=3D"indexterm" href=3D"#f_proce=
ss-suspend">Function PROCESS-SUSPEND</a></dt>
+ <dt>process-suspend-count, <a class=3D