Changeset 10552

Show
Ignore:
Timestamp:
08/22/08 19:00:39 (3 months ago)
Author:
gb
Message:

fix makefile-common, generate html

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • trunk/source/doc/ccl-documentation.html

    r9209 r10552  
    66    <title>Clozure CL Documentation</title> 
    77    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /> 
    8     <link rel="start" href="#id301106" title="Clozure CL Documentation" /> 
    9     <link rel="next" href="#id322476" title="Chapter 1. About Clozure CL" /> 
     8    <link rel="start" href="#id472427" title="Clozure CL Documentation" /> 
     9    <link rel="next" href="#id491128" title="Chapter 1. About Clozure CL" /> 
    1010  </head> 
    1111  <body> 
     
    1414        <div> 
    1515          <div> 
    16             <h1 class="title"><a id="id301106"></a>Clozure CL Documentation</h1> 
     16            <h1 class="title"><a id="id472427"></a>Clozure CL Documentation</h1> 
    1717          </div> 
    1818        </div> 
     
    2323          <dt> 
    2424            <span class="chapter"> 
    25               <a href="#id322476">1. About Clozure CL</a> 
     25              <a href="#id491128">1. About Clozure CL</a> 
    2626            </span> 
    2727          </dt> 
     
    3030              <dt> 
    3131                <span class="sect1"> 
    32                   <a href="#id378260">1.1. Introduction to Clozure CL</a> 
     32                  <a href="#id547615">1.1. Introduction to Clozure CL</a> 
    3333                </span> 
    3434              </dt> 
     
    3737          <dt> 
    3838            <span class="chapter"> 
    39               <a href="#id335115">2. Obtaining, Installing, and Running Clozure CL</a> 
     39              <a href="#id503984">2. Obtaining, Installing, and Running Clozure CL</a> 
    4040            </span> 
    4141          </dt> 
     
    4444              <dt> 
    4545                <span class="sect1"> 
    46                   <a href="#id360672">2.1. Releases and System Requirements</a> 
     46                  <a href="#id540208">2.1. Releases and System Requirements</a> 
    4747                </span> 
    4848              </dt> 
    4949              <dt> 
    5050                <span class="sect1"> 
    51                   <a href="#id364310">2.2. Obtaining Clozure CL</a> 
     51                  <a href="#id538413">2.2. Obtaining Clozure CL</a> 
    5252                </span> 
    5353              </dt> 
    5454              <dt> 
    5555                <span class="sect1"> 
    56                   <a href="#id308181">2.3. Command Line Set Up</a> 
     56                  <a href="#id548194">2.3. Command Line Set Up</a> 
    5757                </span> 
    5858              </dt> 
     
    8181          <dt> 
    8282            <span class="chapter"> 
    83               <a href="#id321732">3. Building Clozure CL from its Source Code</a> 
     83              <a href="#id503558">3. Building Clozure CL from its Source Code</a> 
    8484            </span> 
    8585          </dt> 
     
    115115          <dt> 
    116116            <span class="chapter"> 
    117               <a href="#id322946">4. Using Clozure CL</a> 
     117              <a href="#id518767">4. Using Clozure CL</a> 
    118118            </span> 
    119119          </dt> 
     
    122122              <dt> 
    123123                <span class="sect1"> 
    124                   <a href="#id370264">4.1. Introduction</a> 
     124                  <a href="#id565771">4.1. Introduction</a> 
    125125                </span> 
    126126              </dt> 
     
    159159          <dt> 
    160160            <span class="chapter"> 
    161               <a href="#id351866">5. The Clozure CL IDE</a> 
     161              <a href="#id552477">5. The Clozure CL IDE</a> 
    162162            </span> 
    163163          </dt> 
     
    166166              <dt> 
    167167                <span class="sect1"> 
    168                   <a href="#id391992">5.1. Introduction</a> 
     168                  <a href="#id544505">5.1. Introduction</a> 
    169169                </span> 
    170170              </dt> 
    171171              <dt> 
    172172                <span class="sect1"> 
    173                   <a href="#id388704">5.2. Building the IDE</a> 
     173                  <a href="#id524038">5.2. Building the IDE</a> 
    174174                </span> 
    175175              </dt> 
    176176              <dt> 
    177177                <span class="sect1"> 
    178                   <a href="#id352336">5.3. Running the IDE</a> 
     178                  <a href="#id562577">5.3. Running the IDE</a> 
    179179                </span> 
    180180              </dt> 
    181181              <dt> 
    182182                <span class="sect1"> 
    183                   <a href="#id349170">5.4. IDE Features</a> 
     183                  <a href="#id530061">5.4. IDE Features</a> 
    184184                </span> 
    185185              </dt> 
    186186              <dt> 
    187187                <span class="sect1"> 
    188                   <a href="#id394341">5.5. IDE Sources</a> 
     188                  <a href="#id526212">5.5. IDE Sources</a> 
    189189                </span> 
    190190              </dt> 
    191191              <dt> 
    192192                <span class="sect1"> 
    193                   <a href="#id394374">5.6. The Application Builder</a> 
     193                  <a href="#id526247">5.6. The Application Builder</a> 
    194194                </span> 
    195195              </dt> 
     
    198198          <dt> 
    199199            <span class="chapter"> 
    200               <a href="#Questions-and-Answers">6. Questions and Answers</a> 
     200              <a href="#Programming-with-Threads">6. Programming with Threads</a> 
    201201            </span> 
    202202          </dt> 
     
    205205              <dt> 
    206206                <span class="sect1"> 
    207                   <a href="#How-can-I-do-nonblocking--aka--unbuffered--and--raw---IO-">6.1. How can I do nonblocking (aka "unbuffered" and "raw") IO?</a> 
     207                  <a href="#Threads-overview">6.1. Threads Overview</a> 
    208208                </span> 
    209209              </dt> 
    210210              <dt> 
    211211                <span class="sect1"> 
    212                   <a href="#I-m-using-the-graphics-demos--Why-doesn-t-the-menubar-change-">6.2. I'm using the graphics demos. Why doesn't the menubar 
    213       change?</a> 
     212                  <a href="#Intentionally--Missing-Functionality">6.2. (Intentionally) Missing Functionality</a> 
    214213                </span> 
    215214              </dt> 
    216215              <dt> 
    217216                <span class="sect1"> 
    218                   <a href="#I-m-using-Slime-and-Cocoa--Why-doesn-t--standard-output--seem-to-work-">6.3. I'm using Slime and Cocoa. Why doesn't *standard-output* 
    219       seem to work? </a> 
     217                  <a href="#Implementation-Decisions-and-Open-Questions">6.3. Implementation Decisions and Open Questions</a> 
     218                </span> 
     219              </dt> 
     220              <dt> 
     221                <span class="sect1"> 
     222                  <a href="#Porting-Code-from-the-Old-Thread-Model">6.4. Porting Code from the Old Thread Model</a> 
     223                </span> 
     224              </dt> 
     225              <dt> 
     226                <span class="sect1"> 
     227                  <a href="#Background-Terminal-Input">6.5. Background Terminal Input</a> 
     228                </span> 
     229              </dt> 
     230              <dt> 
     231                <span class="sect1"> 
     232                  <a href="#The-Threads-which-CCL-Uses-for-Its-Own-Purposes">6.6. The Threads which Clozure CL Uses for Its Own Purposes</a> 
     233                </span> 
     234              </dt> 
     235              <dt> 
     236                <span class="sect1"> 
     237                  <a href="#Threads-Dictionary">6.7. Threads Dictionary</a> 
    220238                </span> 
    221239              </dt> 
     
    224242          <dt> 
    225243            <span class="chapter"> 
    226               <a href="#Programming-with-Threads">7. Programming with Threads</a> 
     244              <a href="#Programming-with-Sockets">7. Programming with Sockets</a> 
    227245            </span> 
    228246          </dt> 
     
    231249              <dt> 
    232250                <span class="sect1"> 
    233                   <a href="#Threads-overview">7.1. Threads Overview</a> 
     251                  <a href="#Sockets-Overview">7.1. Overview</a> 
    234252                </span> 
    235253              </dt> 
    236254              <dt> 
    237255                <span class="sect1"> 
    238                   <a href="#Intentionally--Missing-Functionality">7.2. (Intentionally) Missing Functionality</a> 
    239                 </span> 
    240               </dt> 
    241               <dt> 
    242                 <span class="sect1"> 
    243                   <a href="#Implementation-Decisions-and-Open-Questions">7.3. Implementation Decisions and Open Questions</a> 
    244                 </span> 
    245               </dt> 
    246               <dt> 
    247                 <span class="sect1"> 
    248                   <a href="#Porting-Code-from-the-Old-Thread-Model">7.4. Porting Code from the Old Thread Model</a> 
    249                 </span> 
    250               </dt> 
    251               <dt> 
    252                 <span class="sect1"> 
    253                   <a href="#Background-Terminal-Input">7.5. Background Terminal Input</a> 
    254                 </span> 
    255               </dt> 
    256               <dt> 
    257                 <span class="sect1"> 
    258                   <a href="#The-Threads-which-CCL-Uses-for-Its-Own-Purposes">7.6. The Threads which Clozure CL Uses for Its Own Purposes</a> 
    259                 </span> 
    260               </dt> 
    261               <dt> 
    262                 <span class="sect1"> 
    263                   <a href="#Threads-Dictionary">7.7. Threads Dictionary</a> 
     256                  <a href="#Sockets-Dictionary">7.2. Sockets Dictionary</a> 
    264257                </span> 
    265258              </dt> 
     
    268261          <dt> 
    269262            <span class="chapter"> 
    270               <a href="#Programming-with-Sockets">8. Programming with Sockets</a> 
     263              <a href="#Running-Other-Programs-as-Subprocesses">8. Running Other Programs as Subprocesses</a> 
    271264            </span> 
    272265          </dt> 
     
    275268              <dt> 
    276269                <span class="sect1"> 
    277                   <a href="#Sockets-Overview">8.1. Overview</a> 
     270                  <a href="#Subprocess-Overview">8.1. Overview</a> 
    278271                </span> 
    279272              </dt> 
    280273              <dt> 
    281274                <span class="sect1"> 
    282                   <a href="#Sockets-Dictionary">8.2. Sockets Dictionary</a> 
     275                  <a href="#Subprocess-Examples">8.2. Examples</a> 
     276                </span> 
     277              </dt> 
     278              <dt> 
     279                <span class="sect1"> 
     280                  <a href="#Limitations-and-known-bugs">8.3. Limitations and known bugs</a> 
     281                </span> 
     282              </dt> 
     283              <dt> 
     284                <span class="sect1"> 
     285                  <a href="#External-Program-Dictionary">8.4. External-Program Dictionary</a> 
    283286                </span> 
    284287              </dt> 
     
    287290          <dt> 
    288291            <span class="chapter"> 
    289               <a href="#Running-Other-Programs-as-Subprocesses">9. Running Other Programs as Subprocesses</a> 
     292              <a href="#Streams">9. Streams</a> 
    290293            </span> 
    291294          </dt> 
     
    294297              <dt> 
    295298                <span class="sect1"> 
    296                   <a href="#Subprocess-Overview">9.1. Overview</a> 
     299                  <a href="#CCL-Stream-Extensions">9.1. Stream Extensions</a> 
    297300                </span> 
    298301              </dt> 
    299302              <dt> 
    300303                <span class="sect1"> 
    301                   <a href="#Subprocess-Examples">9.2. Examples</a> 
    302                 </span> 
    303               </dt> 
    304               <dt> 
    305                 <span class="sect1"> 
    306                   <a href="#Limitations-and-known-bugs">9.3. Limitations and known bugs</a> 
    307                 </span> 
    308               </dt> 
    309               <dt> 
    310                 <span class="sect1"> 
    311                   <a href="#External-Program-Dictionary">9.4. External-Program Dictionary</a> 
     304                  <a href="#Creating-Your-Own-Stream-Classes-with-Gray-Streams">9.2. Creating Your Own Stream Classes with Gray Streams</a> 
    312305                </span> 
    313306              </dt> 
     
    316309          <dt> 
    317310            <span class="chapter"> 
    318               <a href="#Streams">10. Streams</a> 
     311              <a href="#Writing-Portable-Extensions-to-the-Object-System-using-the-MetaObject-Protocol">10. Writing Portable Extensions to the Object System  using the MetaObject Protocol</a> 
    319312            </span> 
    320313          </dt> 
     
    323316              <dt> 
    324317                <span class="sect1"> 
    325                   <a href="#CCL-Stream-Extensions">10.1. Stream Extensions</a> 
     318                  <a href="#MOP-Overview">10.1. Overview</a> 
    326319                </span> 
    327320              </dt> 
    328321              <dt> 
    329322                <span class="sect1"> 
    330                   <a href="#Creating-Your-Own-Stream-Classes-with-Gray-Streams">10.2. Creating Your Own Stream Classes with Gray Streams</a> 
     323                  <a href="#MOP-Implementation-status">10.2. Implementation status</a> 
     324                </span> 
     325              </dt> 
     326              <dt> 
     327                <span class="sect1"> 
     328                  <a href="#Concurrency-issues">10.3. Concurrency issues</a> 
    331329                </span> 
    332330              </dt> 
     
    335333          <dt> 
    336334            <span class="chapter"> 
    337               <a href="#Writing-Portable-Extensions-to-the-Object-System-using-the-MetaObject-Protocol">11. Writing Portable Extensions to the Object System  using the MetaObject Protocol</a> 
     335              <a href="#Profiling">11. Profiling</a> 
    338336            </span> 
    339337          </dt> 
     
    342340              <dt> 
    343341                <span class="sect1"> 
    344                   <a href="#MOP-Overview">11.1. Overview</a> 
     342                  <a href="#Profiling-Using the Linux oprofile system-level profiler">11.1. Using the Linux oprofile system-level profiler</a> 
    345343                </span> 
    346344              </dt> 
    347345              <dt> 
    348346                <span class="sect1"> 
    349                   <a href="#MOP-Implementation-status">11.2. Implementation status</a> 
    350                 </span> 
    351               </dt> 
    352               <dt> 
    353                 <span class="sect1"> 
    354                   <a href="#Concurrency-issues">11.3. Concurrency issues</a> 
     347                  <a href="#Profiling-Using-Apples-CHUD-metering-tools">11.2. Using Apple's CHUD metering tools</a> 
    355348                </span> 
    356349              </dt> 
     
    421414              <dt> 
    422415                <span class="sect1"> 
    423                   <a href="#id430545">12.12. The Foreign-Function-Interface Dictionary</a> 
     416                  <a href="#id602931">12.12. The Foreign-Function-Interface Dictionary</a> 
    424417                </span> 
    425418              </dt> 
     
    632625          </dd> 
    633626          <dt> 
     627            <span class="chapter"> 
     628              <a href="#Questions-and-Answers">18. Questions and Answers</a> 
     629            </span> 
     630          </dt> 
     631          <dd> 
     632            <dl> 
     633              <dt> 
     634                <span class="sect1"> 
     635                  <a href="#How-can-I-do-nonblocking--aka--unbuffered--and--raw---IO-">18.1. How can I do nonblocking (aka "unbuffered" and "raw") IO?</a> 
     636                </span> 
     637              </dt> 
     638              <dt> 
     639                <span class="sect1"> 
     640                  <a href="#I-m-using-the-graphics-demos--Why-doesn-t-the-menubar-change-">18.2. I'm using the graphics demos. Why doesn't the menubar 
     641      change?</a> 
     642                </span> 
     643              </dt> 
     644              <dt> 
     645                <span class="sect1"> 
     646                  <a href="#I-m-using-Slime-and-Cocoa--Why-doesn-t--standard-output--seem-to-work-">18.3. I'm using Slime and Cocoa. Why doesn't *standard-output* 
     647      seem to work? </a> 
     648                </span> 
     649              </dt> 
     650            </dl> 
     651          </dd> 
     652          <dt> 
    634653            <span class="glossary"> 
    635654              <a href="#glossary">Glossary of Terms</a> 
     
    656675          <div> 
    657676            <div> 
    658               <h2 class="title"><a id="id322476"></a>Chapter 1. About Clozure CL</h2> 
     677              <h2 class="title"><a id="id491128"></a>Chapter 1. About Clozure CL</h2> 
    659678            </div> 
    660679          </div> 
     
    664683            <dt> 
    665684              <span class="sect1"> 
    666                 <a href="#id378260">1.1. Introduction to Clozure CL</a> 
     685                <a href="#id547615">1.1. Introduction to Clozure CL</a> 
    667686              </span> 
    668687            </dt> 
     
    673692            <div> 
    674693              <div> 
    675                 <h2 class="title" style="clear: both"><a id="id378260"></a>1.1. Introduction to Clozure CL</h2> 
     694                <h2 class="title" style="clear: both"><a id="id547615"></a>1.1. Introduction to Clozure CL</h2> 
    676695              </div> 
    677696            </div> 
     
    746765              </li> 
    747766              <li> 
    748                 <p>An IDE on the Mac OS X, fully integrated with 
     767                <p>An IDE on Mac OS X, fully integrated with 
    749768      the Macintosh window system and User Interface 
    750769      standards.</p> 
     
    761780              <li> 
    762781                <p>Many extensions including: files mapped to 
    763       Common Lisp vectors for fast file I/O; thread local hash tables 
     782      Common Lisp vectors for fast file I/O; thread-local hash tables 
    764783      and streams to eliminate locking overhead; cons hashing support; 
    765784      and much more</p> 
     
    782801          <div> 
    783802            <div> 
    784               <h2 class="title"><a id="id335115"></a>Chapter 2. Obtaining, Installing, and Running Clozure CL</h2> 
     803              <h2 class="title"><a id="id503984"></a>Chapter 2. Obtaining, Installing, and Running Clozure CL</h2> 
    785804            </div> 
    786805          </div> 
     
    790809            <dt> 
    791810              <span class="sect1"> 
    792                 <a href="#id360672">2.1. Releases and System Requirements</a> 
     811                <a href="#id540208">2.1. Releases and System Requirements</a> 
    793812              </span> 
    794813            </dt> 
     
    797816                <dt> 
    798817                  <span class="sect2"> 
    799                     <a href="#id369379">2.1.1. LinuxPPC</a> 
     818                    <a href="#id525742">2.1.1. LinuxPPC</a> 
    800819                  </span> 
    801820                </dt> 
    802821                <dt> 
    803822                  <span class="sect2"> 
    804                     <a href="#id349897">2.1.2. Linux X8664</a> 
     823                    <a href="#id535678">2.1.2. Linux X8664</a> 
    805824                  </span> 
    806825                </dt> 
    807826                <dt> 
    808827                  <span class="sect2"> 
    809                     <a href="#id347997">2.1.3. FreeBSD-amd64</a> 
     828                    <a href="#id543148">2.1.3. FreeBSD-amd64</a> 
    810829                  </span> 
    811830                </dt> 
    812831                <dt> 
    813832                  <span class="sect2"> 
    814                     <a href="#id366253">2.1.4. DarwinPPC-MacOS-X</a> 
     833                    <a href="#id471818">2.1.4. DarwinPPC-MacOS-X</a> 
    815834                  </span> 
    816835                </dt> 
    817836                <dt> 
    818837                  <span class="sect2"> 
    819                     <a href="#id364292">2.1.5. Darwinx8664-MacOS-X</a> 
     838                    <a href="#id538393">2.1.5. Darwinx8664-MacOS-X</a> 
    820839                  </span> 
    821840                </dt> 
     
    824843            <dt> 
    825844              <span class="sect1"> 
    826                 <a href="#id364310">2.2. Obtaining Clozure CL</a> 
     845                <a href="#id538413">2.2. Obtaining Clozure CL</a> 
    827846              </span> 
    828847            </dt> 
     
    831850                <dt> 
    832851                  <span class="sect2"> 
    833                     <a href="#id364330">2.2.1. The Mac Way</a> 
     852                    <a href="#id538435">2.2.1. The Mac Way</a> 
    834853                  </span> 
    835854                </dt> 
    836855                <dt> 
    837856                  <span class="sect2"> 
    838                     <a href="#id397955">2.2.2. Getting Clozure CL with Subversion</a> 
     857                    <a href="#id473036">2.2.2. Getting Clozure CL with Subversion</a> 
    839858                  </span> 
    840859                </dt> 
    841860                <dt> 
    842861                  <span class="sect2"> 
    843                     <a href="#id308156">2.2.3. Tarballs</a> 
     862                    <a href="#id548167">2.2.3. Tarballs</a> 
    844863                  </span> 
    845864                </dt> 
     
    848867            <dt> 
    849868              <span class="sect1"> 
    850                 <a href="#id308181">2.3. Command Line Set Up</a> 
     869                <a href="#id548194">2.3. Command Line Set Up</a> 
    851870              </span> 
    852871            </dt> 
     
    894913                <dt> 
    895914                  <span class="sect2"> 
    896                     <a href="#id371816">2.6.3. Installing SLIME</a> 
     915                    <a href="#id529312">2.6.3. Installing SLIME</a> 
    897916                  </span> 
    898917                </dt> 
     
    930949            <div> 
    931950              <div> 
    932                 <h2 class="title" style="clear: both"><a id="id360672"></a>2.1. Releases and System Requirements</h2> 
     951                <h2 class="title" style="clear: both"><a id="id540208"></a>2.1. Releases and System Requirements</h2> 
    933952              </div> 
    934953            </div> 
     
    967986      following subsections.</p> 
    968987          <p xmlns="http://www.w3.org/1999/xhtml">Older versions are still available for downloading as 
    969     tarballs.  Version 1.0 was a stable release released in late 2005. 
     988    tarballs.  Version 1.0 was a stable version released in late 2005. 
    970989    Version 1.1 was under active development until late 2007.  A final 
    971990    1.1 release was never made.  It was distributed as a series of 
    972991    development "snapshots" and CVS updates.  1.1 snapshots introduced 
    973992    support for x86-64 platforms, internal use of Unicode, and many 
    974     other features, but were a moving target. </p> 
     993    other features, but were moving targets. </p> 
    975994          <div class="sect2" lang="en" xml:lang="en"> 
    976995            <div xmlns="http://www.w3.org/1999/xhtml" class="titlepage"> 
    977996              <div> 
    978997                <div> 
    979                   <h3 class="title"><a id="id369379"></a>2.1.1. LinuxPPC</h3> 
     998                  <h3 class="title"><a id="id525742"></a>2.1.1. LinuxPPC</h3> 
    980999                </div> 
    9811000              </div> 
     
    9891008              <div> 
    9901009                <div> 
    991                   <h3 class="title"><a id="id349897"></a>2.1.2. Linux X8664</h3> 
     1010                  <h3 class="title"><a id="id535678"></a>2.1.2. Linux X8664</h3> 
    9921011                </div> 
    9931012              </div> 
     
    10021021      Linux have been known to have problems compiling some of the C 
    10031022      code in the kernel; some very old Linux distributions don't 
    1004       follow the current ABI standards wrt segment register usage; 
    1005       some early Linux kernels for x86-64 had problems mapping large 
    1006       regions of the address space; and so on. It's difficult to 
    1007       enumerate exactly what versions of what Linux distributions have 
     1023      follow the current ABI standards with regard to segment register 
     1024      usage; some early Linux kernels for x86-64 had problems mapping 
     1025      large regions of the address space; and so on. It's difficult to 
     1026      enumerate exactly what versions of which Linux distributions have 
    10081027      what problems.  A rule of thumb is that—because much of 
    10091028      the development of Clozure CL for x86-64 took place in that time 
     
    10151034              <div> 
    10161035                <div> 
    1017                   <h3 class="title"><a id="id347997"></a>2.1.3. FreeBSD-amd64</h3> 
     1036                  <h3 class="title"><a id="id543148"></a>2.1.3. FreeBSD-amd64</h3> 
    10181037                </div> 
    10191038              </div> 
     
    10301049              <div> 
    10311050                <div> 
    1032                   <h3 class="title"><a id="id366253"></a>2.1.4. DarwinPPC-MacOS-X</h3> 
     1051                  <h3 class="title"><a id="id471818"></a>2.1.4. DarwinPPC-MacOS-X</h3> 
    10331052                </div> 
    10341053              </div> 
     
    10501069              <div> 
    10511070                <div> 
    1052                   <h3 class="title"><a id="id364292"></a>2.1.5. Darwinx8664-MacOS-X</h3> 
     1071                  <h3 class="title"><a id="id538393"></a>2.1.5. Darwinx8664-MacOS-X</h3> 
    10531072                </div> 
    10541073              </div> 
     
    10691088            <div> 
    10701089              <div> 
    1071                 <h2 class="title" style="clear: both"><a id="id364310"></a>2.2. Obtaining Clozure CL</h2> 
     1090                <h2 class="title" style="clear: both"><a id="id538413"></a>2.2. Obtaining Clozure CL</h2> 
    10721091              </div> 
    10731092            </div> 
     
    10921111              <div> 
    10931112                <div> 
    1094                   <h3 class="title"><a id="id364330"></a>2.2.1. The Mac Way</h3> 
     1113                  <h3 class="title"><a id="id538435"></a>2.2.1. The Mac Way</h3> 
    10951114                </div> 
    10961115              </div> 
     
    11201139              <div> 
    11211140                <div> 
    1122                   <h3 class="title"><a id="id397955"></a>2.2.2. Getting Clozure CL with Subversion</h3> 
     1141                  <h3 class="title"><a id="id473036"></a>2.2.2. Getting Clozure CL with Subversion</h3> 
    11231142                </div> 
    11241143              </div> 
     
    11291148      the Mac Way.  Subversion is a source code control system that is 
    11301149      in wide usage.  Most modern OSes come with subversion 
    1131       pre-installed. A complete, buildable and runnable set of Clozure 
    1132       CL sources and binaries can be retrieved by doing one subversion 
     1150      pre-installed. A complete, buildable and runnable set of Clozure CL 
     1151      sources and binaries can be retrieved by doing one subversion 
    11331152      checkout.</p> 
    1134             <p xmlns="http://www.w3.org/1999/xhtml">One subversion command will create
     1153            <p xmlns="http://www.w3.org/1999/xhtml">One subversion command creates
    11351154      <code class="literal">ccl</code> directory with runnable binaries, and a 
    11361155      complete set of buildable sources.  To get the bleeding edge 
     
    11431162            <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting"> 
    11441163           
    1145 svn co http://svn.clozure.com/publicsvn/openmcl/releases/1.2/darwinx8664/ccl 
     1164svn co http://svn.clozure.com/publicsvn/openmcl/release/1.2/darwinx8664/ccl 
    11461165        </pre> 
    11471166            <p xmlns="http://www.w3.org/1999/xhtml">These examples fetch the complete sources and binaries 
     
    11811200Welcome to Clozure Common Lisp Version 1.2  (DarwinX8664)! 
    11821201? (rebuild-ccl :full t) 
     1202 
    11831203&lt;lots of compilation output&gt; 
     1204 
    11841205  ? (quit) 
    11851206  joe:ccl&gt; 
     
    12021223        </pre> 
    12031224              <p xmlns="http://www.w3.org/1999/xhtml">  
    1204         If Subversion is installed, it will say something like: 
     1225        If Subversion is installed, you will see something like: 
    12051226        </p> 
    12061227              <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting"> 
     
    12091230        </pre> 
    12101231              <p xmlns="http://www.w3.org/1999/xhtml"> 
    1211         If Subversion is not installed, it will say something 
     1232        If Subversion is not installed, you will see something 
    12121233        like: 
    12131234        </p> 
     
    12281249              <div> 
    12291250                <div> 
    1230                   <h3 class="title"><a id="id308156"></a>2.2.3. Tarballs</h3> 
     1251                  <h3 class="title"><a id="id548167"></a>2.2.3. Tarballs</h3> 
    12311252                </div> 
    12321253              </div> 
     
    12431264            <div> 
    12441265              <div> 
    1245                 <h2 class="title" style="clear: both"><a id="id308181"></a>2.3. Command Line Set Up</h2> 
     1266                <h2 class="title" style="clear: both"><a id="id548194"></a>2.3. Command Line Set Up</h2> 
    12461267              </div> 
    12471268            </div> 
    12481269          </div> 
    12491270          <p xmlns="http://www.w3.org/1999/xhtml">Sometimes it's convenient to use Clozure CL from a Unix 
    1250       shell command line.  This is especially true when using Clozure 
    1251       CL as a way to run Common Lisp utilities.</p> 
     1271      shell command line.  This is especially true when using Clozure CL 
     1272      as a way to run Common Lisp utilities.</p> 
    12521273          <div class="sect2" lang="en" xml:lang="en"> 
    12531274            <div xmlns="http://www.w3.org/1999/xhtml" class="titlepage"> 
     
    12911312          <code class="literal">~/bin</code>.  It is better to do this than to 
    12921313          add <code class="literal">ccl/scripts</code> to your 
    1293           <em class="varname">PATH</em> since the script needs to be edited, 
    1294           it will show up as modified to Subversion.</p> 
     1314          <em class="varname">PATH</em>, because the script needs to be edited, 
     1315          and editing it in-place means that Subversion sees the script as 
     1316          modified..</p> 
    12951317                </li> 
    12961318                <li> 
     
    13461368      you use to whatever you want.  For example, if you are on a 
    13471369      64-bit system, and you only use Clozure CL in 64-bit mode, then 
    1348       you can rename <code class="literal">ccl64</code> to 
     1370      you can rename <code class="literal">ccl64</code> to 
    13491371      <code class="literal">ccl</code> so that you only need to type 
    13501372      "<code class="literal">ccl</code>" to run it.</p> 
     
    13981420          </div> 
    13991421          <p xmlns="http://www.w3.org/1999/xhtml">By default Clozure CL tries to load the file 
    1400       <code class="literal">"home:openmcl-init.lisp"</code> or the compiled 
     1422      <code class="literal">"home:ccl-init.lisp"</code> or the compiled 
    14011423           
    1402       <code class="literal">"home:openmcl-init.fasl"</code> upon starting up. It 
    1403       does this by executing <code class="literal">(load 
    1404       "home:openmcl-init")</code>.  If it's unable to load the file 
     1424      <code class="literal">"home:ccl-init.fasl"</code> upon starting up. For 
     1425      the sake of backward compatibility, it also tries to load the 
     1426      file <code class="literal">"home:openmcl-init.lisp"</code>, or its compiled 
     1427      equivalent. Clozure CL does this by executing <code class="literal">(load 
     1428      "home:ccl-init")</code>.  If it's unable to load the file 
    14051429      (for example because the file doesn't exist), Clozure CL doesn't 
    14061430      signal an error or warning, it just completes its startup 
     
    14101434      your home directory. Clozure CL therefore looks for either of the 
    14111435      files 
    1412       <code class="literal">~/openmcl-init.lisp</code> or 
    1413       <code class="literal">~/openmcl-init.fasl</code>.</p> 
     1436      <code class="literal">~/ccl-init.lisp</code> or 
     1437      <code class="literal">~/ccl-init.fasl</code>.</p> 
    14141438          <p xmlns="http://www.w3.org/1999/xhtml">Because the init file is loaded the same way as normal Lisp 
    14151439      code is, you can put anything you want in it.  For example, you 
     
    14271451            </div> 
    14281452          </div> 
    1429           <p xmlns="http://www.w3.org/1999/xhtml">When using Clozure CL from the command line, these 
     1453          <p xmlns="http://www.w3.org/1999/xhtml">When using Clozure CL from the command line, the following 
    14301454      options may be used to modify its behavior.  The exact set of 
    14311455      Clozure CL command-line arguments may vary per platform and 
     
    14451469                <p><code class="literal">-V</code> (or 
    14461470              <code class="literal">--version</code>).  Prints the version of 
    1447               Clozure CL then exits.  This is the same thing that is 
    1448               returned by 
    1449               <span class="function"><strong>LISP-APPLICATION-VERSION</strong></span>.</p> 
     1471              Clozure CL then exits.  The version string is the same value 
     1472              that is returned by 
     1473              <span class="function"><strong>LISP-IMPLEMENTATION-VERSION</strong></span>.</p> 
    14501474              </li> 
    14511475              <li> 
     
    14681492              </pre> 
    14691493                <p> 
    1470               will have the effect of making the standard CL streams use 
     1494              has the effect of making the standard CL streams use 
    14711495              <code class="literal">:UTF-8</code> as their character 
    14721496              encoding.</p> 
     
    14741498              <li> 
    14751499                <p><code class="literal">-n</code> (or 
    1476               <code class="literal">--no-init</code>). If this option is given, 
    1477               the init file is not loaded.  This is useful if Clozure CL is 
    1478               being invoked by a shell script which should not be 
    1479               affected by whatever customizations a user might have in 
    1480               place.</p> 
     1500              <code class="literal">--no-init</code>). If this option is given, the 
     1501              init file is not loaded.  This is useful if Clozure CL is being 
     1502              invoked by a shell script that should not be affected by 
     1503              whatever customizations a user might have in place.</p> 
    14811504              </li> 
    14821505              <li> 
     
    15161539                <p><code class="literal">-S</code> <em class="parameter"><code>n</code></em> (or 
    15171540              <code class="literal">--stack-size</code> <em class="parameter"><code>n</code></em>). Sets the size of the 
    1518               initial control stack to <em class="parameter"><code>n</code></em>. (see <a class="xref" href="#Thread-Stack-Sizes" title="7.3.1. Thread Stack Sizes">Section 7.3.1, “Thread Stack Sizes”</a>)</p> 
     1541              initial control stack to <em class="parameter"><code>n</code></em>. (see <a class="xref" href="#Thread-Stack-Sizes" title="6.3.1. Thread Stack Sizes">Section 6.3.1, “Thread Stack Sizes”</a>)</p> 
    15191542              </li> 
    15201543              <li> 
     
    15221545              <code class="literal">--thread-stack-size</code> 
    15231546              <em class="parameter"><code>n</code></em>). Sets the size of the first 
    1524               thread's stack to <em class="parameter"><code>n</code></em>. (see <a class="xref" href="#Thread-Stack-Sizes" title="7.3.1. Thread Stack Sizes">Section 7.3.1, “Thread Stack Sizes”</a>)</p> 
     1547              thread's stack to <em class="parameter"><code>n</code></em>. (see <a class="xref" href="#Thread-Stack-Sizes" title="6.3.1. Thread Stack Sizes">Section 6.3.1, “Thread Stack Sizes”</a>)</p> 
    15251548              </li> 
    15261549              <li> 
    15271550                <p><code class="literal">-b</code> (or <code class="literal">--batch</code>). Execute in "batch mode". End-of-file 
    1528               from <em class="varname">*STANDARD-INPUT*</em> will cause Clozure CL to exit, as will attempts to 
     1551              from <em class="varname">*STANDARD-INPUT*</em> causes Clozure CL to exit, as do attempts to 
    15291552              enter a break loop.</p> 
    15301553              </li> 
     
    16131636                  <p>You have a working installation of GNU Emacs. If you 
    16141637                don't have a working copy of GNU Emacs, see the web page on 
    1615                 obtaining Emacs.  If you prefer to use XEmacs instead of 
    1616                 GNU Emacs,these instructions should still work; SLIME 
    1617                 supports XEmacs Version21. Mac OS X includes an Emacs 
    1618                 installation.  If you want to look into different versions, 
    1619                 you can check out theEmacsWiki, which maintains a 
    1620                 page,EmacsForMacOS,that provides much more information 
     1638                <a class="ulink" href="http://www.gnu.org/software/emacs/#Obtaining" target="_top">obtaining 
     1639                Emacs</a>.  If you prefer to use XEmacs instead of GNU 
     1640                Emacs, these instructions should still work; SLIME supports 
     1641                XEmacs Version21. Mac OS X includes an Emacs installation. 
     1642                If you want to look into different versions, you can check 
     1643                out theEmacsWiki, which maintains a 
     1644                page, EmacsForMacOS, that provides much more information 
    16211645                about using Emacs on the Mac.</p> 
    16221646                  <p>A popular version of Emacs among Mac users is 
    1623             Aquamacs. This application is a version of GNU Emac
    1624             with a number of customizations meant to make it behave 
    1625             more like a standard Macintosh application, with 
    1626             windows, a menubar, etc.  Aquamacs includes SLIME; if 
    1627             you like Aquamacs then you can use SLIME right away, 
    1628             without getting and installing it separate