[Openmcl-cvs-notifications] r12929 - /trunk/source/doc/ccl-documentation.html
gb at clozure.com
gb at clozure.com
Thu Oct 8 21:00:16 EDT 2009
Author: gb
Date: Thu Oct 8 21:00:16 2009
New Revision: 12929
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 Thu Oct 8 21:00:16 2009
@@ -18389,7 +18389,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"id411948">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id411949">=
</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
@@ -18397,7 +18397,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"id412007">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id412008">=
</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>
@@ -18415,7 +18415,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"id412064">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id412065">=
</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>
@@ -18433,7 +18433,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"id393851">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393852">=
</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
@@ -18456,7 +18456,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"id412229">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id412231">=
</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,
@@ -18489,7 +18489,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"id412314">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id412316">=
</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>
@@ -18510,12 +18510,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"id394269">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394270">=
</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"id394294">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394296">=
</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
@@ -18539,7 +18539,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"id394356">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394358">=
</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.
@@ -18559,12 +18559,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"id394415">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394416">=
</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"id394441">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394442">=
</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
@@ -18590,7 +18590,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"id394499">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394501">=
</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>
@@ -18613,7 +18613,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"id394555">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394557">=
</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
@@ -18638,7 +18638,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"id394613">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394615">=
</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
@@ -18660,7 +18660,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"id394672">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394674">=
</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>
@@ -18670,10 +18670,12 @@
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"id394727">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394729">=
</a>
<div class=3D"header">Description:</div>
- <p xmlns=3D"http://www.w3.org/1999/xhtml">If the EGC is cu=
rrently disabled, puts the indicated
- threshold sizes in effect and returns T, otherwise, returns NIL.
+ <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
+ in that and all younger generations before a GC is triggered.
+ Disables EGC while setting the values.
(The provided threshold sizes are rounded up to a multiple of
64Kbytes in <code class=3D"literal">CCL</code> 0.14 and to a multiple o=
f 32KBytes in earlier
versions.)</p>
@@ -18692,12 +18694,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"id394792">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394795">=
</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"id394818">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394821">=
</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
@@ -18722,7 +18724,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"id394876">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id394879">=
</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
@@ -18877,7 +18879,7 @@
</dt>
<dt>
<span class=3D"sect2">
- <a href=3D"#id404492">16.7.2. Recommended Reading</a>
+ <a href=3D"#id404502">16.7.2. Recommended Reading</a>
</span>
</dt>
</dl>
@@ -20153,7 +20155,7 @@
<ol type=3D"1">
<li>
<p>To support a feature called <span class=3D"emphasis">=
<em>GCTWA
- <sup>[<a id=3D"id403225" href=3D"#ftn.id403225">1</a>]</su=
p>
+ <sup>[<a id=3D"id403234" href=3D"#ftn.id403234">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
@@ -20286,7 +20288,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.id403225" href=3D"#id403225">1</a>] </=
sup>I believe that the acronym comes from MACLISP,
+ <p><sup>[<a id=3D"ftn.id403234" href=3D"#id403234">1</a>] </=
sup>I believe that the acronym comes from MACLISP,
where it stood for "Garbage Collection of Truly
Worthless Atoms".</p>
</div>
@@ -20346,7 +20348,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=
280" href=3D"#ftn.id404280">2</a>]</sup> The
+ at the point where they're created (via Setf).<sup>[<a id=3D"id404=
289" href=3D"#ftn.id404289">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
@@ -20393,7 +20395,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"id404349" href=3D"#ftn.id404349">3</a>]</sup> It's =
always safe to
+ <sup>[<a id=3D"id404359" href=3D"#ftn.id404359">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>
@@ -20414,13 +20416,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.id404280" href=3D"#id404280">2</a>] </=
sup>This is
+ <p><sup>[<a id=3D"ftn.id404289" href=3D"#id404289">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.id404349" href=3D"#id404349">3</a>] </=
sup>Note that the implicit setfs that occur when
+ <p><sup>[<a id=3D"ftn.id404359" href=3D"#id404359">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
@@ -20536,7 +20538,7 @@
<div xmlns=3D"http://www.w3.org/1999/xhtml" class=3D"titlepage=
">
<div>
<div>
- <h3 class=3D"title"><a id=3D"id404492"></a>16.7.2.=C3=82=
=C2=A0Recommended Reading</h3>
+ <h3 class=3D"title"><a id=3D"id404502"></a>16.7.2.=C3=82=
=C2=A0Recommended Reading</h3>
</div>
</div>
</div>
@@ -20949,7 +20951,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"id333344">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id285538">=
</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
@@ -20974,7 +20976,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"id362881">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id393300">=
</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"
@@ -20998,7 +21000,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"id393325">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395749">=
</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
@@ -21021,7 +21023,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"id395754">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id342109">=
</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
@@ -21046,7 +21048,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"id397694">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id397671">=
</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>
@@ -21064,7 +21066,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"id335434">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id397714">=
</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
@@ -21086,13 +21088,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"id395272">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id335473">=
</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"id395313">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id395300">=
</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
@@ -21118,7 +21120,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"id379800">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id379776">=
</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
@@ -21127,7 +21129,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"id403360">=
</a>
+ <a xmlns=3D"http://www.w3.org/1999/xhtml" id=3D"id379834">=
</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
@@ -21776,6 +21778,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 19:0 on October 6, 2009, in UTC.<br></br>It uses version 1.72.0 of=
the Norman Walsh Docbook stylesheets.<br></br>Built from subversion rev 12=
920<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 1:0 on October 9, 2009, in UTC.<br></br>It uses version 1.72.0 of =
the Norman Walsh Docbook stylesheets.<br></br>Built from subversion rev 129=
28<br></br>Using libxml 20629, libxslt 10121 and libexslt 813.</p>
</body>
</html>
More information about the Openmcl-cvs-notifications
mailing list