Changeset 12929

Oct 9, 2009, 1:00:16 AM (10 years ago)


1 edited


  • trunk/source/doc/ccl-documentation.html

    r12921 r12929  
    1839018390            <div>
    1839118391              <div class="refsect1" lang="en" xml:lang="en">
    18392                 <a xmlns="" id="id411948"></a>
     18392                <a xmlns="" id="id411949"></a>
    1839318393                <div class="header">Arguments and Values:</div>
    1839418394                <p><i><span xmlns="" class="term">type</span></i>---The type of population, one of <code xmlns="" class="literal">:LIST</code> (the default) or <code xmlns="" class="literal">:ALIST</code></p>
    1839818398              </div>
    1839918399              <div class="refsect1" lang="en" xml:lang="en">
    18400                 <a xmlns="" id="id412007"></a>
     18400                <a xmlns="" id="id412008"></a>
    1840118401                <div class="header">Description:</div>
    1840218402                <p xmlns="">Creates a new population of the specified type.</p>
    1841618416            <div>
    1841718417              <div class="refsect1" lang="en" xml:lang="en">
    18418                 <a xmlns="" id="id412064"></a>
     18418                <a xmlns="" id="id412065"></a>
    1841918419                <div class="header">Description:</div>
    1842018420                <p xmlns="">returns the type of <code class="literal">population</code>, one of <code class="literal">:LIST</code> or <code class="literal">:ALIST</code></p>
    1843418434            <div>
    1843518435              <div class="refsect1" lang="en" xml:lang="en">
    18436                 <a xmlns="" id="id393851"></a>
     18436                <a xmlns="" id="id393852"></a>
    1843718437                <div class="header">Description:</div>
    1843818438                <p xmlns="">returns the list encapsulated in <code class="literal">population</code>.
    1845718457            <div>
    1845818458              <div class="refsect1" lang="en" xml:lang="en">
    18459                 <a xmlns="" id="id412229"></a>
     18459                <a xmlns="" id="id412231"></a>
    1846018460                <div class="header">Description:</div>
    1846118461                <p xmlns="">Sets the list encapsulated in <code class="literal">population</code> to
    1849018490            <div>
    1849118491              <div class="refsect1" lang="en" xml:lang="en">
    18492                 <a xmlns="" id="id412314"></a>
     18492                <a xmlns="" id="id412316"></a>
    1849318493                <div class="header">Description:</div>
    1849418494                <p xmlns="">Returns the value of the kernel variable that specifies the
    1851118511            <div>
    1851218512              <div class="refsect1" lang="en" xml:lang="en">
    18513                 <a xmlns="" id="id394269"></a>
     18513                <a xmlns="" id="id394270"></a>
    1851418514                <div class="header">Arguments and Values:</div>
    1851518515                <p><i><span xmlns="" class="term">new-threshold</span></i>---The requested new lisp-heap-gc-threshold.</p>
    1851618516              </div>
    1851718517              <div class="refsect1" lang="en" xml:lang="en">
    18518                 <a xmlns="" id="id394294"></a>
     18518                <a xmlns="" id="id394296"></a>
    1851918519                <div class="header">Description:</div>
    1852018520                <p xmlns="">Sets the value of the kernel variable that specifies the
    1854018540            <div>
    1854118541              <div class="refsect1" lang="en" xml:lang="en">
    18542                 <a xmlns="" id="id394356"></a>
     18542                <a xmlns="" id="id394358"></a>
    1854318543                <div class="header">Description:</div>
    1854418544                <p xmlns="">Tries to grow or shrink lisp's heap space, so that the
    1856018560            <div>
    1856118561              <div class="refsect1" lang="en" xml:lang="en">
    18562                 <a xmlns="" id="id394415"></a>
     18562                <a xmlns="" id="id394416"></a>
    1856318563                <div class="header">Arguments and Values:</div>
    1856418564                <p><i><span xmlns="" class="term">arg</span></i>---a generalized boolean</p>
    1856518565              </div>
    1856618566              <div class="refsect1" lang="en" xml:lang="en">
    18567                 <a xmlns="" id="id394441"></a>
     18567                <a xmlns="" id="id394442"></a>
    1856818568                <div class="header">Description:</div>
    1856918569                <p xmlns="">Enables the EGC if arg is non-nil, disables the EGC
    1859118591            <div>
    1859218592              <div class="refsect1" lang="en" xml:lang="en">
    18593                 <a xmlns="" id="id394499"></a>
     18593                <a xmlns="" id="id394501"></a>
    1859418594                <div class="header">Description:</div>
    1859518595                <p xmlns="">Returns T if the EGC was enabled at the time of the call,
    1861418614            <div>
    1861518615              <div class="refsect1" lang="en" xml:lang="en">
    18616                 <a xmlns="" id="id394555"></a>
     18616                <a xmlns="" id="id394557"></a>
    1861718617                <div class="header">Description:</div>
    1861818618                <p xmlns="">Returns T if the EGC was active at the time of the call, NIL
    1863918639            <div>
    1864018640              <div class="refsect1" lang="en" xml:lang="en">
    18641                 <a xmlns="" id="id394613"></a>
     18641                <a xmlns="" id="id394615"></a>
    1864218642                <div class="header">Description:</div>
    1864318643                <p xmlns="">Returns, as multiple values, the sizes in kilobytes of the
    1866118661            <div>
    1866218662              <div class="refsect1" lang="en" xml:lang="en">
    18663                 <a xmlns="" id="id394672"></a>
     18663                <a xmlns="" id="id394674"></a>
    1866418664                <div class="header">Arguments and Values:</div>
    1866518665                <p><i><span xmlns="" class="term">generation-0-size</span></i>---the requested threshold size of the youngest
    1867118671              </div>
    1867218672              <div class="refsect1" lang="en" xml:lang="en">
    18673                 <a xmlns="" id="id394727"></a>
     18673                <a xmlns="" id="id394729"></a>
    1867418674                <div class="header">Description:</div>
    18675                 <p xmlns="">If the EGC is currently disabled, puts the indicated
    18676           threshold sizes in effect and returns T, otherwise, returns NIL.
     18675                <p xmlns="">Puts the indicated threshold sizes in effect.
     18676          Each threshold indicates the total size that may be allocated
     18677          in that and all younger generations before a GC is triggered.
     18678          Disables EGC while setting the values.
    1867718679          (The provided threshold sizes are rounded up to a multiple of
    1867818680          64Kbytes in <code class="literal">CCL</code> 0.14 and to a multiple of 32KBytes in earlier
    1869318695            <div>
    1869418696              <div class="refsect1" lang="en" xml:lang="en">
    18695                 <a xmlns="" id="id394792"></a>
     18697                <a xmlns="" id="id394795"></a>
    1869618698                <div class="header">Arguments and Values:</div>
    1869718699                <p><i><span xmlns="" class="term">arg</span></i>---a generalized boolean</p>
    1869818700              </div>
    1869918701              <div class="refsect1" lang="en" xml:lang="en">
    18700                 <a xmlns="" id="id394818"></a>
     18702                <a xmlns="" id="id394821"></a>
    1870118703                <div class="header">Description:</div>
    1870218704                <p xmlns="">Tries to influence the GC to retain/recycle the pages
    1872318725            <div>
    1872418726              <div class="refsect1" lang="en" xml:lang="en">
    18725                 <a xmlns="" id="id394876"></a>
     18727                <a xmlns="" id="id394879"></a>
    1872618728                <div class="header">Description:</div>
    1872718729                <p xmlns="">Returns T if the GC tries to retain pages between full GCs
    1887818880                <dt>
    1887918881                  <span class="sect2">
    18880                     <a href="#id404492">16.7.2. Recommended Reading</a>
     18882                    <a href="#id404502">16.7.2. Recommended Reading</a>
    1888118883                  </span>
    1888218884                </dt>
    2015420156                <li>
    2015520157                  <p>To support a feature called <span class="emphasis"><em>GCTWA
    20156                 <sup>[<a id="id403225" href="#ftn.id403225">1</a>]</sup>
     20158                <sup>[<a id="id403234" href="#ftn.id403234">1</a>]</sup>
    2015720159                    , </em></span>the vector that contains the internal
    2015820160                  symbols of the current package is marked on entry to the
    2028720289            <hr width="100" align="left" />
    2028820290            <div xmlns="" class="footnote">
    20289               <p><sup>[<a id="ftn.id403225" href="#id403225">1</a>] </sup>I believe that the acronym comes from MACLISP,
     20291              <p><sup>[<a id="ftn.id403234" href="#id403234">1</a>] </sup>I believe that the acronym comes from MACLISP,
    2029020292                            where it stood for "Garbage Collection of Truly
    2029120293                            Worthless Atoms".</p>
    2034720349        generations looking for such intergenerational references, the
    2034820350        runtime system must note all such intergenerational references
    20349         at the point where they're created (via Setf).<sup>[<a id="id404280" href="#ftn.id404280">2</a>]</sup> The
     20351        at the point where they're created (via Setf).<sup>[<a id="id404289" href="#ftn.id404289">2</a>]</sup> The
    2035020352        set of pointers that may contain intergenerational references is
    2035120353        sometimes called <span class="emphasis"><em>the remembered set</em></span>.</p>
    2039420396        that might introduce an intergenerational reference must be
    2039520397        memoized.
    20396         <sup>[<a id="id404349" href="#ftn.id404349">3</a>]</sup> It's always safe to
     20398        <sup>[<a id="id404359" href="#ftn.id404359">3</a>]</sup> It's always safe to
    2039720399        push any cons cell or gvector locative onto the memo stack;
    2039820400        it's never safe to push anything else.
    2041520417            <hr width="100" align="left" />
    2041620418            <div xmlns="" class="footnote">
    20417               <p><sup>[<a id="ftn.id404280" href="#id404280">2</a>] </sup>This is
     20419              <p><sup>[<a id="ftn.id404289" href="#id404289">2</a>] </sup>This is
    2041820420            sometimes called "The Write Barrier": all assignments which
    2041920421            might result in intergenerational references must be noted, as
    2042120423            </div>
    2042220424            <div xmlns="" class="footnote">
    20423               <p><sup>[<a id="ftn.id404349" href="#id404349">3</a>] </sup>Note that the implicit setfs that occur when
     20425              <p><sup>[<a id="ftn.id404359" href="#id404359">3</a>] </sup>Note that the implicit setfs that occur when
    2042420426        initializing an object - as in the case of a call to cons or
    2042520427        vector - can't introduce intergenerational references, since
    2053720539              <div>
    2053820540                <div>
    20539                   <h3 class="title"><a id="id404492"></a>16.7.2. Recommended Reading</h3>
     20541                  <h3 class="title"><a id="id404502"></a>16.7.2. Recommended Reading</h3>
    2054020542                </div>
    2054120543              </div>
    2095020952            <div>
    2095120953              <div class="refsect1" lang="en" xml:lang="en">
    20952                 <a xmlns="" id="id333344"></a>
     20954                <a xmlns="" id="id285538"></a>
    2095320955                <div class="header">Description:</div>
    2095420956                <p xmlns="">When true, attempts to redefine (via DEFUN or DEFMETHOD)
    2097520977            <div>
    2097620978              <div class="refsect1" lang="en" xml:lang="en">
    20977                 <a xmlns="" id="id362881"></a>
     20979                <a xmlns="" id="id393300"></a>
    2097820980                <div class="header">Description:</div>
    2097920981                <p xmlns="">Arranges that the outermost special bindings of *PACKAGE*
    2099921001            <div>
    2100021002              <div class="refsect1" lang="en" xml:lang="en">
    21001                 <a xmlns="" id="id393325"></a>
     21003                <a xmlns="" id="id395749"></a>
    2100221004                <div class="header">Description:</div>
    2100321005                <p xmlns="">Arranges that the outermost special bindings of *PACKAGE*
    2102221024            <div>
    2102321025              <div class="refsect1" lang="en" xml:lang="en">
    21024                 <a xmlns="" id="id395754"></a>
     21026                <a xmlns="" id="id342109"></a>
    2102521027                <div class="header">Description:</div>
    2102621028                <p xmlns="">This variable is initialized each time an Clozure CL session
    2104721049            <div>
    2104821050              <div class="refsect1" lang="en" xml:lang="en">
    21049                 <a xmlns="" id="id397694"></a>
     21051                <a xmlns="" id="id397671"></a>
    2105021052                <div class="header">Description:</div>
    2105121053                <p xmlns="">Returns non-NIL if AltiVec is available.</p>
    2106521067            <div>
    2106621068              <div class="refsect1" lang="en" xml:lang="en">
    21067                 <a xmlns="" id="id335434"></a>
     21069                <a xmlns="" id="id397714"></a>
    2106821070                <div class="header">Description:</div>
    2106921071                <p xmlns="">Intended to control the expansion of certain lap macros.
    2108721089            <div>
    2108821090              <div class="refsect1" lang="en" xml:lang="en">
    21089                 <a xmlns="" id="id395272"></a>
     21091                <a xmlns="" id="id335473"></a>
    2109021092                <div class="header">Arguments and Values:</div>
    2109121093                <p><i><span xmlns="" class="term">reglist</span></i>---A list of vector register names (vr0 .. vr31).</p>
    2109321095              </div>
    2109421096              <div class="refsect1" lang="en" xml:lang="en">
    21095                 <a xmlns="" id="id395313"></a>
     21097                <a xmlns="" id="id395300"></a>
    2109621098                <div class="header">Description:</div>
    2109721099                <p xmlns="">Specifies the set of AltiVec registers used in body. If
    2111921121            <div>
    2112021122              <div class="refsect1" lang="en" xml:lang="en">
    21121                 <a xmlns="" id="id379800"></a>
     21123                <a xmlns="" id="id379776"></a>
    2112221124                <div class="header">Arguments and Values:</div>
    2112321125                <p><i><span xmlns="" class="term">base</span></i>---Any available general-purpose register.</p>
    2112821130              </div>
    2112921131              <div class="refsect1" lang="en" xml:lang="en">
    21130                 <a xmlns="" id="id403360"></a>
     21132                <a xmlns="" id="id379834"></a>
    2113121133                <div class="header">Description:</div>
    2113221134                <p xmlns="">Generates code which allocates a 16-byte aligned buffer
    2177721779      <a href="#Symbol-Index">Symbol Index</a>
    2177821780    </div>
    21779     <p xmlns="" xmlns:date="" class="footer">This document was last modified 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 12920<br></br>Using libxml 20629, libxslt 10121 and libexslt 813.</p>
     21781    <p xmlns="" xmlns:date="" class="footer">This document was last modified 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 12928<br></br>Using libxml 20629, libxslt 10121 and libexslt 813.</p>
    2178021782  </body>
Note: See TracChangeset for help on using the changeset viewer.