[Openmcl-cvs-notifications] r13105 - /trunk/source/doc/ccl-documentation.html
gb at clozure.com
gb at clozure.com
Tue Oct 27 13:00:15 EDT 2009
Author: gb
Date: Tue Oct 27 13:00:15 2009
New Revision: 13105
Log:
updated
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 Tue Oct 27 13:00:15 2009
@@ -157,6 +157,11 @@
<dt>
<span class=3D"sect1">
<a href=3D"#floating-point">4.8. Floating Point Numbers<=
/a>
+ </span>
+ </dt>
+ <dt>
+ <span class=3D"sect1">
+ <a href=3D"#watched-objects">4.9. Watched Objects</a>
</span>
</dt>
</dl>
@@ -418,7 +423,7 @@
</dt>
<dt>
<span class=3D"sect1">
- <a href=3D"#id416155">12.12. The Foreign-Function-Interf=
ace Dictionary</a>
+ <a href=3D"#id416724">12.12. The Foreign-Function-Interf=
ace Dictionary</a>
</span>
</dt>
</dl>
@@ -2737,6 +2742,40 @@
<a href=3D"#floating-point">4.8. Floating Point Numbers</a>
</span>
</dt>
+ <dt>
+ <span class=3D"sect1">
+ <a href=3D"#watched-objects">4.9. Watched Objects</a>
+ </span>
+ </dt>
+ <dd>
+ <dl>
+ <dt>
+ <span class=3D"sect2">
+ <a href=3D"#watched-watch">4.9.1. WATCH</a>
+ </span>
+ </dt>
+ <dt>
+ <span class=3D"sect2">
+ <a href=3D"#watched-unwatch">4.9.2. UNWATCH</a>
+ </span>
+ </dt>
+ <dt>
+ <span class=3D"sect2">
+ <a href=3D"#watched-write-to-watched-object">4.9.3. WR=
ITE-TO-WATCHED-OBJECT</a>
+ </span>
+ </dt>
+ <dt>
+ <span class=3D"sect2">
+ <a href=3D"#watch-notes">4.9.4. Notes</a>
+ </span>
+ </dt>
+ <dt>
+ <span class=3D"sect2">
+ <a href=3D"#watch-examples">4.9.5. Examples</a>
+ </span>
+ </dt>
+ </dl>
+ </dd>
</dl>
</div>
<div class=3D"sect1" lang=3D"en" xml:lang=3D"en">
@@ -3215,17 +3254,17 @@
</dl>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id369069" class=3D"indexterm"></a>
+ <a id=3D"id369615" 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>
</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"id369096" class=3D"indexterm"></a>
+ <a id=3D"id369640" 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>
</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"id369125" class=3D"indexterm"></a>
+ <a id=3D"id369670" 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>
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
@@ -3233,7 +3272,7 @@
<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"id369174" class=3D"indexterm"></a>
+ <a id=3D"id388116" 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>
</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
@@ -3241,7 +3280,7 @@
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"id369208" class=3D"indexterm"></a>
+ <a id=3D"id388146" 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>
</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
@@ -3249,7 +3288,7 @@
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"id369243" class=3D"indexterm"></a>
+ <a id=3D"id388177" 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>
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">By default, this is ni=
l. If non-nil it should be a integer,
@@ -3373,7 +3412,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"id388103=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id388582=
"></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
@@ -3407,7 +3446,7 @@
<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"id388260=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id388739=
"></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
@@ -3575,7 +3614,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id388563"></a>4.3.4.1.=C3=
=82=C2=A0Encoding Problems</h4>
+ <h4 class=3D"title"><a id=3D"id389042"></a>4.3.4.1.=C3=
=82=C2=A0Encoding Problems</h4>
</div>
</div>
</div>
@@ -3591,7 +3630,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id388576"></a>4.3.4.2.=C3=
=82=C2=A0Byte Order Marks</h4>
+ <h4 class=3D"title"><a id=3D"id389054"></a>4.3.4.2.=C3=
=82=C2=A0Byte Order Marks</h4>
</div>
</div>
</div>
@@ -3619,7 +3658,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id388610"></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"id389089"></a>4.3.4.3.=C3=
=82=C2=A0<span><strong class=3D"function">DESCRIBE-CHARACTER-ENCODINGS</str=
ong></span></h4>
</div>
</div>
</div>
@@ -3641,7 +3680,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"id3886=
72"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id3891=
50"></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
@@ -3650,7 +3689,7 @@
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"id3886=
87"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id3891=
65"></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>
</div>
@@ -4081,7 +4120,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id389366"></a>4.3.4.5.=C3=
=82=C2=A0Encoding and Decoding Strings</h4>
+ <h4 class=3D"title"><a id=3D"id389844"></a>4.3.4.5.=C3=
=82=C2=A0Encoding and Decoding Strings</h4>
</div>
</div>
</div>
@@ -4106,7 +4145,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"id3894=
41"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id3899=
20"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Returns the number of characters that would be produced by
@@ -4137,7 +4176,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"id3895=
36"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id3900=
15"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Decodes the octets in <em class=3D"varname">vector</em> (or the subseq=
uence
@@ -4180,7 +4219,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"id3896=
60"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id3901=
39"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Encodes <em class=3D"varname">string</em> (or the substring delimited =
by
@@ -4226,7 +4265,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"id3897=
79"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id3902=
58"></a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Returns the number of octets required to encode
@@ -4276,7 +4315,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"id389868" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id390346" 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,
@@ -4380,7 +4419,7 @@
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"id390051" class=3D"indexterm"></a>
+ <a id=3D"id390530" 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>
<em class=3D"parameter"><code>pathname</code></em>
<em class=3D"parameter"><code>element-type</code></em>
@@ -4440,7 +4479,7 @@
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"id390184" class=3D"indexterm"></a>
+ <a id=3D"id390662" class=3D"indexterm"></a>
<span><strong class=3D"command"><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>
@@ -4452,7 +4491,7 @@
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"id390219" class=3D"indexterm"></a>
+ <a id=3D"id390698" 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>
<em class=3D"parameter"><code>pathname</code></em>
[Function]</strong></span>
@@ -4462,7 +4501,7 @@
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"id390251" class=3D"indexterm"></a>
+ <a id=3D"id390730" 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>
<em class=3D"parameter"><code>displaced-array</code></em>
[Function]</strong></span>
@@ -4501,7 +4540,7 @@
access to a special variable that has not been declared
static.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id390326" class=3D"indexterm"></a>
+ <a id=3D"id390804" class=3D"indexterm"></a>
<span><strong class=3D"command"><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>
@@ -4555,7 +4594,7 @@
</div>
</div>
</div>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id390438" class=
=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id390916" 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>
@@ -4635,7 +4674,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"id390660" class=
=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id391138" 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
@@ -4646,7 +4685,7 @@
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"id390707" class=3D"indexterm"></a>
+ <a id=3D"id391185" class=3D"indexterm"></a>
<span><strong class=3D"command"><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>
@@ -4783,7 +4822,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"id390992">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id391471">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">mode</span></i>---
One of the keywords :rounding-mode, :overflow,
@@ -4791,7 +4830,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"id391016">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id391494">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
If <em class=3D"varname">mode</em> is supplied, returns the value of
@@ -4830,7 +4869,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"id391111">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id391590">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">rounding-mode</span></i>---
If supplied, must be one of :nearest, :zero, :positive, or
@@ -4839,7 +4878,7 @@
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">overflow, underflow, division-by-zero, invalid, inexact</span></i=
>---NIL to mask the exception, T to signal it.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id391147">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id391626">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Sets the current thread's exception-enable and rounding-mode
@@ -4850,6 +4889,437 @@
</div>
</div>
</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">
+ <div>
+ <div>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"watched=
-objects"></a>4.9.=C3=82=C2=A0Watched Objects</h2>
+ </div>
+ </div>
+ </div>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ As of release 1.4, Clozure CL provides a way for lisp objects to
+ be watched so that a condition will be signaled when a thread
+ attempts to write to the watched object. For a certain class of
+ bugs (someone is changing this value, but I don't know who), this
+ can be extremely helpful.
+ </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"watched-watch"></a>4.9.1.=
=C3=82=C2=A0WATCH</h3>
+ </div>
+ </div>
+ </div>
+ <p>
+ <div class=3D"refentrytitle">
+ <a id=3D"f_watch"></a>
+ <strong>[Function]</strong>
+ <br></br>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong=
class=3D"function">watch</strong></span> <em xmlns=3D"http://www.w3.org/19=
99/xhtml" class=3D"varname">&optional</em> object</code>
+ </div>
+ <div class=3D"refentrytitle">
+ Monitor a lisp object for writes.
+ </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"id391701=
"></a>
+ <div class=3D"header">Arguments and Values:</div>
+ <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">object</span></i>---
+ Any memory-allocated lisp object.
+ </p>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id391723=
"></a>
+ <div class=3D"header">Description:</div>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ The WATCH function arranges for the specified object to be
+ monitored for writes. This is accomplished by copying the
+ object to its own set of virtual memory pages, which are then
+ write-protected. This protection is enforced by the computer's
+ memory-management hardware; the write-protection does not slow
+ down reads at all.
+ </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ When any write to the object is attempted, a
+ WRITE-TO-WATCHED-OBJECT condition will be signaled.
+ </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ When called with no arguments, WATCH returns a freshly-consed
+ list of the objects currently being watched.
+ </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ WATCH returns NIL if the object cannot be watched (typically
+ because the object is in a static or pure memory area).
+ </p>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"watch-dw=
im"></a>
+ <div class=3D"header">DWIM:</div>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ WATCH operates at a fairly low level; it is not possible to
+ avoid the details of the internal representation of objects.
+ Nevertheless, as a convenience, WATCHing a standard-instance,
+ a hash-table, or a multi-dimensional or non-simple CL array
+ will watch the underlying slot-vector, hash-table-vector, or
+ data-vector, respectively.
+ </p>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"watch-di=
scuss"></a>
+ <div class=3D"header">Discussion:</div>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ WATCH can monitor any memory-allocated lisp object.
+ </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ In Clozure CL, a memory-allocated object is either a cons cell
+ or a uvector.
+ </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ WATCH operates on cons cells, not lists. In order to watch a
+ chain of cons cells, each cons cell must be watched
+ individually. Because each watched cons cell takes up its own
+ own virtual memory page (4 Kbytes), it's only feasible to watch
+ relatively short lists.
+ </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ If a memory-allocated object isn't a cons cell, then it is a
+ vector-like object called a uvector. A uvector is a
+ memory-allocated lisp object whose first word is a header that
+ describes the object's type and the number of elements that it
+ contains.
+ </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ So, a hash table is a uvector, as is a string, a standard
+ instance, a double-float, a CL array or vector, and so forth.
+ </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ Some CL objects, like strings and other simple vectors, map in a
+ straightforward way onto the uvector representation. It is easy
+ to understand what happens in such cases. The uvector index
+ corresponds directly to the vector index:
+ </p>
+ <pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"pro=
gramlisting">
+
+? (defvar *s* "xxxxx")
+*S*
+? (watch *s*)
+"xxxxx"
+? (setf (char *s* 3) #\o)
+> Error: Write to watched uvector "xxxxx" at index 3
+> Faulting instruction: (movl (% eax) (@ -5 (% r15) (% rcx)))
+> While executing: SET-CHAR, in process listener(1).
+> Type :POP to abort, :R for a list of available restarts.
+> Type :? for other options.
+
+ </pre>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ In the case of more complicated objects (e.g., a hash-table, a
+ standard-instance, a package, etc.), the elements of the uvector
+ are like slots in a structure. It's necessary to know which one
+ of those "slots" contains the data that will be changed when the
+ object is written to.
+ </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ As mentioned above, watch knows about arrays, hash-tables, and
+ standard-instances, and will automatically watch the appropriate
+ data-containing element.
+ </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ An example might make this clearer.
+ </p>
+ <pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"pro=
gramlisting">
+
+? (defclass foo ()
+ (slot-a slot-b slot-c))
+#<STANDARD-CLASS FOO>
+? (defvar *a-foo* (make-instance 'foo))
+*A-FOO*
+? (watch *a-foo*)
+#<SLOT-VECTOR #xDB00D>
+;;; Note that WATCH has watched the internal slot-vector object
+? (setf (slot-value *a-foo* 'slot-a) 'foo)
+> Error: Write to watched uvector #<SLOT-VECTOR #xDB00D> at index=
1
+> Faulting instruction: (movq (% rsi) (@ -5 (% r8) (% rdi)))
+> While executing: %MAYBE-STD-SETF-SLOT-VALUE-USING-CLASS, in process l=
istener(1).
+> Type :POP to abort, :R for a list of available restarts.
+> Type :? for other options.
+
+ </pre>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ Looking at a backtrace would presumably show what object and
+ slot name were written.
+ </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ Note that even though the write was to slot-a, the uvector index
+ was 1 (not 0). This is because the first element of a
+ slot-vector is a pointer to the instance that owns the slots. We
+ can retrieve that to look at the object that was modified:
+ </p>
+ <pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"pro=
gramlisting">
+
+1 > (uvref (write-to-watched-object-object *break-condition*) 0)
+#<FOO #x30004113502D>
+1 > (describe *)
+#<FOO #x30004113502D>
+Class: #<STANDARD-CLASS FOO>
+Wrapper: #<CLASS-WRAPPER FOO #x300041135EBD>
+Instance slots
+SLOT-A: #<Unbound>
+SLOT-B: #<Unbound>
+SLOT-C: #<Unbound>
+1 >
+ =
+ </pre>
+ </div>
+ </div>
+ </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"watched-unwatch"></a>4.9.2.=
=C3=82=C2=A0UNWATCH</h3>
+ </div>
+ </div>
+ </div>
+ <p>
+ <div class=3D"refentrytitle">
+ <a id=3D"f_unwatch"></a>
+ <strong>[Function]</strong>
+ <br></br>
+ <code><span xmlns=3D"http://www.w3.org/1999/xhtml"><strong=
class=3D"function">unwatch</strong></span> object</code>
+ </div>
+ <div class=3D"refentrytitle">
+ Stop monitoring a lisp object for writes.
+ </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"id391898=
"></a>
+ <div class=3D"header">Description:</div>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ The UNWATCH function ensures that the specified object is in
+ normal, non-monitored memory. If the object is not currently
+ being watched, UNWATCH does nothing and returns NIL. Otherwise,
+ the newly unwatched object is returned.
+ </p>
+ </div>
+ </div>
+ </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"watched-write-to-watched-ob=
ject"></a>4.9.3.=C3=82=C2=A0WRITE-TO-WATCHED-OBJECT</h3>
+ </div>
+ </div>
+ </div>
+ <p>
+ <div class=3D"refentrytitle">
+ <a id=3D"c_write-to-watched-object"></a>
+ <strong>[Condition]</strong>
+ <br></br>
+ <code>WRITE-TO-WATCHED-OBJECT</code>
+ </div>
+ <div class=3D"refentrytitle">
+ Condition signaled when a write to a watched object is attempted.
+ </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"id391946=
"></a>
+ <div class=3D"header">Discussion:</div>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ This condition is signaled when a watched object is written
+ to. There are three slots of interest:
+ </p>
+ <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">object</span></i>---
+ The actual object that was the destination of the write.
+ </p>
+ <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">offset</span></i>---
+ The byte offset from the tagged object pointer to the
+ address of the write.
+ </p>
+ <p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">instruction</span></i>---
+ The disassembled machine instruction that attempted the write.
+ </p>
+ </div>
+ <div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id392000=
"></a>
+ <div class=3D"header">Restarts:</div>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ A few restarts are provided: one will skip over the faulting
+ write instruction and proceed; another offers to unwatch the
+ object and continue.
+ </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ There is also an emulate restart. In some common cases, the
+ faulting write instruction can be emulated, enabling the write
+ to be performed without having to unwatch the object (and
+ therefore let other threads potentially write to it). If the
+ faulting instruction isn't recognized, the emulate restart will
+ not be offered.
+ </p>
+ </div>
+ </div>
+ </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"watch-notes"></a>4.9.4.=C3=
=82=C2=A0Notes</h3>
+ </div>
+ </div>
+ </div>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ Although some care has been taken to minimize potential problems
+ arising from watching and unwatching objects from multiple
+ threads, there may well be subtle race conditions present that
+ could cause bad behavior.
+</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ For example, suppose that a thread attempts to write to a watched
+ object. This causes the operating system to generate an
+ exception. The lisp kernel figures out what the exception is, and
+ calls back into lisp to signal the write-to-watched-object
+ condition and perhaps handle the error.
+</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ Now, as soon lisp code starts running again (for the callback),
+ it's possible that some other thread could unwatch the very
+ watched object that caused the exception, perhaps before we even
+ have a chance to signal the condition, much less respond to it.
+</p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ Having the object unwatched out from underneath a handler may at
+ least confuse it, if not cause deeper trouble. Use caution with
+ unwatch.
+</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"watch-examples"></a>4.9.5.=
=C3=82=C2=A0Examples</h3>
+ </div>
+ </div>
+ </div>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ Here are a couple more examples in addition to the above examples
+ of watching a string and a standard-instance.
+</p>
+ <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"id392057"></a>4.9.5.1.=C3=
=82=C2=A0Fancy arrays</h4>
+ </div>
+ </div>
+ </div>
+ <pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"program=
listing">
+? (defvar *f* (make-array '(2 3) :element-type 'double-float))
+*F*
+? (watch *f*)
+#(0.0D0 0.0D0 0.0D0 0.0D0 0.0D0 0.0D0)
+;;; Note that the above vector is the underlying data-vector for the array
+? (setf (aref *f* 1 2) pi)
+> Error: Write to watched uvector #<VECTOR 6 type DOUBLE-FLOAT, simp=
le> at index 5
+> Faulting instruction: (movq (% rax) (@ -5 (% r8) (% rdi)))
+> While executing: ASET, in process listener(1).
+> Type :POP to abort, :R for a list of available restarts.
+> Type :? for other options.
+1 > =
+ </pre>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ In this case, uvector index in the report is the row-major index
+ of the element that was written to.
+ </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"id392076"></a>4.9.5.2.=C3=
=82=C2=A0Hash tables</h4>
+ </div>
+ </div>
+ </div>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ Hash tables are surprisingly complicated. The representation of a
+ hash table includes an element called a hash-table-vector. The
+ keys and values of the elements are stored pairwise in this
+ vector.
+ </p>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ One problem with trying to monitor hash tables for writes is that
+ the underlying hash-table-vector is replaced with an entirely new
+ one when the hash table is rehashed. A previously-watched
+ hash-table-vector will not be the used by the hash table after
+ rehashing, and writes to the new vector will not be caught.
+ </p>
+ <pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"program=
listing">
+? (defvar *h* (make-hash-table))
+*H*
+? (setf (gethash 'noise *h*) 'feep)
+FEEP
+? (watch *h*)
+#<HASH-TABLE-VECTOR #xDD00D>
+;;; underlying hash-table-vector
+? (setf (gethash 'noise *h*) 'ding)
+> Error: Write to watched uvector #<HASH-TABLE-VECTOR #xDD00D> at=
index 35
+> Faulting instruction: (lock)
+> (cmpxchgq (% rsi) (@ (% r8) (% rdx)))
+> While executing: %STORE-NODE-CONDITIONAL, in process listener(1).
+> Type :POP to abort, :R for a list of available restarts.
+> Type :? for other options.
+;;; see what value is being replaced...
+1 > (uvref (write-to-watched-object-object *break-condition*) 35)
+FEEP
+;;; backtrace shows useful context
+1 > :b
+*(1A109F8) : 0 (%STORE-NODE-CONDITIONAL ???) NIL
+ (1A10A50) : 1 (LOCK-FREE-PUTHASH NOISE #<HASH-TABLE :TEST EQL size 1/6=
0 #x30004117D47D> DING) 653
+ (1A10AC8) : 2 (CALL-CHECK-REGS PUTHASH NOISE #<HASH-TABLE :TEST EQL si=
ze 1/60 #x30004117D47D> DING) 229
+ (1A10B00) : 3 (TOPLEVEL-EVAL (SETF (GETHASH # *H*) 'DING) NIL) 709
+ ...
+ </pre>
+ </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"id392106"></a>4.9.5.3.=C3=
=82=C2=A0Lists</h4>
+ </div>
+ </div>
+ </div>
+ <p xmlns=3D"http://www.w3.org/1999/xhtml">
+ As previously mentioned, WATCH only watches individual cons cells.
+ </p>
+ <pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"program=
listing">
+? (defun watch-list (list)
+ (maplist #'watch list))
+WATCH-LIST
+? (defvar *l* (list 1 2 3))
+*L*
+? (watch-list *l*)
+((1 2 3) (2 3) (3))
+? (setf (nth 2 *l*) 'foo)
+> Error: Write to the CAR of watched cons cell (3)
+> Faulting instruction: (movq (% rsi) (@ 5 (% rdi)))
+> While executing: %SETNTH, in process listener(1).
+> Type :POP to abort, :R for a list of available restarts.
+> Type :? for other options.
+ </pre>
+ </div>
+ </div>
</div>
</div>
<div xmlns=3D"http://www.w3.org/TR/xhtml1/transitional" class=3D"cha=
pter" lang=3D"en" xml:lang=3D"en">
@@ -5069,7 +5539,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id340588"></a>5.4.2.1.=C3=
=82=C2=A0Checking for Updates</h4>
+ <h4 class=3D"title"><a id=3D"id356785"></a>5.4.2.1.=C3=
=82=C2=A0Checking for Updates</h4>
</div>
</div>
</div>
@@ -5201,7 +5671,7 @@
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"id349515" class=3D"indexterm"></a>
+ <a id=3D"id375070" 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>
(<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>)
@@ -5501,7 +5971,7 @@
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id375682">6.3.2. As of August 2003:</a>
+ <a href=3D"#id374946">6.3.2. As of August 2003:</a>
</span>
</dt>
</dl>
@@ -5752,7 +6222,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id375682"></a>6.3.2.=C3=82=
=C2=A0 As of August 2003:</h3>
+ <h3 class=3D"title"><a id=3D"id374946"></a>6.3.2.=C3=82=
=C2=A0 As of August 2003:</h3>
</div>
</div>
</div>
@@ -6204,13 +6674,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"id386196">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id385765">=
</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"id386221">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id385791">=
</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
@@ -6222,7 +6692,7 @@
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"id386236">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id385806">=
</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*">
@@ -6250,7 +6720,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"id386306">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id385875">=
</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
@@ -6289,7 +6759,7 @@
<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"id386493">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386063">=
</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
@@ -6310,7 +6780,7 @@
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"id386545">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386115">=
</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>
</div>
@@ -6329,7 +6799,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"id386624">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386193">=
</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
@@ -6339,7 +6809,7 @@
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"id386678">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386247">=
</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
@@ -6361,12 +6831,12 @@
did.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386733">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386302">=
</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"id386758">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386327">=
</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>.
@@ -6392,7 +6862,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"id386840">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386409">=
</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
@@ -6403,7 +6873,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"id386893">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386463">=
</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
@@ -6414,12 +6884,12 @@
<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"id386924">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386494">=
</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"id386949">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386519">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
This was previously called PROCESS-ENABLE;
@@ -6445,7 +6915,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"id387014">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386584">=
</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"
@@ -6455,7 +6925,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"id387068">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386637">=
</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
is one which has not yet been reversed by a call to
@@ -6470,7 +6940,7 @@
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"id387118">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386688">=
</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>
</div>
@@ -6491,7 +6961,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"id387195">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386764">=
</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
@@ -6502,7 +6972,7 @@
<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"id387270">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386840">=
</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>
@@ -6516,7 +6986,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"id387314">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386885">=
</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>
</div>
@@ -6537,7 +7007,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"id387397">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id386967">=
</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
@@ -6546,7 +7016,7 @@
<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"id387459">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387029">=
</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
@@ -6563,12 +7033,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"id387508">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387078">=
</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"id387539">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387109">=
</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>
@@ -6589,7 +7059,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"id387654">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387224">=
</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>
@@ -6611,7 +7081,7 @@
<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"id387843">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387413">=
</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>,
@@ -6624,7 +7094,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"id387878">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387448">=
</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>
</div>
@@ -6645,7 +7115,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"id387961">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387532">=
</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.
@@ -6658,7 +7128,7 @@
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"id388054">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387624">=
</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
@@ -6689,7 +7159,7 @@
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"id397745">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387699">=
</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">
@@ -6698,7 +7168,7 @@
</span>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id397762">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387718">=
</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.
@@ -6728,24 +7198,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"id397820">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387784">=
</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"id397830">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387796">=
</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"id397840">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387807">=
</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"id397851">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387819">=
</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">
@@ -6769,14 +7239,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"id397912">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387890">=
</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>---an internal argument, must be nil.</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"id397960">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id387947">=
</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 and enter a state where it can be
@@ -6803,7 +7273,7 @@
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"id398022">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id388015">=
</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>
</div>
@@ -6823,20 +7293,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"id398086">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id388088">=
</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"id398121">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398709">=
</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"id398136">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398724">=
</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>
</div>
@@ -6858,13 +7328,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"id398208">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398796">=
</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"id398243">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398831">=
</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>
@@ -6878,7 +7348,7 @@
<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"id398298">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398886">=
</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>
</div>
@@ -6897,19 +7367,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"id398349">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398937">=
</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"id398359">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398947">=
</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"id398370">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398958">=
</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
@@ -6917,7 +7387,7 @@
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"id398381">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398969">=
</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">
@@ -6941,7 +7411,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"id398472">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399060">=
</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
@@ -6955,12 +7425,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"id398510">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399098">=
</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"id398537">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399125">=
</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>
@@ -6984,7 +7454,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"id398588">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399176">=
</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
@@ -6993,12 +7463,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"id398600">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399188">=
</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"id398643">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399231">=
</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
@@ -7021,7 +7491,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"id398699">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399287">=
</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>
@@ -7034,7 +7504,7 @@
<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"id398769">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399357">=
</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
@@ -7051,7 +7521,7 @@
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"id398801">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399389">=
</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>
</div>
@@ -7071,7 +7541,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"id398896">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399484">=
</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>
@@ -7089,7 +7559,7 @@
<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"id398996">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399584">=
</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.
@@ -7106,7 +7576,7 @@
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"id399040">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399628">=
</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>
</div>
@@ -7126,14 +7596,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"id399143">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399731">=
</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"id399182">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399770">=
</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>
@@ -7148,7 +7618,7 @@
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"id399210">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399798">=
</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">
@@ -7172,7 +7642,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"id399272">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399860">=
</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
@@ -7182,7 +7652,7 @@
<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"id399319">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399907">=
</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.
@@ -7192,7 +7662,7 @@
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"id399333">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id399921">=
</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>
</div>
@@ -7212,7 +7682,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"id399437">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400025">=
</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>
@@ -7220,7 +7690,7 @@
<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"id399488">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400076">=
</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
@@ -7231,7 +7701,7 @@
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"id399517">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400105">=
</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>
</div>
@@ -7250,12 +7720,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"id399617">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400205">=
</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"id399640">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400228">=
</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>
@@ -7266,7 +7736,7 @@
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"id399673">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400261">=
</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>
</div>
@@ -7284,12 +7754,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"id399772">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400360">=
</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"id399795">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400383">=
</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>
@@ -7302,7 +7772,7 @@
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"id399828">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400416">=
</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>
</div>
@@ -7321,14 +7791,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"id399928">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400516">=
</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"id399967">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400555">=
</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
@@ -7341,7 +7811,7 @@
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"id399990">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400578">=
</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>
</div>
@@ -7361,13 +7831,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"id400090">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400678">=
</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"id400113">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400701">=
</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
@@ -7378,12 +7848,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"id400129">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400717">=
</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"id400177">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400765">=
</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
@@ -7406,7 +7876,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"id400234">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400822">=
</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>
@@ -7415,7 +7885,7 @@
<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"id400285">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400873">=
</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,
@@ -7429,7 +7899,7 @@
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"id400325">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id400913">=
</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>
</div>
@@ -7449,7 +7919,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"id400418">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401006">=
</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>
@@ -7458,7 +7928,7 @@
<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"id400469">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401057">=
</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>,
@@ -7473,7 +7943,7 @@
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"id400514">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401102">=
</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>
</div>
@@ -7493,12 +7963,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"id400604">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401192">=
</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"id400626">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401214">=
</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
@@ -7507,7 +7977,7 @@
<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"id400641">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401229">=
</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>
</div>
@@ -7527,26 +7997,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"id400736">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401324">=
</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"id400772">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401360">=
</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"id400786">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401374">=
</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"id400839">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401427">=
</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
@@ -7569,14 +8039,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"id400899">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401487">=
</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"id400935">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401523">=
</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
@@ -7584,12 +8054,12 @@
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"id400949">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401537">=
</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"id401003">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401591">=
</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
@@ -7613,7 +8083,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"id401063">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401651">=
</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
@@ -7626,7 +8096,7 @@
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"id401129">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401717">=
</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
@@ -7635,7 +8105,7 @@
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"id401146">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401734">=
</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>
</div>
@@ -7655,7 +8125,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"id401239">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401827">=
</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
@@ -7663,7 +8133,7 @@
<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"id401281">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401869">=
</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
@@ -7679,12 +8149,12 @@
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"id401314">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401902">=
</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"id401351">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id401939">=
</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,
@@ -7709,7 +8179,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"id401416">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402004">=
</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
@@ -7717,7 +8187,7 @@
<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"id401458">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402046">=
</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.
@@ -7730,12 +8200,12 @@
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"id401491">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402079">=
</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"id401528">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402116">=
</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,
@@ -7760,14 +8230,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"id401593">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402181">=
</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"id401631">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402219">=
</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
@@ -7775,7 +8245,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"id401648">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402236">=
</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>
</div>
@@ -7794,17 +8264,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"id401732">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402313">=
</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"id401743">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402323">=
</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"id401754">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402332">=
</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*;
@@ -7816,7 +8286,7 @@
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"id401770">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402346">=
</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>
</div>
@@ -7835,7 +8305,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"id401873">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402437">=
</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
@@ -7844,7 +8314,7 @@
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"id401918">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402476">=
</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
@@ -7855,7 +8325,7 @@
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"id401943">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402498">=
</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>
</div>
@@ -7876,7 +8346,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"id402050">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402591">=
</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 process, typically created by <a xmlns=3D"=
http://www.w3.org/1999/xhtml" href=3D"#f_process-run-function" title=3D"Fun=
ction PROCESS-RUN-FUNCTION"><b xmlns=3D"http://www.w3.org/TR/xhtml1/transit=
ional">process-run-function</b></a> or by <a xmlns=3D"http://www.w3.org/199=
9/xhtml" href=3D"#f_make-process" title=3D"Function MAKE-PROCESS"><b xmlns=
=3D"http://www.w3.org/TR/xhtml1/transitional">make-process</b></a></p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">default</span></i>---A default value to be returned if the specif=
ied
@@ -7886,7 +8356,7 @@
of the default argument, otherwise.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402116">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id402655">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Waits for the sp=
ecified process to terminate. If the
process terminates "normally" (if its initial function
@@ -8027,7 +8497,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"id365811">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id379555">=
</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,
@@ -8126,7 +8596,7 @@
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"9.1.4.=
=C3=82=C2=A0Stream Timeouts and Deadlines">Section=C3=82=C2=A09.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"id366614">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id365133">=
</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>
@@ -8145,7 +8615,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"id366675">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id365194">=
</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
@@ -8153,7 +8623,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"id385227">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id365236">=
</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
@@ -8179,7 +8649,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"id385239">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id365254">=
</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>
@@ -8187,7 +8657,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"id385281">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id365294">=
</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>
@@ -8207,7 +8677,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"id385342">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id365354">=
</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
@@ -8216,7 +8686,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"id385385">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384816">=
</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>
@@ -8235,14 +8705,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"id385446">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384876">=
</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"id385486">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384916">=
</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>
@@ -8262,7 +8732,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"id385543">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384973">=
</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
@@ -8270,7 +8740,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"id385571">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id385001">=
</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>
@@ -8290,7 +8760,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"id385629">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id385059">=
</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
@@ -8299,7 +8769,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"id383972">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id385101">=
</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>
@@ -8319,7 +8789,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"id384033">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id385162">=
</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
@@ -8336,7 +8806,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"id384123">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id364531">=
</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>
@@ -8373,7 +8843,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"id384223">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id364630">=
</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
@@ -8389,7 +8859,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"id384327">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id364734">=
</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>
@@ -8408,14 +8878,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"id384388">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id364795">=
</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"id384428">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id364836">=
</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
@@ -8436,12 +8906,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"id384487">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id364894">=
</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"id384513">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id364920">=
</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
@@ -8466,12 +8936,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"id384590">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id364981">=
</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"id384616">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id365007">=
</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>
@@ -8491,12 +8961,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"id384674">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383545">=
</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"id384700">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383571">=
</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>
@@ -8516,12 +8986,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"id384757">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383628">=
</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"id384784">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383654">=
</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>
@@ -8540,12 +9010,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"id384841">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383711">=
</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"id384867">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383738">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Returns the loca=
l port number</p>
</div>
@@ -8564,12 +9034,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"id384924">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383795">=
</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"id384951">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383821">=
</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>
@@ -8588,12 +9058,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"id385008">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383878">=
</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"id385034">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383905">=
</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>
@@ -8613,12 +9083,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"id385092">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383963">=
</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"id385118">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383989">=
</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>
@@ -8638,12 +9108,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"id385176">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384047">=
</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"id385202">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384073">=
</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>
@@ -8662,12 +9132,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"id382382">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384132">=
</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"id382393">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384142">=
</a>
<div class=3D"header">Superclasses:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">simple-error</p>
</div>
@@ -8686,12 +9156,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"id382451">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384200">=
</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"id382477">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384226">=
</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>
@@ -8710,12 +9180,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"id382535">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384284">=
</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"id382561">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384310">=
</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>
@@ -8739,12 +9209,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"id382624">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384374">=
</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"id382650">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384400">=
</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
@@ -8765,7 +9235,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"id382712">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384462">=
</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
@@ -8776,7 +9246,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"id382756">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384505">=
</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
@@ -8797,14 +9267,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"id382818">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384568">=
</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"id382874">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384623">=
</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>
@@ -8935,7 +9405,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"id350791">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id368254">=
</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
@@ -8981,7 +9451,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"id352002">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id371463">=
</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>
@@ -9001,13 +9471,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"id352060">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id330702">=
</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"id356050">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id330743">=
</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
@@ -9030,12 +9500,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"id349972">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id369072">=
</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"id349997">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id369098">=
</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
@@ -9057,12 +9527,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"id361165">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id366855">=
</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"id361190">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id366881">=
</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>
@@ -9083,12 +9553,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"id361251">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id377793">=
</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"id345236">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id377819">=
</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>
@@ -9110,12 +9580,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"id345297">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id376054">=
</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"id374272">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id376080">=
</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>
@@ -9137,12 +9607,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"id374333">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id365778">=
</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"id348660">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id365804">=
</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
@@ -9172,7 +9642,7 @@
<dl>
<dt>
<span class=3D"sect2">
- <a href=3D"#id345800">9.1.1. Stream External Encoding<=
/a>
+ <a href=3D"#id379095">9.1.1. Stream External Encoding<=
/a>
</span>
</dt>
<dt>
@@ -9240,7 +9710,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id345800"></a>9.1.1.=C3=82=
=C2=A0Stream External Encoding</h3>
+ <h3 class=3D"title"><a id=3D"id379095"></a>9.1.1.=C3=82=
=C2=A0Stream External Encoding</h3>
</div>
</div>
</div>
@@ -9401,12 +9871,12 @@
</div>
</div>
</div>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id363362" clas=
s=3D"indexterm"></a>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id363372" clas=
s=3D"indexterm"></a>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id363382" clas=
s=3D"indexterm"></a>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id334351" clas=
s=3D"indexterm"></a>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id332570" clas=
s=3D"indexterm"></a>
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id381685" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384745" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384755" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id384765" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id374398" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id356660" clas=
s=3D"indexterm"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383068" 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>,
@@ -9459,19 +9929,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"id381849=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383233=
"></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"id381877=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383260=
"></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"id381888=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id383271=
"></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>
</div>
@@ -9494,12 +9964,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"id383311=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id381790=
"></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"id383337=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id381816=
"></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
@@ -9508,7 +9978,7 @@
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"id383356=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id381835=
"></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>
</div>
@@ -9531,12 +10001,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"id383437=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id381916=
"></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"id383463=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id381942=
"></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
@@ -9545,7 +10015,7 @@
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"id383482=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id381961=
"></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>
</div>
@@ -9978,7 +10448,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"id392079=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393061=
"></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
@@ -9989,7 +10459,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"id392137=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393119=
"></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
@@ -10010,7 +10480,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"id392196=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393178=
"></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
@@ -10021,7 +10491,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"id392254=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393236=
"></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>
@@ -10041,7 +10511,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"id392313=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393295=
"></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
@@ -10057,7 +10527,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"id392388=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393370=
"></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
@@ -10080,7 +10550,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"id392448=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393430=
"></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
@@ -10096,7 +10566,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"id392524=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393506=
"></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
@@ -10118,13 +10588,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"id392583=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393565=
"></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>
(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"id392602=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393584=
"></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>
@@ -10135,7 +10605,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"id392667=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393649=
"></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
@@ -10159,14 +10629,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"id392736=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393718=
"></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"id392749=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393731=
"></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
@@ -10191,13 +10661,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"id392868=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393850=
"></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"id392880=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393862=
"></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
@@ -10207,7 +10677,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"id392952=
"></a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393934=
"></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) =
@@ -11373,13 +11843,13 @@
</div>
</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id381961" class=3D"indexterm"></a>
+ <a id=3D"id364300" class=3D"indexterm"></a>
<span><strong class=3D"command"><em class=3D"varname"><a id=3D"chud_s=
hark-config-file"></a>CHUD:*SHARK-CONFIG-FILE*</em> [Variable]</strong></sp=
an>
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">When non-null, this =
should be the pathname of an alternate profiling
configuration file created by the "Config Editor" in Shark.app.</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
- <a id=3D"id381987" class=3D"indexterm"></a>
+ <a id=3D"id364326" class=3D"indexterm"></a>
<span><strong class=3D"command"><em class=3D"varname"><a id=3D"chud_m=
eter"></a>CHUD:METER</em> form <em class=3D"varname">&key</em> (reset n=
il) (debug-output nil) [Macro]</strong></span>
</p>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Executes FORM (an ar=
bitrary lisp form) and returns whatever result(s) it
@@ -11641,7 +12111,7 @@
</dd>
<dt>
<span class=3D"sect1">
- <a href=3D"#id416155">12.12. The Foreign-Function-Interfac=
e Dictionary</a>
+ <a href=3D"#id416724">12.12. The Foreign-Function-Interfac=
e Dictionary</a>
</span>
</dt>
</dl>
@@ -12469,7 +12939,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id413298"></a>12.3.2.4.=
=C3=82=C2=A0%int-to-ptr [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id413867"></a>12.3.2.4.=
=C3=82=C2=A0%int-to-ptr [Function]</h4>
</div>
</div>
</div>
@@ -12510,7 +12980,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id413362"></a>12.3.2.5.=
=C3=82=C2=A0%inc-ptr [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id413931"></a>12.3.2.5.=
=C3=82=C2=A0%inc-ptr [Function]</h4>
</div>
</div>
</div>
@@ -12560,7 +13030,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id413441"></a>12.3.2.6.=
=C3=82=C2=A0%ptr-to-int [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id414010"></a>12.3.2.6.=
=C3=82=C2=A0%ptr-to-int [Function]</h4>
</div>
</div>
</div>
@@ -12602,7 +13072,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id413506"></a>12.3.2.7.=
=C3=82=C2=A0%null-ptr [Macro]</h4>
+ <h4 class=3D"title"><a id=3D"id414075"></a>12.3.2.7.=
=C3=82=C2=A0%null-ptr [Macro]</h4>
</div>
</div>
</div>
@@ -12627,7 +13097,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id413541"></a>12.3.2.8.=
=C3=82=C2=A0%null-ptr-p [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id414110"></a>12.3.2.8.=
=C3=82=C2=A0%null-ptr-p [Function]</h4>
</div>
</div>
</div>
@@ -12669,7 +13139,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id413606"></a>12.3.2.9.=
=C3=82=C2=A0%setf-macptr [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id414175"></a>12.3.2.9.=
=C3=82=C2=A0%setf-macptr [Function]</h4>
</div>
</div>
</div>
@@ -12717,7 +13187,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id413684"></a>12.3.2.10.=
=C3=82=C2=A0%incf-ptr [Macro]</h4>
+ <h4 class=3D"title"><a id=3D"id414253"></a>12.3.2.10.=
=C3=82=C2=A0%incf-ptr [Macro]</h4>
</div>
</div>
</div>
@@ -12765,7 +13235,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id413762"></a>12.3.2.11.=
=C3=82=C2=A0with-macptrs [Macro]</h4>
+ <h4 class=3D"title"><a id=3D"id414330"></a>12.3.2.11.=
=C3=82=C2=A0with-macptrs [Macro]</h4>
</div>
</div>
</div>
@@ -12815,7 +13285,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id413841"></a>12.3.2.12.=
=C3=82=C2=A0%stack-block [Macro]</h4>
+ <h4 class=3D"title"><a id=3D"id414409"></a>12.3.2.12.=
=C3=82=C2=A0%stack-block [Macro]</h4>
</div>
</div>
</div>
@@ -12866,7 +13336,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id413920"></a>12.3.2.13.=
=C3=82=C2=A0make-cstring [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id414489"></a>12.3.2.13.=
=C3=82=C2=A0make-cstring [Function]</h4>
</div>
</div>
</div>
@@ -12909,7 +13379,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id413986"></a>12.3.2.14.=
=C3=82=C2=A0with-cstrs [Macro]</h4>
+ <h4 class=3D"title"><a id=3D"id414555"></a>12.3.2.14.=
=C3=82=C2=A0with-cstrs [Macro]</h4>
</div>
</div>
</div>
@@ -12959,7 +13429,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id414065"></a>12.3.2.15.=
=C3=82=C2=A0with-encoded-cstrs [Macro]</h4>
+ <h4 class=3D"title"><a id=3D"id414634"></a>12.3.2.15.=
=C3=82=C2=A0with-encoded-cstrs [Macro]</h4>
</div>
</div>
</div>
@@ -13022,7 +13492,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id414173"></a>12.3.2.16.=
=C3=82=C2=A0%get-cstring [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id414742"></a>12.3.2.16.=
=C3=82=C2=A0%get-cstring [Function]</h4>
</div>
</div>
</div>
@@ -13064,7 +13534,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepa=
ge">
<div>
<div>
- <h4 class=3D"title"><a id=3D"id414237"></a>12.3.2.17.=
=C3=82=C2=A0%str-from-ptr [Function]</h4>
+ <h4 class=3D"title"><a id=3D"id414806"></a>12.3.2.17.=
=C3=82=C2=A0%str-from-ptr [Function]</h4>
</div>
</div>
</div>
@@ -14494,7 +14964,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"id41615=
5"></a>12.12.=C3=82=C2=A0The Foreign-Function-Interface Dictionary</h2>
+ <h2 class=3D"title" style=3D"clear: both"><a id=3D"id41672=
4"></a>12.12.=C3=82=C2=A0The Foreign-Function-Interface Dictionary</h2>
</div>
</div>
</div>
@@ -14511,7 +14981,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"id416193">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416762">=
</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>
@@ -14563,7 +15033,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"id416300">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416868">=
</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
@@ -14622,7 +15092,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"id416417">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id416986">=
</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
@@ -14669,7 +15139,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"id416500">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417068">=
</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
@@ -14772,7 +15242,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"id416639">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417207">=
</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 reads
the following text as a keyword, preserving the case of the
@@ -14801,14 +15271,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"id416713">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417282">=
</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"id416749">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417318">=
</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,
@@ -14837,7 +15307,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"id416825">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417394">=
</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,
@@ -14854,7 +15324,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"id416897">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417465">=
</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
@@ -14890,7 +15360,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"id416976">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417545">=
</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>
@@ -14898,7 +15368,7 @@
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"id417017">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417586">=
</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
@@ -14932,7 +15402,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"id417092">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417664">=
</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.
@@ -14945,7 +15415,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"id417139">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417710">=
</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
@@ -14973,7 +15443,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"id417219">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417790">=
</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
@@ -14986,7 +15456,7 @@
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"id417304">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417875">=
</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
@@ -15013,7 +15483,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"id417374">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id417945">=
</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
@@ -15024,7 +15494,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"id417446">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418018">=
</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
@@ -15050,7 +15520,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"id417516">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418087">=
</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
@@ -15063,7 +15533,7 @@
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"id417601">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418172">=
</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
@@ -15088,12 +15558,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"id417667">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418238">=
</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"id417693">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418264">=
</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
@@ -15116,12 +15586,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"id417762">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418334">=
</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"id417788">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418360">=
</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
@@ -15143,13 +15613,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"id417852">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418424">=
</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"id417882">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418454">=
</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 <code class=3D"code">CCL:FREE</c=
ode>
function invokes the foreign <code class=3D"code">free</code> fu=
nction from
@@ -15181,7 +15651,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"id417990">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418562">=
</a>
<div class=3D"header">Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">element-count</span></i>---A positive integer.</p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">element-type</span></i>---A type specifier.
@@ -15196,7 +15666,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"id418077">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418649">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
An "ivector" is a one-dimensional array that's specialized to
@@ -15231,7 +15701,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"id418160">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418732">=
</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>
@@ -15248,7 +15718,7 @@
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"id418238">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418809">=
</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
@@ -15297,7 +15767,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"id418379">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id418951">=
</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>
@@ -15311,7 +15781,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"id418445">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419017">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Expands into code which allocates and initializes
@@ -15352,7 +15822,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"id418547">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419120">=
</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
@@ -15385,7 +15855,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"id418645">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419217">=
</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>
@@ -15393,7 +15863,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"id418691">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419263">=
</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
@@ -15404,7 +15874,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"id418708">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419281">=
</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")
@@ -15439,7 +15909,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"id418731">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419303">=
</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>
@@ -15462,7 +15932,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"id418798">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419371">=
</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">accessor-form</span></i>---a keyword which names a foreign type o=
r record, as
@@ -15470,7 +15940,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"id418850">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419422">=
</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>
@@ -15496,13 +15966,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"id418927">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419499">=
</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"id418953">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419526">=
</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
@@ -15525,7 +15995,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"id419038">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419610">=
</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>
@@ -15533,7 +16003,7 @@
<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"id419098">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419670">=
</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
@@ -15563,14 +16033,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"id419192">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419765">=
</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"id419249">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419821">=
</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
@@ -15597,7 +16067,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"id419328">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419900">=
</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
@@ -15605,7 +16075,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"id419361">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419933">=
</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
@@ -15642,7 +16112,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"id419423">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id419996">=
</a>
<div class=3D"header">Example:</div>
<pre xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"progr=
amlisting">
(defclass resource-wrapper ()
@@ -15656,7 +16126,7 @@
(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"id419440">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id420012">=
</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>
@@ -15678,14 +16148,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"id419511">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id420083">=
</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"id419538">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id420110">=
</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
@@ -15709,14 +16179,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"id419608">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id420180">=
</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"id419635">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id420207">=
</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
@@ -15738,7 +16208,7 @@
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"id419678">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id420250">=
</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).
@@ -15841,12 +16311,12 @@
<dl>
<dt>
<span class=3D"sect2">
- <a href=3D"#id412551">13.6.1. Using <code class=3D"lit=
eral">define-objc-method</code></a>
+ <a href=3D"#id412720">13.6.1. Using <code class=3D"lit=
eral">define-objc-method</code></a>
</span>
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id411950">13.6.2. Using <code class=3D"lit=
eral">objc:defmethod</code></a>
+ <a href=3D"#id411104">13.6.2. Using <code class=3D"lit=
eral">objc:defmethod</code></a>
</span>
</dt>
<dt>
@@ -16452,7 +16922,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id412551"></a>13.6.1.=C3=82=
=C2=A0Using <code class=3D"literal">define-objc-method</code></h3>
+ <h3 class=3D"title"><a id=3D"id412720"></a>13.6.1.=C3=82=
=C2=A0Using <code class=3D"literal">define-objc-method</code></h3>
</div>
</div>
</div>
@@ -16569,7 +17039,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id411950"></a>13.6.2.=C3=82=
=C2=A0Using <code class=3D"literal">objc:defmethod</code></h3>
+ <h3 class=3D"title"><a id=3D"id411104"></a>13.6.2.=C3=82=
=C2=A0Using <code class=3D"literal">objc:defmethod</code></h3>
</div>
</div>
</div>
@@ -17393,7 +17863,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"id410163">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id397583">=
</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;
@@ -17403,7 +17873,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"id410208">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id397628">=
</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
@@ -17424,7 +17894,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"id410269">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id397689">=
</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;
@@ -17437,7 +17907,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"id410329">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id397749">=
</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
@@ -17461,13 +17931,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"id408854">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id410650">=
</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"id408880">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id410677">=
</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;
@@ -17489,13 +17959,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"id408939">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id410736">=
</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"id408966">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id410763">=
</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.
@@ -17515,7 +17985,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"id409023">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id410820">=
</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>
@@ -17524,7 +17994,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"id409066">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id410863">=
</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
@@ -17547,7 +18017,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"id397349">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id409385">=
</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>
@@ -17556,7 +18026,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"id397391">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id409427">=
</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
@@ -17579,12 +18049,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"id397451">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id409487">=
</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"id397477">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id409513">=
</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.
@@ -17605,7 +18075,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"id397534">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id409570">=
</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>
@@ -17613,7 +18083,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"id397576">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id409612">=
</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
@@ -17638,7 +18108,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"id391665">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398332">=
</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
@@ -17647,7 +18117,7 @@
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"id391707">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398374">=
</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
@@ -17663,7 +18133,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"id391741">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398408">=
</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
@@ -17688,14 +18158,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"id391801">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398469">=
</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"id391829">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398496">=
</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
@@ -17720,13 +18190,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"id391898">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398566">=
</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"id391925">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id398592">=
</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
@@ -17748,7 +18218,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"id411243">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394809">=
</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
@@ -17770,7 +18240,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"id411324">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394890">=
</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
@@ -17795,7 +18265,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"id411407">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394973">=
</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
@@ -17810,7 +18280,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"id411453">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395019">=
</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
@@ -17831,12 +18301,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"id411516">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395083">=
</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"id411528">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395094">=
</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
@@ -17878,7 +18348,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"id411604">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395170">=
</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
@@ -17913,7 +18383,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"id411661">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id411801">=
</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
@@ -17957,7 +18427,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"id393805">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id411881">=
</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
@@ -17981,12 +18451,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"id393854">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id411931">=
</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"id393865">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id411942">=
</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
@@ -17994,7 +18464,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"id393892">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id411969">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
This class
@@ -18012,7 +18482,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"id393911">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id411989">=
</a>
<div class=3D"header">Examples:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
You can create an ns-lisp-string with
@@ -18043,7 +18513,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"id393964">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id412042">=
</a>
<div class=3D"header">Notes:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">
Currently, ns-lisp-string is defined in
@@ -18383,7 +18853,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"id397681">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id348717">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">type</span></i>---The type of population, one of <code xmlns=3D"h=
ttp://www.w3.org/1999/xhtml" class=3D"literal">:LIST</code> (the default) o=
r <code xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"literal">:ALIST</co=
de></p>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">initial-contents</span></i>--- A sequence of elements (or conses,=
for <code xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"literal">:alist<=
/code>) to be used to initialize the
@@ -18391,7 +18861,7 @@
alist) is not stored in the population, a new list or alist =
is created to hold the elements.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id397181">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id411536">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Creates a new po=
pulation of the specified type.</p>
</div>
@@ -18409,7 +18879,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"id397239">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id411593">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">returns the type=
of <code class=3D"literal">population</code>, one of <code class=3D"litera=
l">:LIST</code> or <code class=3D"literal">:ALIST</code></p>
</div>
@@ -18427,7 +18897,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"id395769">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id397246">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">returns the list=
encapsulated in <code class=3D"literal">population</code>.
Note that as long as there is a direct (non-weak) reference to this
@@ -18450,7 +18920,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"id395837">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id397315">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Sets the list en=
capsulated in <code class=3D"literal">population</code> to
<code class=3D"literal">contents</code>. <code class=3D"literal">=
Contents</code> is not copied,
@@ -18483,7 +18953,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"id395922">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394112">=
</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>
@@ -18504,12 +18974,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"id393983">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id412061">=
</a>
<div class=3D"header">Arguments and Values:</div>
<p><i><span xmlns=3D"http://www.w3.org/1999/xhtml" class=
=3D"term">new-threshold</span></i>---The requested new lisp-heap-gc-thresho=
ld.</p>
</div>
<div class=3D"refsect1" lang=3D"en" xml:lang=3D"en">
- <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394009">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id412086">=
</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
@@ -18533,7 +19003,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"id394070">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id412148">=
</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.
@@ -18553,12 +19023,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"id394128">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id412207">=
</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"id394154">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id412233">=
</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
@@ -18584,7 +19054,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"id394213">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395491">=
</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>
@@ -18607,7 +19077,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"id394269">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395547">=
</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
@@ -18632,7 +19102,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"id394583">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395605">=
</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
@@ -18654,7 +19124,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"id394642">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395663">=
</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>
@@ -18664,7 +19134,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"id394697">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395718">=
</a>
<div class=3D"header">Description:</div>
<p xmlns=3D"http://www.w3.org/1999/xhtml">Puts the indicat=
ed threshold sizes in effect.
Each threshold indicates the total size that may be allocated
@@ -18688,12 +19158,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"id394762">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395784">=
</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"id394789">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395810">=
</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
@@ -18718,7 +19188,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"id394846">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395868">=
</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
@@ -18873,7 +19343,7 @@
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id404459">16.7.2. Recommended Reading</a>
+ <a href=3D"#id405013">16.7.2. Recommended Reading</a>
</span>
</dt>
</dl>
@@ -20149,7 +20619,7 @@
<ol type=3D"1">
<li>
<p>To support a feature called <span class=3D"emphasis">=
<em>GCTWA
- <sup>[<a id=3D"id403191" href=3D"#ftn.id403191">1</a>]</su=
p>
+ <sup>[<a id=3D"id403746" href=3D"#ftn.id403746">1</a>]</su=
p>
, </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
@@ -20282,7 +20752,7 @@
<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.id403191" href=3D"#id403191">1</a>] </=
sup>I believe that the acronym comes from MACLISP,
+ <p><sup>[<a id=3D"ftn.id403746" href=3D"#id403746">1</a>] </=
sup>I believe that the acronym comes from MACLISP,
where it stood for "Garbage Collection of Truly
Worthless Atoms".</p>
</div>
@@ -20342,7 +20812,7 @@
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"id404=
246" href=3D"#ftn.id404246">2</a>]</sup> The
+ at the point where they're created (via Setf).<sup>[<a id=3D"id403=
981" href=3D"#ftn.id403981">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
@@ -20389,7 +20859,7 @@
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"id404315" href=3D"#ftn.id404315">3</a>]</sup> It's =
always safe to
+ <sup>[<a id=3D"id404051" href=3D"#ftn.id404051">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>
@@ -20410,13 +20880,13 @@
<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.id404246" href=3D"#id404246">2</a>] </=
sup>This is
+ <p><sup>[<a id=3D"ftn.id403981" href=3D"#id403981">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 xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"footnote">
- <p><sup>[<a id=3D"ftn.id404315" href=3D"#id404315">3</a>] </=
sup>Note that the implicit setfs that occur when
+ <p><sup>[<a id=3D"ftn.id404051" href=3D"#id404051">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
@@ -20532,7 +21002,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id404459"></a>16.7.2.=C3=82=
=C2=A0Recommended Reading</h3>
+ <h3 class=3D"title"><a id=3D"id405013"></a>16.7.2.=C3=82=
=C2=A0Recommended Reading</h3>
</div>
</div>
</div>
@@ -20945,7 +21415,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"id376518">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id409960">=
</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
@@ -20970,7 +21440,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"id396561">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id370464">=
</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"
@@ -20994,7 +21464,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"id409587">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id372319">=
</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
@@ -21017,7 +21487,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"id397005">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id347754">=
</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
@@ -21042,7 +21512,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"id410645">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id392749">=
</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>
@@ -21060,7 +21530,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"id410926">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id392792">=
</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
@@ -21082,13 +21552,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"id403460">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id376536">=
</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"id403501">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id404119">=
</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
@@ -21114,7 +21584,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"id395208">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id396237">=
</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
@@ -21123,7 +21593,7 @@
<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"id410828">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id396294">=
</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
@@ -21748,6 +22218,7 @@
<h3>U</h3>
<dl>
<dt>unuse-interface-dir, <a href=3D"#f_unuse-interface-dir">=
Function UNUSE-INTERFACE-DIR</a></dt>
+ <dt>unwatch, <a href=3D"#f_unwatch">Function UNWATCH</a></dt>
<dt>use-interface-dir, <a href=3D"#f_use-interface-dir">Func=
tion USE-INTERFACE-DIR</a></dt>
<dt>use-lisp-heap-gc-threshold, <a href=3D"#f_use-lisp-heap-=
gc-threshold">Function USE-LISP-HEAP-GC-THRESHOLD</a></dt>
</dl>
@@ -21756,6 +22227,7 @@
<h3>W</h3>
<dl>
<dt>wait-on-semaphore, <a href=3D"#f_wait-on-semaphore">Func=
tion WAIT-ON-SEMAPHORE</a></dt>
+ <dt>watch, <a href=3D"#f_watch">Function WATCH</a></dt>
<dt>with-altivec-registers, <a href=3D"#lapm_with-altivec-re=
gisters">LAP Macro WITH-ALTIVEC-REGISTERS</a></dt>
<dt>with-lock-grabbed, <a href=3D"#m_with-lock-grabbed">Macr=
o WITH-LOCK-GRABBED</a></dt>
<dt>with-open-socket, <a href=3D"#m_with-open-socket">Macro =
WITH-OPEN-SOCKET</a></dt>
@@ -21764,6 +22236,7 @@
<dt>with-vector-buffer, <a href=3D"#lapm_with-vector-buffer"=
>LAP Macro WITH-VECTOR-BUFFER</a></dt>
<dt>with-write-lock, <a href=3D"#m_with-write-lock">Macro WI=
TH-WRITE-LOCK</a></dt>
<dt>without-interrupts, <a href=3D"#m_without-interrupts">Ma=
cro WITHOUT-INTERRUPTS</a></dt>
+ <dt>write-to-watched-object, <a href=3D"#c_write-to-watched-=
object">Condition WRITE-TO-WATCHED-OBJECT</a></dt>
</dl>
</div>
</div>
@@ -21772,6 +22245,6 @@
<div xmlns=3D"http://www.w3.org/TR/xhtml1/transitional" align=3D"cente=
r">
<a href=3D"#Symbol-Index">Symbol Index</a>
</div>
- <p xmlns=3D"http://www.w3.org/TR/xhtml1/transitional" xmlns:date=3D"ht=
tp://exslt.org/dates-and-times" class=3D"footer">This document was last mod=
ified at 21:0 on October 20, 2009, in UTC.<br></br>It uses version 1.72.0 o=
f the Norman Walsh Docbook stylesheets.<br></br>Built from subversion rev 1=
3059<br></br>Using libxml 20629, libxslt 10121 and libexslt 813.</p>
+ <p xmlns=3D"http://www.w3.org/TR/xhtml1/transitional" xmlns:date=3D"ht=
tp://exslt.org/dates-and-times" class=3D"footer">This document was last mod=
ified at 17:0 on October 27, 2009, in UTC.<br></br>It uses version 1.72.0 o=
f the Norman Walsh Docbook stylesheets.<br></br>Built from subversion rev 1=
3104<br></br>Using libxml 20629, libxslt 10121 and libexslt 813.</p>
</body>
</html>
More information about the Openmcl-cvs-notifications
mailing list