Changeset 14350


Ignore:
Timestamp:
Oct 11, 2010, 5:00:21 PM (9 years ago)
Author:
gb
Message:

updated

File:
1 edited

Legend:

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

    r13831 r14350  
    55    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    66    <title>Clozure CL Documentation</title>
    7     <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
    8     <link rel="start" href="#id273960" title="Clozure CL Documentation" />
     7    <meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
     8    <link rel="home" href="#id358185" title="Clozure CL Documentation" />
    99    <link rel="next" href="#about-ccl" title="Chapter 1. About Clozure CL" />
    1010  </head>
    1111  <body>
    12     <div class="book" lang="en" xml:lang="en">
     12    <div xml:lang="en" class="book" title="Clozure CL Documentation" lang="en">
    1313      <div class="titlepage">
    1414        <div>
    1515          <div>
    16             <h1 class="title"><a id="id273960"></a>Clozure CL Documentation</h1>
     16            <h1 class="title"><a id="id358185"></a>Clozure CL Documentation</h1>
    1717          </div>
    1818        </div>
     
    766766          <p xmlns="http://www.w3.org/1999/xhtml">Features of Clozure CL include</p>
    767767          <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    768             <ul type="disc">
    769               <li>
     768            <ul class="itemizedlist" type="disc">
     769              <li class="listitem">
    770770                <p>Very fast compilation speed.</p>
    771771              </li>
    772               <li>
     772              <li class="listitem">
    773773                <p>A fast, precise, compacting, generational
    774774      garbage collector written in hand-optimized C. The sizes of the
     
    777777      systems.</p>
    778778              </li>
    779               <li>
     779              <li class="listitem">
    780780                <p>Fast execution speed, competitive with other
    781781      Common Lisp implementations on most
    782782      benchmarks.</p>
    783783              </li>
    784               <li>
     784              <li class="listitem">
    785785                <p>Robust and stable. Customers report that their
    786786      CPU-intensive, multi-threaded applications run for extended
    787787      periods on Clozure CL without difficulty.</p>
    788788              </li>
    789               <li>
     789              <li class="listitem">
    790790                <p>Full native OS threads on all platforms. Threads
    791791      are automatically distributed across multiple cores. The API
     
    793793      operations such as I/O.</p>
    794794              </li>
    795               <li>
     795              <li class="listitem">
    796796                <p>Full Unicode support.</p>
    797797              </li>
    798               <li>
     798              <li class="listitem">
    799799                <p>Full SLIME integration.</p>
    800800              </li>
    801               <li>
     801              <li class="listitem">
    802802                <p>An IDE on Mac OS X, fully integrated with
    803803      the Macintosh window system and User Interface
    804804      standards.</p>
    805805              </li>
    806               <li>
     806              <li class="listitem">
    807807                <p>Excellent debugging facilities. The names of all
    808808      local variables are available in a backtrace.</p>
    809809              </li>
    810               <li>
     810              <li class="listitem">
    811811                <p>A complete, mature foreign function interface,
    812812      including a powerful bridge to Objective-C and Cocoa on Mac OS
    813813      X.</p>
    814814              </li>
    815               <li>
     815              <li class="listitem">
    816816                <p>Many extensions including: files mapped to
    817817      Common Lisp vectors for fast file I/O; thread-local hash tables
     
    819819      and much more</p>
    820820              </li>
    821               <li>
     821              <li class="listitem">
    822822                <p>Very efficient use of memory</p>
    823823              </li>
     
    955955          <p xmlns="http://www.w3.org/1999/xhtml">Clozure CL runs on the following platforms:</p>
    956956          <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    957             <ul type="disc">
    958               <li>
     957            <ul class="itemizedlist" type="disc">
     958              <li class="listitem">
    959959                <p>Linux (x86, x86-64, ppc32, ppc64)</p>
    960960              </li>
    961               <li>
     961              <li class="listitem">
    962962                <p>Mac OS X 10.4 and later (x86, x86-64, ppc32, ppc64)</p>
    963963              </li>
    964               <li>
     964              <li class="listitem">
    965965                <p>FreeBSD 6.x and later (x86, x86-64)</p>
    966966              </li>
    967               <li>
     967              <li class="listitem">
    968968                <p>Solaris (x86, x86-64)</p>
    969969              </li>
    970               <li>
     970              <li class="listitem">
    971971                <p>Microsoft Windows XP and later (x86, x86-64)</p>
    972972              </li>
     
    11251125        </p>
    11261126            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    1127               <ul type="disc">
    1128                 <li>
     1127              <ul class="itemizedlist" type="disc">
     1128                <li class="listitem">
    11291129                  <p>darwinx86</p>
    11301130                </li>
    1131                 <li>
     1131                <li class="listitem">
    11321132                  <p>linuxx86</p>
    11331133                </li>
    1134                 <li>
     1134                <li class="listitem">
    11351135                  <p>freebsdx86</p>
    11361136                </li>
    1137                 <li>
     1137                <li class="listitem">
    11381138                  <p>solarisx86</p>
    11391139                </li>
    1140                 <li>
     1140                <li class="listitem">
    11411141                  <p>windows</p>
    11421142                </li>
    1143                 <li>
     1143                <li class="listitem">
    11441144                  <p>linuxppc</p>
    11451145                </li>
    1146                 <li>
     1146                <li class="listitem">
    11471147                  <p>darwinppc</p>
    11481148                </li>
     
    11621162        include both 32- and 64-bit binaries):</p>
    11631163            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    1164               <ul type="disc">
    1165                 <li>
     1164              <ul class="itemizedlist" type="disc">
     1165                <li class="listitem">
    11661166                  <p>darwinx86</p>
    11671167                </li>
    1168                 <li>
     1168                <li class="listitem">
    11691169                  <p>linuxx86</p>
    11701170                </li>
    1171                 <li>
     1171                <li class="listitem">
    11721172                  <p>freebsdx86</p>
    11731173                </li>
    1174                 <li>
     1174                <li class="listitem">
    11751175                  <p>solarisx86</p>
    11761176                </li>
    1177                 <li>
     1177                <li class="listitem">
    11781178                  <p>windows</p>
    11791179                </li>
    1180                 <li>
     1180                <li class="listitem">
    11811181                  <p>linuxppc</p>
    11821182                </li>
    1183                 <li>
     1183                <li class="listitem">
    11841184                  <p>darwinppc</p>
    11851185                </li>
     
    13101310            <p xmlns="http://www.w3.org/1999/xhtml">To use the script:</p>
    13111311            <div xmlns="http://www.w3.org/1999/xhtml" class="orderedlist">
    1312               <ol type="1">
    1313                 <li>
     1312              <ol class="orderedlist" type="1">
     1313                <li class="listitem">
    13141314                  <p>Copy the script to a directory that is on your
    13151315          <em class="varname">PATH</em>.  This is often
     
    13211321          modified..</p>
    13221322                </li>
    1323                 <li>
     1323                <li class="listitem">
    13241324                  <p>Edit the definition of
    13251325            <code class="literal">CCL_DEFAULT_DIRECTORY</code> near the
     
    13341334          </p>
    13351335                </li>
    1336                 <li>
     1336                <li class="listitem">
    13371337                  <p>Ensure that the shell script is executable, for
    13381338            example:</p>
     
    13451345            "ccl" in place of "ccl64".
    13461346            </p>
    1347                   <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
     1347                  <div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
    13481348                    <h3 class="title">Warning</h3>
    13491349                    <p>The above command won't work if you are not the
     
    14621462      <code class="literal">--help</code> option.</p>
    14631463          <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    1464             <ul type="disc">
    1465               <li>
     1464            <ul class="itemizedlist" type="disc">
     1465              <li class="listitem">
    14661466                <p><code class="literal">-h</code> (or
    14671467              <code class="literal">--help</code>).  Provides a definitive (if
     
    14701470              exits.</p>
    14711471              </li>
    1472               <li>
     1472              <li class="listitem">
    14731473                <p><code class="literal">-V</code> (or
    14741474              <code class="literal">--version</code>).  Prints the version of
     
    14771477              <span class="function"><strong>LISP-IMPLEMENTATION-VERSION</strong></span>.</p>
    14781478              </li>
    1479               <li>
     1479              <li class="listitem">
    14801480                <p><code class="literal">-K</code>
    14811481              <em class="parameter"><code>character-encoding-name</code></em> (or
     
    15001500              encoding.</p>
    15011501              </li>
    1502               <li>
     1502              <li class="listitem">
    15031503                <p><code class="literal">-n</code> (or
    15041504              <code class="literal">--no-init</code>). If this option is given, the
     
    15071507              whatever customizations a user might have in place.</p>
    15081508              </li>
    1509               <li>
     1509              <li class="listitem">
    15101510                <p><code class="literal">-e</code> <em class="parameter"><code>form</code></em>
    15111511              (or <code class="literal">--eval</code>). An expression is read (via
     
    15161516              shell from interpreting them.</p>
    15171517              </li>
    1518               <li>
     1518              <li class="listitem">
    15191519                <p><code class="literal">-l</code> <em class="parameter"><code>path</code></em>
    15201520              (or <code class="literal">--load</code>
     
    15221522              <em class="parameter"><code>path</code></em>.</p>
    15231523              </li>
    1524               <li>
     1524              <li class="listitem">
    15251525                <p><code class="literal">-T</code> <em class="parameter"><code>n</code></em> (or
    15261526              <code class="literal">--set-lisp-heap-gc-threshold</code>
     
    15281528              <em class="parameter"><code>n</code></em>. (see <a class="xref" href="#GC-Page-reclamation-policy" title="15.3. GC Page reclamation policy">Section 15.3, “GC Page reclamation policy”</a></p>
    15291529              </li>
    1530               <li>
     1530              <li class="listitem">
    15311531                <p><code class="literal">-Q</code> (or
    15321532              <code class="literal">--quiet</code>). Suppresses printing of
     
    15341534              command line option is specified.</p>
    15351535              </li>
    1536               <li>
     1536              <li class="listitem">
    15371537                <p><code class="literal">-R</code> <em class="parameter"><code>n</code></em> (or
    15381538              <code class="literal">--heap-reserve</code>). Reserves
     
    15401540              default is <code class="literal"> 549755813888</code>.  (see <a class="xref" href="#Heap-space-allocation" title="15.1. Heap space allocation">Section 15.1, “Heap space allocation”</a>)</p>
    15411541              </li>
    1542               <li>
     1542              <li class="listitem">
    15431543                <p><code class="literal">-S</code> <em class="parameter"><code>n</code></em> (or
    15441544              <code class="literal">--stack-size</code> <em class="parameter"><code>n</code></em>). Sets the size of the
    15451545              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>
    15461546              </li>
    1547               <li>
     1547              <li class="listitem">
    15481548                <p><code class="literal">-Z</code> <em class="parameter"><code>n</code></em> (or
    15491549              <code class="literal">--thread-stack-size</code>
     
    15511551              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>
    15521552              </li>
    1553               <li>
     1553              <li class="listitem">
    15541554                <p><code class="literal">-b</code> (or <code class="literal">--batch</code>). Execute in "batch mode". End-of-file
    15551555              from <em class="varname">*STANDARD-INPUT*</em> causes Clozure CL to exit, as do attempts to
    15561556              enter a break loop.</p>
    15571557              </li>
    1558               <li>
     1558              <li class="listitem">
    15591559                <p><code class="literal">--no-sigtrap</code> An obscure option for running under GDB.</p>
    15601560              </li>
    1561               <li>
     1561              <li class="listitem">
    15621562                <p><code class="literal">-I</code>
    15631563              <em class="parameter"><code>image-name</code></em> (or
     
    17401740          <p xmlns="http://www.w3.org/1999/xhtml">The following terms are used in subsequent sections; it
    17411741      may be helpful to refer to these definitions.</p>
    1742           <p xmlns="http://www.w3.org/1999/xhtml"><a id="id413926" class="indexterm"></a><a class="glossterm" href="#fasl-file"><em class="glossterm">fasl
     1742          <p xmlns="http://www.w3.org/1999/xhtml"><a id="id376726" class="indexterm"></a><a class="glossterm" href="#fasl-file"><em class="glossterm">fasl
    17431743        files</em></a> are the object files produced
    17441744      by <code class="literal">compile-file</code>.  fasl files store the
     
    17511751      see
    17521752      <a class="xref" href="#Platform-specific-filename-conventions" title="Table 3.1. Platform-specific filename conventions">Table 3.1, “Platform-specific filename conventions”</a> </p>
    1753           <p xmlns="http://www.w3.org/1999/xhtml">The <a id="id384832" class="indexterm"></a> <a class="glossterm" href="#lisp_kernel"><em class="glossterm">Lisp
     1753          <p xmlns="http://www.w3.org/1999/xhtml">The <a id="id371427" class="indexterm"></a> <a class="glossterm" href="#lisp_kernel"><em class="glossterm">Lisp
    17541754        kernel</em></a> is a C program with a fair amount of
    17551755      platform-specific assembly language code. Its basic job is to
     
    17611761      files on different platforms; see
    17621762      <a class="xref" href="#Platform-specific-filename-conventions" title="Table 3.1. Platform-specific filename conventions">Table 3.1, “Platform-specific filename conventions”</a>.</p>
    1763           <p xmlns="http://www.w3.org/1999/xhtml">A <a id="id414655" class="indexterm"></a> <a class="glossterm" href="#lisp_image"><em class="glossterm">heap
     1763          <p xmlns="http://www.w3.org/1999/xhtml">A <a id="id399643" class="indexterm"></a> <a class="glossterm" href="#lisp_image"><em class="glossterm">heap
    17641764        image</em></a> is a file that can be quickly mapped into a
    17651765      process's address space. Conceptually, it's not too different
     
    17721772      standard full heap image files on different platforms; see
    17731773      <a class="xref" href="#Platform-specific-filename-conventions" title="Table 3.1. Platform-specific filename conventions">Table 3.1, “Platform-specific filename conventions”</a>.</p>
    1774           <p xmlns="http://www.w3.org/1999/xhtml">A <a id="id408176" class="indexterm"></a> bootstrapping image is a minimal
     1774          <p xmlns="http://www.w3.org/1999/xhtml">A <a id="id385302" class="indexterm"></a> bootstrapping image is a minimal
    17751775      heap image used in the process of building Clozure CL itself.  The
    17761776      bootstrapping image contains just enough code to load the rest
     
    17841784      as-yet-unsupported ones) has a uniquely named subdirectory of
    17851785      <code class="literal">ccl/lisp-kernel/</code>; each such
    1786       <a id="id408201" class="indexterm"></a>
     1786      <a id="id374099" class="indexterm"></a>
    17871787      contains a Makefile and may contain some auxiliary files (linker
    17881788      scripts, etc.) that are used to build the lisp kernel on a
     
    19551955      source):</p>
    19561956          <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    1957             <ul type="disc">
    1958               <li>
     1957            <ul class="itemizedlist" type="disc">
     1958              <li class="listitem">
    19591959                <p>The released version</p>
    19601960              </li>
    1961               <li>
     1961              <li class="listitem">
    19621962                <p>The development version, called the "trunk", which
    19631963      may contain both interesting new features and interesting new bugs
     
    20242024      performs the following steps:</p>
    20252025          <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    2026             <ul type="disc">
    2027               <li>
     2026            <ul class="itemizedlist" type="disc">
     2027              <li class="listitem">
    20282028                <p>Deletes all fasl files and other object files in the
    20292029              <code class="literal">ccl</code> directory tree</p>
    20302030              </li>
    2031               <li>
     2031              <li class="listitem">
    20322032                <p>Runs an external process that does a
    20332033              <code class="literal">make</code> in the current platform's kernel
     
    20372037           </p>
    20382038              </li>
    2039               <li>
     2039              <li class="listitem">
    20402040                <p>Does <code class="literal">(compile-ccl t)</code> in the running
    20412041              lisp, to produce a set of fasl files from the “higher
    20422042              level” lisp sources.</p>
    20432043              </li>
    2044               <li>
     2044              <li class="listitem">
    20452045                <p>Does <code class="literal">(xload-level-0 :force)</code> in the
    20462046              running lisp, to compile the lisp sources in the
     
    20492049              files.</p>
    20502050              </li>
    2051               <li>
     2051              <li class="listitem">
    20522052                <p>Runs another external process, which causes the newly
    20532053              compiled lisp kernel to load the new bootstrapping image.
     
    21112111            available tools:</p>
    21122112            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    2113               <ul type="disc">
    2114                 <li>
     2113              <ul class="itemizedlist" type="disc">
     2114                <li class="listitem">
    21152115                  <p>cc or gcc- the GNU C compiler</p>
    21162116                </li>
    2117                 <li>
     2117                <li class="listitem">
    21182118                  <p>ld - the GNU linker</p>
    21192119                </li>
    2120                 <li>
     2120                <li class="listitem">
    21212121                  <p>m4 or gm4- the GNU m4 macro processor</p>
    21222122                </li>
    2123                 <li>
     2123                <li class="listitem">
    21242124                  <p>as - the GNU assembler (version 2.10.1 or later)</p>
    21252125                </li>
    2126                 <li>
     2126                <li class="listitem">
    21272127                  <p>make - either GNU make or, on FreeBSD, the default BSD make program</p>
    21282128                </li>
     
    21422142            <code class="literal">gm4</code> on FreeBSD) should be installed.
    21432143          </p>
    2144             <div xmlns="http://www.w3.org/1999/xhtml" class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
     2144            <div xmlns="http://www.w3.org/1999/xhtml" class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
    21452145              <h3 class="title">Note</h3>
    21462146              <p>In order to build the lisp kernel on Mac OS X
     
    22122212        following steps:</p>
    22132213            <div xmlns="http://www.w3.org/1999/xhtml" class="orderedlist">
    2214               <ol type="1">
    2215                 <li>
     2214              <ol class="orderedlist" type="1">
     2215                <li class="listitem">
    22162216                  <p>Using your existing Clozure CL, create a
    22172217            bootstrapping image</p>
    22182218                </li>
    2219                 <li>
     2219                <li class="listitem">
    22202220                  <p>Using your existing Clozure CL, recompile your
    22212221            updated Clozure CL sources</p>
    22222222                </li>
    2223                 <li>
     2223                <li class="listitem">
    22242224                  <p>Invoke Clozure CL with the bootstrapping image
    22252225            you just created (rather than with the existing full heap
     
    22342234            <p xmlns="http://www.w3.org/1999/xhtml">A few points worth noting:</p>
    22352235            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    2236               <ul type="disc">
    2237                 <li>
     2236              <ul class="itemizedlist" type="disc">
     2237                <li class="listitem">
    22382238                  <p>There's a circular dependency between the full heap
    22392239                image and the bootstrapping image, in that each is used to
    22402240                build the other.</p>
    22412241                </li>
    2242                 <li>
     2242                <li class="listitem">
    22432243                  <p>There are some minor implementation
    22442244                differences, but the environment in effect after the
     
    22482248                distribute, of course.</p>
    22492249                </li>
    2250                 <li>
     2250                <li class="listitem">
    22512251                  <p>If the full heap image doesn't work (because
    22522252                of an OS compatibilty problem or other bug), it's very likely
     
    25962596    </p>
    25972597          <p xmlns="http://www.w3.org/1999/xhtml">
    2598       <a id="id409696" class="indexterm"></a>
     2598      <a id="id381075" class="indexterm"></a>
    25992599      <span class="command"><strong><em class="varname"><a id="trace"></a>TRACE</em> {<em class="replaceable"><code>keyword</code></em>
    26002600        <em class="replaceable"><code>global-value</code></em>}* {<em class="replaceable"><code>spec</code></em> |
     
    30403040          </div>
    30413041          <p xmlns="http://www.w3.org/1999/xhtml">
    3042       <a id="id429371" class="indexterm"></a>
     3042      <a id="id412917" class="indexterm"></a>
    30433043      <span class="command"><strong><em class="varname"><a id="trace-level"></a>CCL:*TRACE-LEVEL*</em>    [Variable]</strong></span>
    30443044    </p>
    30453045          <p xmlns="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>
    30463046          <p xmlns="http://www.w3.org/1999/xhtml">
    3047       <a id="id429396" class="indexterm"></a>
     3047      <a id="id412944" class="indexterm"></a>
    30483048      <span class="command"><strong><em class="varname"><a id="trace-max-indent"></a>CCL:*TRACE-MAX-INDENT*</em>    [Variable]</strong></span>
    30493049    </p>
    30503050          <p xmlns="http://www.w3.org/1999/xhtml">The default before and after print actions will not indent by more than the value of <em class="varname">ccl:*trace-max-indent*</em> regardless of the current trace level.</p>
    30513051          <p xmlns="http://www.w3.org/1999/xhtml">
    3052       <a id="id429426" class="indexterm"></a>
     3052      <a id="id412972" class="indexterm"></a>
    30533053      <span class="command"><strong><em class="varname"><a id="trace-function"></a>CCL:TRACE-FUNCTION</em> <em class="replaceable"><code>spec</code></em> <em class="varname">&amp;key</em> {<em class="replaceable"><code>keyword</code></em> <em class="replaceable"><code>value</code></em>}*    [Function]</strong></span>
    30543054    </p>
     
    30583058    </p>
    30593059          <p xmlns="http://www.w3.org/1999/xhtml">
    3060       <a id="id429474" class="indexterm"></a>
     3060      <a id="id413021" class="indexterm"></a>
    30613061      <span class="command"><strong><em class="varname"><a id="trace-print-level"></a>CCL:*TRACE-PRINT-LEVEL*</em>   [Variable]</strong></span>
    30623062    </p>
     
    30663066      explicit printing done by user code.</p>
    30673067          <p xmlns="http://www.w3.org/1999/xhtml">
    3068       <a id="id429509" class="indexterm"></a>
     3068      <a id="id413056" class="indexterm"></a>
    30693069      <span class="command"><strong><em class="varname"><a id="trace-print-length"></a>CCL:*TRACE-PRINT-LENGTH*</em>    [Variable]</strong></span>
    30703070    </p>
     
    30743074      explicit printing done by user code.</p>
    30753075          <p xmlns="http://www.w3.org/1999/xhtml">
    3076       <a id="id429544" class="indexterm"></a>
     3076      <a id="id413090" class="indexterm"></a>
    30773077      <span class="command"><strong><em class="varname"><a id="trace-bar-frequency"></a>CCL:*TRACE-BAR-FREQUENCY*</em>    [Variable]</strong></span>
    30783078    </p>
     
    31233123            <div>
    31243124              <div class="refsect1" lang="en" xml:lang="en">
    3125                 <a xmlns="http://www.w3.org/1999/xhtml" id="id429707"></a>
     3125                <a xmlns="http://www.w3.org/1999/xhtml" id="id413253"></a>
    31263126                <div class="header">Arguments and Values:</div>
    31273127                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">spec</span></i>---
     
    31583158              </div>
    31593159              <div class="refsect1" lang="en" xml:lang="en">
    3160                 <a xmlns="http://www.w3.org/1999/xhtml" id="id429814"></a>
     3160                <a xmlns="http://www.w3.org/1999/xhtml" id="id413359"></a>
    31613161                <div class="header">Examples:</div>
    31623162                <p xmlns="http://www.w3.org/1999/xhtml">
     
    32033203            <div>
    32043204              <div class="refsect1" lang="en" xml:lang="en">
    3205                 <a xmlns="http://www.w3.org/1999/xhtml" id="id429913"></a>
     3205                <a xmlns="http://www.w3.org/1999/xhtml" id="id413458"></a>
    32063206                <div class="header">Description:</div>
    32073207                <p xmlns="http://www.w3.org/1999/xhtml">
     
    32183218              </div>
    32193219              <div class="refsect1" lang="en" xml:lang="en">
    3220                 <a xmlns="http://www.w3.org/1999/xhtml" id="id429980"></a>
     3220                <a xmlns="http://www.w3.org/1999/xhtml" id="id413525"></a>
    32213221                <div class="header">Arguments and Values:</div>
    32223222                <p xmlns="http://www.w3.org/1999/xhtml">
     
    32423242            <div>
    32433243              <div class="refsect1" lang="en" xml:lang="en">
    3244                 <a xmlns="http://www.w3.org/1999/xhtml" id="id430058"></a>
     3244                <a xmlns="http://www.w3.org/1999/xhtml" id="id413603"></a>
    32453245                <div class="header">Description:</div>
    32463246                <p xmlns="http://www.w3.org/1999/xhtml">
     
    32543254              </div>
    32553255              <div class="refsect1" lang="en" xml:lang="en">
    3256                 <a xmlns="http://www.w3.org/1999/xhtml" id="id430106"></a>
     3256                <a xmlns="http://www.w3.org/1999/xhtml" id="id413651"></a>
    32573257                <div class="header">Arguments and Values:</div>
    32583258                <p xmlns="http://www.w3.org/1999/xhtml">
     
    34213421              <div>
    34223422                <div class="refsect1" lang="en" xml:lang="en">
    3423                   <a xmlns="http://www.w3.org/1999/xhtml" id="id430668"></a>
     3423                  <a xmlns="http://www.w3.org/1999/xhtml" id="id414213"></a>
    34243424                  <div class="header">Arguments and Values:</div>
    34253425                  <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">domain</span></i>---This is used to indicate where the external
     
    34553455                </div>
    34563456                <div class="refsect1" lang="en" xml:lang="en">
    3457                   <a xmlns="http://www.w3.org/1999/xhtml" id="id443577"></a>
     3457                  <a xmlns="http://www.w3.org/1999/xhtml" id="id428653"></a>
    34583458                  <div class="header">Description:</div>
    34593459                  <p xmlns="http://www.w3.org/1999/xhtml">Despite the function's name, it doesn't necessarily create a
     
    36233623                <div>
    36243624                  <div>
    3625                     <h4 class="title"><a id="id443880"></a>4.5.4.1. Encoding Problems</h4>
     3625                    <h4 class="title"><a id="id428956"></a>4.5.4.1. Encoding Problems</h4>
    36263626                  </div>
    36273627                </div>
     
    36393639                <div>
    36403640                  <div>
    3641                     <h4 class="title"><a id="id443892"></a>4.5.4.2. Byte Order Marks</h4>
     3641                    <h4 class="title"><a id="id428968"></a>4.5.4.2. Byte Order Marks</h4>
    36423642                  </div>
    36433643                </div>
     
    36673667                <div>
    36683668                  <div>
    3669                     <h4 class="title"><a id="id443927"></a>4.5.4.3. <span class="function"><strong>DESCRIBE-CHARACTER-ENCODINGS</strong></span></h4>
     3669                    <h4 class="title"><a id="id429003"></a>4.5.4.3. <span class="function"><strong>DESCRIBE-CHARACTER-ENCODINGS</strong></span></h4>
    36703670                  </div>
    36713671                </div>
     
    36893689                <div>
    36903690                  <div class="refsect1" lang="en" xml:lang="en">
    3691                     <a xmlns="http://www.w3.org/1999/xhtml" id="id443988"></a>
     3691                    <a xmlns="http://www.w3.org/1999/xhtml" id="id429064"></a>
    36923692                    <div class="header">Description:</div>
    36933693                    <p xmlns="http://www.w3.org/1999/xhtml">Writes descriptions of all defined character encodings
     
    36983698                  </div>
    36993699                  <div class="refsect1" lang="en" xml:lang="en">
    3700                     <a xmlns="http://www.w3.org/1999/xhtml" id="id444003"></a>
     3700                    <a xmlns="http://www.w3.org/1999/xhtml" id="id429079"></a>
    37013701                    <div class="header">See Also:</div>
    37023702                    <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#Character-Encodings" title="4.5.4. Character Encodings">Section 4.5.4, “Character Encodings”</a>, <a class="xref" href="#External-Formats" title="4.5.2. External Formats">Section 4.5.2, “External Formats”</a>, <a class="xref" href="#Supported-Character-Encodings" title="4.5.4.4. Supported Character Encodings">Section 4.5.4.4, “Supported Character Encodings”</a></span>
     
    41294129                <div>
    41304130                  <div>
    4131                     <h4 class="title"><a id="id444682"></a>4.5.4.5. Encoding and Decoding Strings</h4>
     4131                    <h4 class="title"><a id="id429758"></a>4.5.4.5. Encoding and Decoding Strings</h4>
    41324132                  </div>
    41334133                </div>
     
    41544154                <div>
    41554155                  <div class="refsect1" lang="en" xml:lang="en">
    4156                     <a xmlns="http://www.w3.org/1999/xhtml" id="id444758"></a>
     4156                    <a xmlns="http://www.w3.org/1999/xhtml" id="id429834"></a>
    41574157                    <div class="header">Description:</div>
    41584158                    <p xmlns="http://www.w3.org/1999/xhtml">
     
    41854185                <div>
    41864186                  <div class="refsect1" lang="en" xml:lang="en">
    4187                     <a xmlns="http://www.w3.org/1999/xhtml" id="id444853"></a>
     4187                    <a xmlns="http://www.w3.org/1999/xhtml" id="id429929"></a>
    41884188                    <div class="header">Description:</div>
    41894189                    <p xmlns="http://www.w3.org/1999/xhtml">
     
    42284228                <div>
    42294229                  <div class="refsect1" lang="en" xml:lang="en">
    4230                     <a xmlns="http://www.w3.org/1999/xhtml" id="id444977"></a>
     4230                    <a xmlns="http://www.w3.org/1999/xhtml" id="id430052"></a>
    42314231                    <div class="header">Description:</div>
    42324232                    <p xmlns="http://www.w3.org/1999/xhtml">
     
    42744274                <div>
    42754275                  <div class="refsect1" lang="en" xml:lang="en">
    4276                     <a xmlns="http://www.w3.org/1999/xhtml" id="id445096"></a>
     4276                    <a xmlns="http://www.w3.org/1999/xhtml" id="id430172"></a>
    42774277                    <div class="header">Description:</div>
    42784278                    <p xmlns="http://www.w3.org/1999/xhtml">
     
    43244324            </div>
    43254325            <p xmlns="http://www.w3.org/1999/xhtml">Clozure CL sets up logical pathname translations for logical hosts:  <code class="literal">ccl</code> and <code class="literal">home</code></p>
    4326             <a xmlns="http://www.w3.org/1999/xhtml" id="id445184" class="indexterm"></a>
     4326            <a xmlns="http://www.w3.org/1999/xhtml" id="id430260" class="indexterm"></a>
    43274327            <p xmlns="http://www.w3.org/1999/xhtml">The <code class="literal">CCL</code> logical host should point to the
    43284328        <code class="literal">ccl</code> directory.  It is used for a variety of
     
    44284428      platforms.</p>
    44294429          <p xmlns="http://www.w3.org/1999/xhtml">
    4430       <a id="id445368" class="indexterm"></a>
     4430      <a id="id430443" class="indexterm"></a>
    44314431      <span class="command"><strong><em class="varname"><a id="map-file-to-ivector"></a>CCL:MAP-FILE-TO-IVECTOR</em>
    44324432        <em class="parameter"><code>pathname</code></em>
     
    44884488      a memory error.</p>
    44894489          <p xmlns="http://www.w3.org/1999/xhtml">
    4490       <a id="id445501" class="indexterm"></a>
     4490      <a id="id430576" class="indexterm"></a>
    44914491      <span class="command"><strong><em class="varname"><a id="unmap-ivector"></a>CCL:UNMAP-IVECTOR</em>
    44924492        <em class="parameter"><code>displaced-array</code></em>
     
    45004500      target is an empty vector (of length zero).</p>
    45014501          <p xmlns="http://www.w3.org/1999/xhtml">
    4502       <a id="id445536" class="indexterm"></a>
     4502      <a id="id430612" class="indexterm"></a>
    45034503      <span class="command"><strong><em class="varname"><a id="map-file-to-octet-vector"></a>CCL:MAP-FILE-TO-OCTET-VECTOR</em>
    45044504        <em class="parameter"><code>pathname</code></em>
     
    45104510      bytes.</p>
    45114511          <p xmlns="http://www.w3.org/1999/xhtml">
    4512       <a id="id445568" class="indexterm"></a>
     4512      <a id="id430644" class="indexterm"></a>
    45134513      <span class="command"><strong><em class="varname"><a id="unmap-octet-vector"></a>CCL:UNMAP-OCTET-VECTOR</em>
    45144514        <em class="parameter"><code>displaced-array</code></em>
     
    45494549      static.</p>
    45504550          <p xmlns="http://www.w3.org/1999/xhtml">
    4551       <a id="id445643" class="indexterm"></a>
     4551      <a id="id430718" class="indexterm"></a>
    45524552      <span class="command"><strong><em class="varname"><a id="defstatic"></a>DEFSTATIC</em>
    45534553        <em class="parameter"><code>var</code></em>
     
    46034603            </div>
    46044604          </div>
    4605           <a xmlns="http://www.w3.org/1999/xhtml" id="id445755" class="indexterm"></a>
     4605          <a xmlns="http://www.w3.org/1999/xhtml" id="id430830" class="indexterm"></a>
    46064606          <p xmlns="http://www.w3.org/1999/xhtml">Clozure CL provides the
    46074607      function <code class="literal">CCL:SAVE-APPLICATION</code>, which creates a file
     
    46834683      converted, because address 0 can always be relied upon to refer to
    46844684      the same thing.</p>
    4685           <a xmlns="http://www.w3.org/1999/xhtml" id="id445976" class="indexterm"></a>
     4685          <a xmlns="http://www.w3.org/1999/xhtml" id="id431052" class="indexterm"></a>
    46864686          <p xmlns="http://www.w3.org/1999/xhtml">As of Clozure CL 1.2, the constant <code class="literal">CCL:+NULL-PTR+</code>
    46874687      refers to a <code class="literal">MACPTR</code> object that points to address 0.</p>
     
    46944694      or <code class="literal">opencml64</code> script.</p>
    46954695          <p xmlns="http://www.w3.org/1999/xhtml">
    4696       <a id="id446024" class="indexterm"></a>
     4696      <a id="id431099" class="indexterm"></a>
    46974697      <span class="command"><strong><em class="varname"><a id="save-application"></a>SAVE-APPLICATION</em>
    46984698        <em class="parameter"><code>filename</code></em>
     
    48184818            <div>
    48194819              <div class="refsect1" lang="en" xml:lang="en">
    4820                 <a xmlns="http://www.w3.org/1999/xhtml" id="id446295"></a>
     4820                <a xmlns="http://www.w3.org/1999/xhtml" id="id431370"></a>
    48214821                <div class="header">Arguments and Values:</div>
    48224822                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">out-file</span></i>---
     
    48324832              </div>
    48334833              <div class="refsect1" lang="en" xml:lang="en">
    4834                 <a xmlns="http://www.w3.org/1999/xhtml" id="id446355"></a>
     4834                <a xmlns="http://www.w3.org/1999/xhtml" id="id431430"></a>
    48354835                <div class="header">Description:</div>
    48364836                <p xmlns="http://www.w3.org/1999/xhtml">
     
    48924892            <div>
    48934893              <div class="refsect1" lang="en" xml:lang="en">
    4894                 <a xmlns="http://www.w3.org/1999/xhtml" id="id446445"></a>
     4894                <a xmlns="http://www.w3.org/1999/xhtml" id="id431521"></a>
    48954895                <div class="header">Arguments and Values:</div>
    48964896                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">mode</span></i>---
     
    49004900              </div>
    49014901              <div class="refsect1" lang="en" xml:lang="en">
    4902                 <a xmlns="http://www.w3.org/1999/xhtml" id="id446469"></a>
     4902                <a xmlns="http://www.w3.org/1999/xhtml" id="id431544"></a>
    49034903                <div class="header">Description:</div>
    49044904                <p xmlns="http://www.w3.org/1999/xhtml">
     
    49394939            <div>
    49404940              <div class="refsect1" lang="en" xml:lang="en">
    4941                 <a xmlns="http://www.w3.org/1999/xhtml" id="id446564"></a>
     4941                <a xmlns="http://www.w3.org/1999/xhtml" id="id431640"></a>
    49424942                <div class="header">Arguments and Values:</div>
    49434943                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">rounding-mode</span></i>---
     
    49484948              </div>
    49494949              <div class="refsect1" lang="en" xml:lang="en">
    4950                 <a xmlns="http://www.w3.org/1999/xhtml" id="id446600"></a>
     4950                <a xmlns="http://www.w3.org/1999/xhtml" id="id431676"></a>
    49514951                <div class="header">Description:</div>
    49524952                <p xmlns="http://www.w3.org/1999/xhtml">
     
    49974997              <div>
    49984998                <div class="refsect1" lang="en" xml:lang="en">
    4999                   <a xmlns="http://www.w3.org/1999/xhtml" id="id446675"></a>
     4999                  <a xmlns="http://www.w3.org/1999/xhtml" id="id431751"></a>
    50005000                  <div class="header">Arguments and Values:</div>
    50015001                  <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">object</span></i>---
     
    50045004                </div>
    50055005                <div class="refsect1" lang="en" xml:lang="en">
    5006                   <a xmlns="http://www.w3.org/1999/xhtml" id="id446698"></a>
     5006                  <a xmlns="http://www.w3.org/1999/xhtml" id="id431773"></a>
    50075007                  <div class="header">Description:</div>
    50085008                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    51715171              <div>
    51725172                <div class="refsect1" lang="en" xml:lang="en">
    5173                   <a xmlns="http://www.w3.org/1999/xhtml" id="id446872"></a>
     5173                  <a xmlns="http://www.w3.org/1999/xhtml" id="id431948"></a>
    51745174                  <div class="header">Description:</div>
    51755175                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    52055205              <div>
    52065206                <div class="refsect1" lang="en" xml:lang="en">
    5207                   <a xmlns="http://www.w3.org/1999/xhtml" id="id446920"></a>
     5207                  <a xmlns="http://www.w3.org/1999/xhtml" id="id431996"></a>
    52085208                  <div class="header">Discussion:</div>
    52095209                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    52235223                </div>
    52245224                <div class="refsect1" lang="en" xml:lang="en">
    5225                   <a xmlns="http://www.w3.org/1999/xhtml" id="id446974"></a>
     5225                  <a xmlns="http://www.w3.org/1999/xhtml" id="id432049"></a>
    52265226                  <div class="header">Restarts:</div>
    52275227                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    52915291                <div>
    52925292                  <div>
    5293                     <h4 class="title"><a id="id447031"></a>4.12.5.1. Fancy arrays</h4>
     5293                    <h4 class="title"><a id="id432107"></a>4.12.5.1. Fancy arrays</h4>
    52945294                  </div>
    52955295                </div>
     
    53185318                <div>
    53195319                  <div>
    5320                     <h4 class="title"><a id="id447050"></a>4.12.5.2. Hash tables</h4>
     5320                    <h4 class="title"><a id="id432126"></a>4.12.5.2. Hash tables</h4>
    53215321                  </div>
    53225322                </div>
     
    53665366                <div>
    53675367                  <div>
    5368                     <h4 class="title"><a id="id447081"></a>4.12.5.3. Lists</h4>
     5368                    <h4 class="title"><a id="id432156"></a>4.12.5.3. Lists</h4>
    53695369                  </div>
    53705370                </div>
     
    54145414</p>
    54155415            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    5416               <ul type="disc">
    5417                 <li>
     5416              <ul class="itemizedlist" type="disc">
     5417                <li class="listitem">
    54185418                  <p>
    54195419      Not covered: this form was never entered.
    54205420    </p>
    54215421                </li>
    5422                 <li>
     5422                <li class="listitem">
    54235423                  <p>
    54245424      Partly covered: This form was entered, and some parts were
     
    54265426    </p>
    54275427                </li>
    5428                 <li>
     5428                <li class="listitem">
    54295429                  <p>
    54305430      Fully covered: Every bit of code generated from this form was
     
    55355535              <div>
    55365536                <div class="refsect1" lang="en" xml:lang="en">
    5537                   <a xmlns="http://www.w3.org/1999/xhtml" id="id447263"></a>
     5537                  <a xmlns="http://www.w3.org/1999/xhtml" id="id432338"></a>
    55385538                  <div class="header">Arguments and Values:</div>
    55395539                  <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">html</span></i>---
     
    55575557                </div>
    55585558                <div class="refsect1" lang="en" xml:lang="en">
    5559                   <a xmlns="http://www.w3.org/1999/xhtml" id="id447315"></a>
     5559                  <a xmlns="http://www.w3.org/1999/xhtml" id="id432391"></a>
    55605560                  <div class="header">Example:</div>
    55615561                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    55915591              <div>
    55925592                <div class="refsect1" lang="en" xml:lang="en">
    5593                   <a xmlns="http://www.w3.org/1999/xhtml" id="id447395"></a>
     5593                  <a xmlns="http://www.w3.org/1999/xhtml" id="id432471"></a>
    55945594                  <div class="header">Summary:</div>
    55955595                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    56135613              <div>
    56145614                <div class="refsect1" lang="en" xml:lang="en">
    5615                   <a xmlns="http://www.w3.org/1999/xhtml" id="id447433"></a>
     5615                  <a xmlns="http://www.w3.org/1999/xhtml" id="id432509"></a>
    56165616                  <div class="header">Summary:</div>
    56175617                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    56395639              <div>
    56405640                <div class="refsect1" lang="en" xml:lang="en">
    5641                   <a xmlns="http://www.w3.org/1999/xhtml" id="id447486"></a>
     5641                  <a xmlns="http://www.w3.org/1999/xhtml" id="id432562"></a>
    56425642                  <div class="header">Summary:</div>
    56435643                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    56655665              <div>
    56665666                <div class="refsect1" lang="en" xml:lang="en">
    5667                   <a xmlns="http://www.w3.org/1999/xhtml" id="id447538"></a>
     5667                  <a xmlns="http://www.w3.org/1999/xhtml" id="id432613"></a>
    56685668                  <div class="header">Summary:</div>
    56695669                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    56965696              <div>
    56975697                <div class="refsect1" lang="en" xml:lang="en">
    5698                   <a xmlns="http://www.w3.org/1999/xhtml" id="id447581"></a>
     5698                  <a xmlns="http://www.w3.org/1999/xhtml" id="id432656"></a>
    56995699                  <div class="header">Summary:</div>
    57005700                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    57235723              <div>
    57245724                <div class="refsect1" lang="en" xml:lang="en">
    5725                   <a xmlns="http://www.w3.org/1999/xhtml" id="id447634"></a>
     5725                  <a xmlns="http://www.w3.org/1999/xhtml" id="id432709"></a>
    57265726                  <div class="header">Summary:</div>
    57275727                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    57465746              <div>
    57475747                <div class="refsect1" lang="en" xml:lang="en">
    5748                   <a xmlns="http://www.w3.org/1999/xhtml" id="id447684"></a>
     5748                  <a xmlns="http://www.w3.org/1999/xhtml" id="id432760"></a>
    57495749                  <div class="header">Summary:</div>
    57505750                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    57735773              <div>
    57745774                <div class="refsect1" lang="en" xml:lang="en">
    5775                   <a xmlns="http://www.w3.org/1999/xhtml" id="id447737"></a>
     5775                  <a xmlns="http://www.w3.org/1999/xhtml" id="id432812"></a>
    57765776                  <div class="header">Summary:</div>
    57775777                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    58005800              <div>
    58015801                <div class="refsect1" lang="en" xml:lang="en">
    5802                   <a xmlns="http://www.w3.org/1999/xhtml" id="id447790"></a>
     5802                  <a xmlns="http://www.w3.org/1999/xhtml" id="id432865"></a>
    58035803                  <div class="header">Summary:</div>
    58045804                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    59675967              <div>
    59685968                <div class="refsect1" lang="en" xml:lang="en">
    5969                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448025"></a>
     5969                  <a xmlns="http://www.w3.org/1999/xhtml" id="id433100"></a>
    59705970                  <div class="header">Summary:</div>
    59715971                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    59925992              <div>
    59935993                <div class="refsect1" lang="en" xml:lang="en">
    5994                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448077"></a>
     5994                  <a xmlns="http://www.w3.org/1999/xhtml" id="id433152"></a>
    59955995                  <div class="header">Summary:</div>
    59965996                  <p xmlns="http://www.w3.org/1999/xhtml">
     
    61156115      process.</p>
    61166116          <div xmlns="http://www.w3.org/1999/xhtml" class="orderedlist">
    6117             <ol type="1">
    6118               <li>
     6117            <ol class="orderedlist" type="1">
     6118              <li class="listitem">
    61196119                <p>In a shell session, cd to the ccl directory.</p>
    61206120              </li>
    6121               <li>
     6121              <li class="listitem">
    61226122                <p>Run ccl from the shell. The easiest way to do this is
    61236123          generally to execute the ccl or ccl64 command.</p>
    61246124              </li>
    6125               <li>
     6125              <li class="listitem">
    61266126                <p>Evaluate the form <code class="code">(require :cocoa-application)</code></p>
    61276127              </li>
     
    62236223                <div>
    62246224                  <div>
    6225                     <h4 class="title"><a id="id420320"></a>5.4.2.1. Checking for Updates</h4>
     6225                    <h4 class="title"><a id="id390877"></a>5.4.2.1. Checking for Updates</h4>
    62266226                  </div>
    62276227                </div>
     
    63556355      the required subsystems, if necessary.</p>
    63566356          <p xmlns="http://www.w3.org/1999/xhtml">
    6357       <a id="id388581" class="indexterm"></a>
     6357      <a id="id384329" class="indexterm"></a>
    63586358      <span class="command"><strong><em class="varname"><a id="build-application"></a>BUILD-APPLICATION</em> <em class="varname">&amp;key</em>
    63596359        (<em class="parameter"><code>name</code></em> <em class="replaceable"><code>"MyApplication"</code></em>)
     
    66556655                <dt>
    66566656                  <span class="sect2">
    6657                     <a href="#id412859">6.3.2.  As of August 2003:</a>
     6657                    <a href="#id395013">6.3.2.  As of August 2003:</a>
    66586658                  </span>
    66596659                </dt>
     
    67786778      change has a number of subtle effects:</p>
    67796779          <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    6780             <ul type="disc">
    6781               <li>
     6780            <ul class="itemizedlist" type="disc">
     6781              <li class="listitem">
    67826782                <p>it is possible for two (or more) lisp threads to be
    67836783              executing simultaneously, possibly trying to access and/or
     
    67906790              objects.</p>
    67916791              </li>
    6792               <li>
     6792              <li class="listitem">
    67936793                <p>even on a single-processor system, a context switch
    67946794              can happen on any instruction boundary. Since (in general)
     
    68016801              ... vehemently.</p>
    68026802              </li>
    6803               <li>
     6803              <li class="listitem">
    68046804                <p>there is no simple and efficient way to "inhibit the
    68056805              scheduler"or otherwise gain exclusive access to the entire
    68066806              CPU.</p>
    68076807              </li>
    6808               <li>
     6808              <li class="listitem">
    68096809                <p>There are a variety of simple and efficient ways
    68106810              to synchronize access to particular data
     
    68416841      implementation.</p>
    68426842          <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    6843             <ul type="disc">
    6844               <li>
     6843            <ul class="itemizedlist" type="disc">
     6844              <li class="listitem">
    68456845                <p>PROCESS-RUN-REASONS and PROCESS-ARREST-REASONS were
    68466846              SETFable process attributes; each was just a list of
     
    68546854              occupy their time productively.)</p>
    68556855              </li>
    6856               <li>
     6856              <li class="listitem">
    68576857                <p>There were a number of primitives for maintaining
    68586858              process queues;that's now the OS's job.</p>
    68596859              </li>
    6860               <li>
     6860              <li class="listitem">
    68616861                <p>Cooperative threads were based on coroutining
    68626862              primitives associated with objects of type
     
    69066906              <div>
    69076907                <div>
    6908                   <h3 class="title"><a id="id412859"></a>6.3.2.  As of August 2003:</h3>
     6908                  <h3 class="title"><a id="id395013"></a>6.3.2.  As of August 2003:</h3>
    69096909                </div>
    69106910              </div>
    69116911            </div>
    69126912            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    6913               <ul type="disc">
    6914                 <li>
     6913              <ul class="itemizedlist" type="disc">
     6914                <li class="listitem">
    69156915                  <p>It's not clear that exposing
    69166916                PROCESS-SUSPEND/PROCESS-RESUME is a good idea: it's not clear
     
    69186918                ways to lose.</p>
    69196919                </li>
    6920                 <li>
     6920                <li class="listitem">
    69216921                  <p>It has traditionally been possible to reset and enable
    69226922                a process that's "exhausted" . (As used here, the
     
    69326932                (and to make PROCESS-ENABLE detect this error.)</p>
    69336933                </li>
    6934                 <li>
     6934                <li class="listitem">
    69356935                  <p>When native threads that aren't created by Clozure CL
    69366936                first call into lisp, a "foreign process" is created, and
     
    69636963      a few things that one should look at carefully:</p>
    69646964          <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    6965             <ul type="disc">
    6966               <li>
     6965            <ul class="itemizedlist" type="disc">
     6966              <li class="listitem">
    69676967                <p>It's wise to be suspicious of most uses
    69686968              of WITHOUT-INTERRUPTS; there may be exceptions, but
     
    69736973              time.</p>
    69746974              </li>
    6975               <li>
     6975              <li class="listitem">
    69766976                <p>I've only seen one case where a process's "run reasons"
    69776977              were used to communicate information as well as to control
     
    69806980            </p>
    69816981              </li>
    6982               <li>
     6982              <li class="listitem">
    69836983                <p>It's certainly possible that programs written
    69846984              for cooperatively scheduled lisps that have run reliably for
     
    73587358            <div>
    73597359              <div class="refsect1" lang="en" xml:lang="en">
    7360                 <a xmlns="http://www.w3.org/1999/xhtml" id="id434884"></a>
     7360                <a xmlns="http://www.w3.org/1999/xhtml" id="id419941"></a>
    73617361                <div class="header">Values:</div>
    73627362                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">result</span></i>---a list of all lisp processes (threads)
     
    73647364              </div>
    73657365              <div class="refsect1" lang="en" xml:lang="en">
    7366                 <a xmlns="http://www.w3.org/1999/xhtml" id="id434910"></a>
     7366                <a xmlns="http://www.w3.org/1999/xhtml" id="id419966"></a>
    73677367                <div class="header">Description:</div>
    73687368                <p xmlns="http://www.w3.org/1999/xhtml">Returns a list of all lisp processes (threads) known
     
    73767376              </div>
    73777377              <div class="refsect1" lang="en" xml:lang="en">
    7378                 <a xmlns="http://www.w3.org/1999/xhtml" id="id434924"></a>
     7378                <a xmlns="http://www.w3.org/1999/xhtml" id="id419981"></a>
    73797379                <div class="header">See Also:</div>
    73807380                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist">
     
    74047404            <div>
    74057405              <div class="refsect1" lang="en" xml:lang="en">
    7406                 <a xmlns="http://www.w3.org/1999/xhtml" id="id434994"></a>
     7406                <a xmlns="http://www.w3.org/1999/xhtml" id="id420051"></a>
    74077407                <div class="header">Arguments and Values:</div>
    74087408                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---a string, used to identify the process.</p>
     
    74437443              </div>
    74447444              <div class="refsect1" lang="en" xml:lang="en">
    7445                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435182"></a>
     7445                <a xmlns="http://www.w3.org/1999/xhtml" id="id420236"></a>
    74467446                <div class="header">Description:</div>
    74477447                <p xmlns="http://www.w3.org/1999/xhtml">Creates and returns a new lisp process (thread) with the
     
    74647464              </div>
    74657465              <div class="refsect1" lang="en" xml:lang="en">
    7466                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435234"></a>
     7466                <a xmlns="http://www.w3.org/1999/xhtml" id="id420288"></a>
    74677467                <div class="header">See Also:</div>
    74687468                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-preset" title="Function PROCESS-PRESET"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-preset</b></a>, <a class="xref" href="#f_process-enable" title="Function PROCESS-ENABLE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-enable</b></a>, <a class="xref" href="#f_process-run-function" title="Function PROCESS-RUN-FUNCTION"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-run-function</b></a></span>
     
    74837483            <div>
    74847484              <div class="refsect1" lang="en" xml:lang="en">
    7485                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435312"></a>
     7485                <a xmlns="http://www.w3.org/1999/xhtml" id="id420367"></a>
    74867486                <div class="header">Arguments and Values:</div>
    74877487                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p>
     
    74937493              </div>
    74947494              <div class="refsect1" lang="en" xml:lang="en">
    7495                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435366"></a>
     7495                <a xmlns="http://www.w3.org/1999/xhtml" id="id420421"></a>
    74967496                <div class="header">Description:</div>
    74977497                <p xmlns="http://www.w3.org/1999/xhtml">Suspends <em class="varname">process</em>, preventing it from
     
    75157515              </div>
    75167516              <div class="refsect1" lang="en" xml:lang="en">
    7517                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435421"></a>
     7517                <a xmlns="http://www.w3.org/1999/xhtml" id="id420476"></a>
    75187518                <div class="header">See Also:</div>
    75197519                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-resume" title="Function PROCESS-RESUME"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-resume</b></a>, <a class="xref" href="#f_process-suspend-count" title="Function PROCESS-SUSPEND-COUNT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-suspend-count</b></a></span>
    75207520              </div>
    75217521              <div class="refsect1" lang="en" xml:lang="en">
    7522                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435446"></a>
     7522                <a xmlns="http://www.w3.org/1999/xhtml" id="id420501"></a>
    75237523                <div class="header">Notes:</div>
    75247524                <p xmlns="http://www.w3.org/1999/xhtml"><span class="function"><strong>process-suspend</strong></span> was previously called
     
    75467546            <div>
    75477547              <div class="refsect1" lang="en" xml:lang="en">
    7548                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435528"></a>
     7548                <a xmlns="http://www.w3.org/1999/xhtml" id="id420582"></a>
    75497549                <div class="header">Arguments and Values:</div>
    75507550                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p>
     
    75577557              </div>
    75587558              <div class="refsect1" lang="en" xml:lang="en">
    7559                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435582"></a>
     7559                <a xmlns="http://www.w3.org/1999/xhtml" id="id420636"></a>
    75607560                <div class="header">Description:</div>
    75617561                <p xmlns="http://www.w3.org/1999/xhtml">Undoes the effect of a previous call to
     
    75687568              </div>
    75697569              <div class="refsect1" lang="en" xml:lang="en">
    7570                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435613"></a>
     7570                <a xmlns="http://www.w3.org/1999/xhtml" id="id420667"></a>
    75717571                <div class="header">See Also:</div>
    75727572                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-suspend" title="Function PROCESS-SUSPEND"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-suspend</b></a>, <a class="xref" href="#f_process-suspend-count" title="Function PROCESS-SUSPEND-COUNT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-suspend-count</b></a></span>
    75737573              </div>
    75747574              <div class="refsect1" lang="en" xml:lang="en">
    7575                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435638"></a>
     7575                <a xmlns="http://www.w3.org/1999/xhtml" id="id420692"></a>
    75767576                <div class="header">Notes:</div>
    75777577                <p xmlns="http://www.w3.org/1999/xhtml">
     
    75997599            <div>
    76007600              <div class="refsect1" lang="en" xml:lang="en">
    7601                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435703"></a>
     7601                <a xmlns="http://www.w3.org/1999/xhtml" id="id420757"></a>
    76027602                <div class="header">Arguments and Values:</div>
    76037603                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p>
     
    76097609              </div>
    76107610              <div class="refsect1" lang="en" xml:lang="en">
    7611                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435756"></a>
     7611                <a xmlns="http://www.w3.org/1999/xhtml" id="id420810"></a>
    76127612                <div class="header">Description:</div>
    76137613                <p xmlns="http://www.w3.org/1999/xhtml">An "outstanding" <a class="xref" href="#f_process-suspend" title="Function PROCESS-SUSPEND"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-suspend</b></a> call
     
    76247624              </div>
    76257625              <div class="refsect1" lang="en" xml:lang="en">
    7626                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435807"></a>
     7626                <a xmlns="http://www.w3.org/1999/xhtml" id="id420860"></a>
    76277627                <div class="header">See Also:</div>
    76287628                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-suspend" title="Function PROCESS-SUSPEND"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-suspend</b></a>, <a class="xref" href="#f_process-resume" title="Function PROCESS-RESUME"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-resume</b></a></span>
     
    76457645            <div>
    76467646              <div class="refsect1" lang="en" xml:lang="en">
    7647                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435883"></a>
     7647                <a xmlns="http://www.w3.org/1999/xhtml" id="id420936"></a>
    76487648                <div class="header">Arguments and Values:</div>
    76497649                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p>
     
    76567656              </div>
    76577657              <div class="refsect1" lang="en" xml:lang="en">
    7658                 <a xmlns="http://www.w3.org/1999/xhtml" id="id435958"></a>
     7658                <a xmlns="http://www.w3.org/1999/xhtml" id="id421011"></a>
    76597659                <div class="header">Description:</div>
    76607660                <p xmlns="http://www.w3.org/1999/xhtml">Typically used to initialize a newly-created or newly-reset
     
    76707670              </div>
    76717671              <div class="refsect1" lang="en" xml:lang="en">
    7672                 <a xmlns="http://www.w3.org/1999/xhtml" id="id436002"></a>
     7672                <a xmlns="http://www.w3.org/1999/xhtml" id="id421055"></a>
    76737673                <div class="header">See Also:</div>
    76747674                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-process" title="Function MAKE-PROCESS"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-process</b></a>, <a class="xref" href="#f_process-enable" title="Function PROCESS-ENABLE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-enable</b></a>, <a class="xref" href="#f_process-run-function" title="Function PROCESS-RUN-FUNCTION"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-run-function</b></a></span>
     
    76917691            <div>
    76927692              <div class="refsect1" lang="en" xml:lang="en">
    7693                 <a xmlns="http://www.w3.org/1999/xhtml" id="id436084"></a>
     7693                <a xmlns="http://www.w3.org/1999/xhtml" id="id421138"></a>
    76947694                <div class="header">Arguments and Values:</div>
    76957695                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p>
     
    77007700              </div>
    77017701              <div class="refsect1" lang="en" xml:lang="en">
    7702                 <a xmlns="http://www.w3.org/1999/xhtml" id="id436147"></a>
     7702                <a xmlns="http://www.w3.org/1999/xhtml" id="id421199"></a>
    77037703                <div class="header">Description:</div>
    77047704                <p xmlns="http://www.w3.org/1999/xhtml">Tries to begin the execution of <em class="varname">process</em>.
     
    77177717              </div>
    77187718              <div class="refsect1" lang="en" xml:lang="en">
    7719                 <a xmlns="http://www.w3.org/1999/xhtml" id="id436196"></a>
     7719                <a xmlns="http://www.w3.org/1999/xhtml" id="id421248"></a>
    77207720                <div class="header">See Also:</div>
    77217721                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-process" title="Function MAKE-PROCESS"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-process</b></a>, <a class="xref" href="#f_process-preset" title="Function PROCESS-PRESET"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-preset</b></a>, <a class="xref" href="#f_process-run-function" title="Function PROCESS-RUN-FUNCTION"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-run-function</b></a></span>
    77227722              </div>
    77237723              <div class="refsect1" lang="en" xml:lang="en">
    7724                 <a xmlns="http://www.w3.org/1999/xhtml" id="id436226"></a>
     7724                <a xmlns="http://www.w3.org/1999/xhtml" id="id421279"></a>
    77257725                <div class="header">Notes:</div>
    77267726                <p xmlns="http://www.w3.org/1999/xhtml">It would be nice to have more discussion of what it means
     
    77437743            <div>
    77447744              <div class="refsect1" lang="en" xml:lang="en">
    7745                 <a xmlns="http://www.w3.org/1999/xhtml" id="id436342"></a>
     7745                <a xmlns="http://www.w3.org/1999/xhtml" id="id421394"></a>
    77467746                <div class="header">Arguments and Values:</div>
    77477747                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---a string, used to identify the process.
     
    77657765              </div>
    77667766              <div class="refsect1" lang="en" xml:lang="en">
    7767                 <a xmlns="http://www.w3.org/1999/xhtml" id="id436531"></a>
     7767                <a xmlns="http://www.w3.org/1999/xhtml" id="id421583"></a>
    77687768                <div class="header">Description:</div>
    77697769                <p xmlns="http://www.w3.org/1999/xhtml">Creates a lisp process (thread) via
     
    77787778              </div>
    77797779              <div class="refsect1" lang="en" xml:lang="en">
    7780                 <a xmlns="http://www.w3.org/1999/xhtml" id="id436566"></a>
     7780                <a xmlns="http://www.w3.org/1999/xhtml" id="id421618"></a>
    77817781                <div class="header">See Also:</div>
    77827782                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-process" title="Function MAKE-PROCESS"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-process</b></a>, <a class="xref" href="#f_process-preset" title="Function PROCESS-PRESET"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-preset</b></a>, <a class="xref" href="#f_process-enable" title="Function PROCESS-ENABLE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-enable</b></a></span>
     
    77997799            <div>
    78007800              <div class="refsect1" lang="en" xml:lang="en">
    7801                 <a xmlns="http://www.w3.org/1999/xhtml" id="id441432"></a>
     7801                <a xmlns="http://www.w3.org/1999/xhtml" id="id395211"></a>
    78027802                <div class="header">Arguments and Values:</div>
    78037803                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p>
     
    78127812              </div>
    78137813              <div class="refsect1" lang="en" xml:lang="en">
    7814                 <a xmlns="http://www.w3.org/1999/xhtml" id="id441524"></a>
     7814                <a xmlns="http://www.w3.org/1999/xhtml" id="id425021"></a>
    78157815                <div class="header">Description:</div>
    78167816                <p xmlns="http://www.w3.org/1999/xhtml">Arranges for <em class="varname">process</em>
     
    78437843              </div>
    78447844              <div class="refsect1" lang="en" xml:lang="en">
    7845                 <a xmlns="http://www.w3.org/1999/xhtml" id="id441599"></a>
     7845                <a xmlns="http://www.w3.org/1999/xhtml" id="id425096"></a>
    78467846                <div class="header">See Also:</div>
    78477847                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist">
     
    78527852              </div>
    78537853              <div class="refsect1" lang="en" xml:lang="en">
    7854                 <a xmlns="http://www.w3.org/1999/xhtml" id="id441618"></a>
     7854                <a xmlns="http://www.w3.org/1999/xhtml" id="id425115"></a>
    78557855                <div class="header">Notes:</div>
    78567856                <p xmlns="http://www.w3.org/1999/xhtml">It would probably be better for <em class="varname">result</em>
     
    78827882            <div>
    78837883              <div class="refsect1" lang="en" xml:lang="en">
    7884                 <a xmlns="http://www.w3.org/1999/xhtml" id="id441685"></a>
     7884                <a xmlns="http://www.w3.org/1999/xhtml" id="id425180"></a>
    78857885                <div class="header">Value Type:</div>
    78867886                <p xmlns="http://www.w3.org/1999/xhtml">A lisp process (thread).</p>
    78877887              </div>
    78887888              <div class="refsect1" lang="en" xml:lang="en">
    7889                 <a xmlns="http://www.w3.org/1999/xhtml" id="id441696"></a>
     7889                <a xmlns="http://www.w3.org/1999/xhtml" id="id425191"></a>
    78907890                <div class="header">Initial Value:</div>
    78917891                <p xmlns="http://www.w3.org/1999/xhtml">Bound separately in each process, to that process itself.
     
    78937893              </div>
    78947894              <div class="refsect1" lang="en" xml:lang="en">
    7895                 <a xmlns="http://www.w3.org/1999/xhtml" id="id441708"></a>
     7895                <a xmlns="http://www.w3.org/1999/xhtml" id="id425203"></a>
    78967896                <div class="header">Description:</div>
    78977897                <p xmlns="http://www.w3.org/1999/xhtml">Used when lisp code needs to find out what process it is
     
    78997899              </div>
    79007900              <div class="refsect1" lang="en" xml:lang="en">
    7901                 <a xmlns="http://www.w3.org/1999/xhtml" id="id441720"></a>
     7901                <a xmlns="http://www.w3.org/1999/xhtml" id="id425215"></a>
    79027902                <div class="header">See Also:</div>
    79037903                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist">
     
    79237923            <div>
    79247924              <div class="refsect1" lang="en" xml:lang="en">
    7925                 <a xmlns="http://www.w3.org/1999/xhtml" id="id441791"></a>
     7925                <a xmlns="http://www.w3.org/1999/xhtml" id="id425285"></a>
    79267926                <div class="header">Arguments and Values:</div>
    79277927                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p>
     
    79307930              </div>
    79317931              <div class="refsect1" lang="en" xml:lang="en">
    7932                 <a xmlns="http://www.w3.org/1999/xhtml" id="id441847"></a>
     7932                <a xmlns="http://www.w3.org/1999/xhtml" id="id425342"></a>
    79337933                <div class="header">Description:</div>
    79347934                <p xmlns="http://www.w3.org/1999/xhtml">Causes <em class="varname">process</em> to cleanly exit
     
    79577957              </div>
    79587958              <div class="refsect1" lang="en" xml:lang="en">
    7959                 <a xmlns="http://www.w3.org/1999/xhtml" id="id441915"></a>
     7959                <a xmlns="http://www.w3.org/1999/xhtml" id="id425409"></a>
    79607960                <div class="header">See Also:</div>
    79617961                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-kill" title="Function PROCESS-KILL"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-kill</b></a>, <a class="xref" href="#f_process-abort" title="Function PROCESS-ABORT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-abort</b></a></span>
     
    79777977            <div>
    79787978              <div class="refsect1" lang="en" xml:lang="en">
    7979                 <a xmlns="http://www.w3.org/1999/xhtml" id="id441988"></a>
     7979                <a xmlns="http://www.w3.org/1999/xhtml" id="id425482"></a>
    79807980                <div class="header">Arguments and Values:</div>
    79817981                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p>
     
    79837983              </div>
    79847984              <div class="refsect1" lang="en" xml:lang="en">
    7985                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442030"></a>
     7985                <a xmlns="http://www.w3.org/1999/xhtml" id="id425523"></a>
    79867986                <div class="header">Description:</div>
    79877987                <p xmlns="http://www.w3.org/1999/xhtml">Entirely equivalent to calling
     
    79907990              </div>
    79917991              <div class="refsect1" lang="en" xml:lang="en">
    7992                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442045"></a>
     7992                <a xmlns="http://www.w3.org/1999/xhtml" id="id425538"></a>
    79937993                <div class="header">See Also:</div>
    79947994                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-reset" title="Function PROCESS-RESET"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-reset</b></a>, <a class="xref" href="#f_process-abort" title="Function PROCESS-ABORT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-abort</b></a></span>
     
    80128012            <div>
    80138013              <div class="refsect1" lang="en" xml:lang="en">
    8014                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442128"></a>
     8014                <a xmlns="http://www.w3.org/1999/xhtml" id="id425622"></a>
    80158015                <div class="header">Arguments and Values:</div>
    80168016                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p>
     
    80188018              </div>
    80198019              <div class="refsect1" lang="en" xml:lang="en">
    8020                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442170"></a>
     8020                <a xmlns="http://www.w3.org/1999/xhtml" id="id425663"></a>
    80218021                <div class="header">Description:</div>
    80228022                <p xmlns="http://www.w3.org/1999/xhtml">Entirely equivalent to calling
     
    80328032              </div>
    80338033              <div class="refsect1" lang="en" xml:lang="en">
    8034                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442233"></a>
     8034                <a xmlns="http://www.w3.org/1999/xhtml" id="id425726"></a>
    80358035                <div class="header">See Also:</div>
    80368036                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-reset" title="Function PROCESS-RESET"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-reset</b></a>, <a class="xref" href="#f_process-kill" title="Function PROCESS-KILL"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-kill</b></a></span>
     
    80518051            <div>
    80528052              <div class="refsect1" lang="en" xml:lang="en">
    8053                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442292"></a>
     8053                <a xmlns="http://www.w3.org/1999/xhtml" id="id425785"></a>
    80548054                <div class="header">Value Type:</div>
    80558055                <p xmlns="http://www.w3.org/1999/xhtml">A positive integer.</p>
    80568056              </div>
    80578057              <div class="refsect1" lang="en" xml:lang="en">
    8058                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442303"></a>
     8058                <a xmlns="http://www.w3.org/1999/xhtml" id="id425796"></a>
    80598059                <div class="header">Initial Value:</div>
    80608060                <p xmlns="http://www.w3.org/1999/xhtml">The clock resolution of the OS scheduler.  Currently,
     
    80638063              </div>
    80648064              <div class="refsect1" lang="en" xml:lang="en">
    8065                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442315"></a>
     8065                <a xmlns="http://www.w3.org/1999/xhtml" id="id425808"></a>
    80668066                <div class="header">Description:</div>
    80678067                <p xmlns="http://www.w3.org/1999/xhtml">This value is ordinarily of marginal interest at best,
     
    80718071              </div>
    80728072              <div class="refsect1" lang="en" xml:lang="en">
    8073                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442328"></a>
     8073                <a xmlns="http://www.w3.org/1999/xhtml" id="id425821"></a>
    80748074                <div class="header">See Also:</div>
    80758075                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist">
     
    80958095            <div>
    80968096              <div class="refsect1" lang="en" xml:lang="en">
    8097                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442433"></a>
     8097                <a xmlns="http://www.w3.org/1999/xhtml" id="id425926"></a>
    80988098                <div class="header">Description:</div>
    80998099                <p xmlns="http://www.w3.org/1999/xhtml">This information is primarily for the benefit of
     
    81098109              </div>
    81108110              <div class="refsect1" lang="en" xml:lang="en">
    8111                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442476"></a>
     8111                <a xmlns="http://www.w3.org/1999/xhtml" id="id425969"></a>
    81128112                <div class="header">See Also:</div>
    81138113                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-wait" title="Function PROCESS-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-wait</b></a>, <a class="xref" href="#f_process-wait-with-timeout" title="Function PROCESS-WAIT-WITH-TIMEOUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-wait-with-timeout</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
    81148114              </div>
    81158115              <div class="refsect1" lang="en" xml:lang="en">
    8116                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442506"></a>
     8116                <a xmlns="http://www.w3.org/1999/xhtml" id="id426000"></a>
    81178117                <div class="header">Notes:</div>
    81188118                <p xmlns="http://www.w3.org/1999/xhtml">This should arguably be SETFable, but doesn't seem to
     
    81388138            <div>
    81398139              <div class="refsect1" lang="en" xml:lang="en">
    8140                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442565"></a>
     8140                <a xmlns="http://www.w3.org/1999/xhtml" id="id426058"></a>
    81418141                <div class="header">Description:</div>
    81428142                <p xmlns="http://www.w3.org/1999/xhtml">Advises the OS scheduler that the current thread has nothing
     
    81478147              </div>
    81488148              <div class="refsect1" lang="en" xml:lang="en">
    8149                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442579"></a>
     8149                <a xmlns="http://www.w3.org/1999/xhtml" id="id426072"></a>
    81508150                <div class="header">See Also:</div>
    81518151                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
    81528152              </div>
    81538153              <div class="refsect1" lang="en" xml:lang="en">
    8154                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442627"></a>
     8154                <a xmlns="http://www.w3.org/1999/xhtml" id="id426120"></a>
    81558155                <div class="header">Notes:</div>
    81568156                <p xmlns="http://www.w3.org/1999/xhtml">This is a holdover from the days of cooperative
     
    81758175            <div>
    81768176              <div class="refsect1" lang="en" xml:lang="en">
    8177                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442691"></a>
     8177                <a xmlns="http://www.w3.org/1999/xhtml" id="id426184"></a>
    81788178                <div class="header">Arguments and Values:</div>
    81798179                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">whostate</span></i>---a string, which will be the value of
     
    81888188              </div>
    81898189              <div class="refsect1" lang="en" xml:lang="en">
    8190                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442771"></a>
     8190                <a xmlns="http://www.w3.org/1999/xhtml" id="id426264"></a>
    81918191                <div class="header">Description:</div>
    81928192                <p xmlns="http://www.w3.org/1999/xhtml">Causes the current lisp process (thread) to repeatedly
     
    82058205              </div>
    82068206              <div class="refsect1" lang="en" xml:lang="en">
    8207                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442807"></a>
     8207                <a xmlns="http://www.w3.org/1999/xhtml" id="id426300"></a>
    82088208                <div class="header">See Also:</div>
    82098209                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-whostate" title="Function PROCESS-WHOSTATE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-whostate</b></a>, <a class="xref" href="#f_process-wait-with-timeout" title="Function PROCESS-WAIT-WITH-TIMEOUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-wait-with-timeout</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
     
    82258225            <div>
    82268226              <div class="refsect1" lang="en" xml:lang="en">
    8227                 <a xmlns="http://www.w3.org/1999/xhtml" id="id442915"></a>
     8227                <a xmlns="http://www.w3.org/1999/xhtml" id="id426408"></a>
    82288228                <div class="header">Arguments and Values:</div>
    82298229                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">whostate</span></i>---a string, which will be the value of
     
    82438243              </div>
    82448244              <div class="refsect1" lang="en" xml:lang="en">
    8245                 <a xmlns="http://www.w3.org/1999/xhtml" id="id443029"></a>
     8245                <a xmlns="http://www.w3.org/1999/xhtml" id="id426522"></a>
    82468246                <div class="header">Description:</div>
    82478247                <p xmlns="http://www.w3.org/1999/xhtml">If <em class="varname">ticks</em> is NIL, behaves exactly like
     
    82608260              </div>
    82618261              <div class="refsect1" lang="en" xml:lang="en">
    8262                 <a xmlns="http://www.w3.org/1999/xhtml" id="id443079"></a>
     8262                <a xmlns="http://www.w3.org/1999/xhtml" id="id426572"></a>
    82638263                <div class="header">See Also:</div>
    82648264                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#v_ticks-per-second" title="Variable *TICKS-PER-SECOND*"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">*ticks-per-second*</b></a>, <a class="xref" href="#f_process-whostate" title="Function PROCESS-WHOSTATE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-whostate</b></a>, <a class="xref" href="#f_process-wait" title="Function PROCESS-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-wait</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
     
    82808280            <div>
    82818281              <div class="refsect1" lang="en" xml:lang="en">
    8282                 <a xmlns="http://www.w3.org/1999/xhtml" id="id443196"></a>
     8282                <a xmlns="http://www.w3.org/1999/xhtml" id="id426689"></a>
    82838283                <div class="header">Arguments and Values:</div>
    82848284                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">body</span></i>---an implicit progn.</p>
     
    82878287              </div>
    82888288              <div class="refsect1" lang="en" xml:lang="en">
    8289                 <a xmlns="http://www.w3.org/1999/xhtml" id="id443241"></a>
     8289                <a xmlns="http://www.w3.org/1999/xhtml" id="id426734"></a>
    82908290                <div class="header">Description:</div>
    82918291                <p xmlns="http://www.w3.org/1999/xhtml">Executes <em class="varname">body</em>
     
    83028302              </div>
    83038303              <div class="refsect1" lang="en" xml:lang="en">
    8304                 <a xmlns="http://www.w3.org/1999/xhtml" id="id443272"></a>
     8304                <a xmlns="http://www.w3.org/1999/xhtml" id="id426766"></a>
    83058305                <div class="header">See Also:</div>
    83068306                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist">
     
    83268326            <div>
    83278327              <div class="refsect1" lang="en" xml:lang="en">
    8328                 <a xmlns="http://www.w3.org/1999/xhtml" id="id443344"></a>
     8328                <a xmlns="http://www.w3.org/1999/xhtml" id="id426837"></a>
    83298329                <div class="header">Arguments and Values:</div>
    83308330                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---any lisp object; saved as part of
     
    83368336              </div>
    83378337              <div class="refsect1" lang="en" xml:lang="en">
    8338                 <a xmlns="http://www.w3.org/1999/xhtml" id="id443396"></a>
     8338                <a xmlns="http://www.w3.org/1999/xhtml" id="id426890"></a>
    83398339                <div class="header">Description:</div>
    83408340                <p xmlns="http://www.w3.org/1999/xhtml">Creates and returns a lock object, which can
     
    83468346              </div>
    83478347              <div class="refsect1" lang="en" xml:lang="en">
    8348                 <a xmlns="http://www.w3.org/1999/xhtml" id="id443413"></a>
     8348                <a xmlns="http://www.w3.org/1999/xhtml" id="id426906"></a>
    83498349                <div class="header">See Also:</div>
    83508350                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#m_with-lock-grabbed" title="Macro WITH-LOCK-GRABBED"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-lock-grabbed</b></a>, <a class="xref" href="#f_grab-lock" title="Function GRAB-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a>, <a class="xref" href="#f_release-lock" title="Function RELEASE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">release-lock</b></a>, <a class="xref" href="#f_try-lock" title="Function TRY-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">try-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
     
    83668366            <div>
    83678367              <div class="refsect1" lang="en" xml:lang="en">
    8368                 <a xmlns="http://www.w3.org/1999/xhtml" id="id443530"></a>
     8368                <a xmlns="http://www.w3.org/1999/xhtml" id="id427023"></a>
    83698369                <div class="header">Arguments and Values:</div>
    83708370                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">lock</span></i>---an object of type CCL:LOCK.</p>
     
    83748374              </div>
    83758375              <div class="refsect1" lang="en" xml:lang="en">
    8376                 <a xmlns="http://www.w3.org/1999/xhtml" id="id454684"></a>
     8376                <a xmlns="http://www.w3.org/1999/xhtml" id="id439755"></a>
    83778377                <div class="header">Description:</div>
    83788378                <p xmlns="http://www.w3.org/1999/xhtml">Waits until <em class="varname">lock</em> is either free or
     
    83858385              </div>
    83868386              <div class="refsect1" lang="en" xml:lang="en">
    8387                 <a xmlns="http://www.w3.org/1999/xhtml" id="id454712"></a>
     8387                <a xmlns="http://www.w3.org/1999/xhtml" id="id439784"></a>
    83888388                <div class="header">See Also:</div>
    83898389                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_grab-lock" title="Function GRAB-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a>, <a class="xref" href="#f_release-lock" title="Function RELEASE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">release-lock</b></a>, <a class="xref" href="#f_try-lock" title="Function TRY-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">try-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
     
    84048404            <div>
    84058405              <div class="refsect1" lang="en" xml:lang="en">
    8406                 <a xmlns="http://www.w3.org/1999/xhtml" id="id454812"></a>
     8406                <a xmlns="http://www.w3.org/1999/xhtml" id="id439884"></a>
    84078407                <div class="header">Arguments and Values:</div>
    84088408                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">lock</span></i>---an object of type CCL:LOCK.</p>
    84098409              </div>
    84108410              <div class="refsect1" lang="en" xml:lang="en">
    8411                 <a xmlns="http://www.w3.org/1999/xhtml" id="id454834"></a>
     8411                <a xmlns="http://www.w3.org/1999/xhtml" id="id439906"></a>
    84128412                <div class="header">Description:</div>
    84138413                <p xmlns="http://www.w3.org/1999/xhtml">Blocks until <em class="varname">lock</em> is owned by the
     
    84208420              </div>
    84218421              <div class="refsect1" lang="en" xml:lang="en">
    8422                 <a xmlns="http://www.w3.org/1999/xhtml" id="id454868"></a>
     8422                <a xmlns="http://www.w3.org/1999/xhtml" id="id439940"></a>
    84238423                <div class="header">See Also:</div>
    84248424                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#m_with-lock-grabbed" title="Macro WITH-LOCK-GRABBED"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-lock-grabbed</b></a>, <a class="xref" href="#f_release-lock" title="Function RELEASE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">release-lock</b></a>, <a class="xref" href="#f_try-lock" title="Function TRY-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">try-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
     
    84388438            <div>
    84398439              <div class="refsect1" lang="en" xml:lang="en">
    8440                 <a xmlns="http://www.w3.org/1999/xhtml" id="id454967"></a>
     8440                <a xmlns="http://www.w3.org/1999/xhtml" id="id440039"></a>
    84418441                <div class="header">Arguments and Values:</div>
    84428442                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">lock</span></i>---an object of type CCL:LOCK.</p>
    84438443              </div>
    84448444              <div class="refsect1" lang="en" xml:lang="en">
    8445                 <a xmlns="http://www.w3.org/1999/xhtml" id="id454989"></a>
     8445                <a xmlns="http://www.w3.org/1999/xhtml" id="id440062"></a>
    84468446                <div class="header">Description:</div>
    84478447                <p xmlns="http://www.w3.org/1999/xhtml">Signals an error of type CCL:LOCK-NOT-OWNER if
     
    84568456              </div>
    84578457              <div class="refsect1" lang="en" xml:lang="en">
    8458                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455023"></a>
     8458                <a xmlns="http://www.w3.org/1999/xhtml" id="id440095"></a>
    84598459                <div class="header">See Also:</div>
    84608460                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#m_with-lock-grabbed" title="Macro WITH-LOCK-GRABBED"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-lock-grabbed</b></a>, <a class="xref" href="#f_grab-lock" title="Function GRAB-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a>, <a class="xref" href="#f_try-lock" title="Function TRY-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">try-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
     
    84758475            <div>
    84768476              <div class="refsect1" lang="en" xml:lang="en">
    8477                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455123"></a>
     8477                <a xmlns="http://www.w3.org/1999/xhtml" id="id440195"></a>
    84788478                <div class="header">Arguments and Values:</div>
    84798479                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">lock</span></i>---an object of type CCL:LOCK.</p>
     
    84828482              </div>
    84838483              <div class="refsect1" lang="en" xml:lang="en">
    8484                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455162"></a>
     8484                <a xmlns="http://www.w3.org/1999/xhtml" id="id440234"></a>
    84858485                <div class="header">Description:</div>
    84868486                <p xmlns="http://www.w3.org/1999/xhtml">Tests whether <em class="varname">lock</em>
     
    84958495              </div>
    84968496              <div class="refsect1" lang="en" xml:lang="en">
    8497                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455185"></a>
     8497                <a xmlns="http://www.w3.org/1999/xhtml" id="id440257"></a>
    84988498                <div class="header">See Also:</div>
    84998499                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#m_with-lock-grabbed" title="Macro WITH-LOCK-GRABBED"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-lock-grabbed</b></a>, <a class="xref" href="#f_grab-lock" title="Function GRAB-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a>, <a class="xref" href="#f_release-lock" title="Function RELEASE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">release-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
     
    85158515            <div>
    85168516              <div class="refsect1" lang="en" xml:lang="en">
    8517                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455285"></a>
     8517                <a xmlns="http://www.w3.org/1999/xhtml" id="id440357"></a>
    85188518                <div class="header">Arguments and Values:</div>
    85198519                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">read-write-lock</span></i>---a newly-allocated object of type
     
    85218521              </div>
    85228522              <div class="refsect1" lang="en" xml:lang="en">
    8523                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455308"></a>
     8523                <a xmlns="http://www.w3.org/1999/xhtml" id="id440380"></a>
    85248524                <div class="header">Description:</div>
    85258525                <p xmlns="http://www.w3.org/1999/xhtml">Creates and returns an object of type CCL::READ-WRITE-LOCK.
     
    85328532              </div>
    85338533              <div class="refsect1" lang="en" xml:lang="en">
    8534                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455324"></a>
     8534                <a xmlns="http://www.w3.org/1999/xhtml" id="id440396"></a>
    85358535                <div class="header">See Also:</div>
    85368536                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#m_with-read-lock" title="Macro WITH-READ-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-read-lock</b></a>, <a class="xref" href="#m_with-write-lock" title="Macro WITH-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-write-lock</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
    85378537              </div>
    85388538              <div class="refsect1" lang="en" xml:lang="en">
    8539                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455372"></a>
     8539                <a xmlns="http://www.w3.org/1999/xhtml" id="id440444"></a>
    85408540                <div class="header">Notes:</div>
    85418541                <p xmlns="http://www.w3.org/1999/xhtml">There probably should be some way to
     
    85608560            <div>
    85618561              <div class="refsect1" lang="en" xml:lang="en">
    8562                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455428"></a>
     8562                <a xmlns="http://www.w3.org/1999/xhtml" id="id440500"></a>
    85638563                <div class="header">Arguments and Values:</div>
    85648564                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">read-write-lock</span></i>---an object of type
     
    85698569              </div>
    85708570              <div class="refsect1" lang="en" xml:lang="en">
    8571                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455480"></a>
     8571                <a xmlns="http://www.w3.org/1999/xhtml" id="id440552"></a>
    85728572                <div class="header">Description:</div>
    85738573                <p xmlns="http://www.w3.org/1999/xhtml">Waits until <em class="varname">read-write-lock</em> has no
     
    85838583              </div>
    85848584              <div class="refsect1" lang="en" xml:lang="en">
    8585                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455519"></a>
     8585                <a xmlns="http://www.w3.org/1999/xhtml" id="id440592"></a>
    85868586                <div class="header">See Also:</div>
    85878587                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#m_with-write-lock" title="Macro WITH-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-write-lock</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
     
    86038603            <div>
    86048604              <div class="refsect1" lang="en" xml:lang="en">
    8605                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455613"></a>
     8605                <a xmlns="http://www.w3.org/1999/xhtml" id="id440685"></a>
    86068606                <div class="header">Arguments and Values:</div>
    86078607                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">read-write-lock</span></i>---an object of type
     
    86128612              </div>
    86138613              <div class="refsect1" lang="en" xml:lang="en">
    8614                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455664"></a>
     8614                <a xmlns="http://www.w3.org/1999/xhtml" id="id440736"></a>
    86158615                <div class="header">Description:</div>
    86168616                <p xmlns="http://www.w3.org/1999/xhtml">Waits until <em class="varname">read-write-lock</em> has no
     
    86278627              </div>
    86288628              <div class="refsect1" lang="en" xml:lang="en">
    8629                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455709"></a>
     8629                <a xmlns="http://www.w3.org/1999/xhtml" id="id440781"></a>
    86308630                <div class="header">See Also:</div>
    86318631                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#m_with-read-lock" title="Macro WITH-READ-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-read-lock</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
     
    86478647            <div>
    86488648              <div class="refsect1" lang="en" xml:lang="en">
    8649                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455798"></a>
     8649                <a xmlns="http://www.w3.org/1999/xhtml" id="id440871"></a>
    86508650                <div class="header">Arguments and Values:</div>
    86518651                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">semaphore</span></i>---a newly-allocated object of type CCL:SEMAPHORE.</p>
    86528652              </div>
    86538653              <div class="refsect1" lang="en" xml:lang="en">
    8654                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455821"></a>
     8654                <a xmlns="http://www.w3.org/1999/xhtml" id="id440893"></a>
    86558655                <div class="header">Description:</div>
    86568656                <p xmlns="http://www.w3.org/1999/xhtml">Creates and returns an object of type CCL:SEMAPHORE.
     
    86618661              </div>
    86628662              <div class="refsect1" lang="en" xml:lang="en">
    8663                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455836"></a>
     8663                <a xmlns="http://www.w3.org/1999/xhtml" id="id440908"></a>
    86648664                <div class="header">See Also:</div>
    86658665                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_signal-semaphore" title="Function SIGNAL-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">signal-semaphore</b></a>, <a class="xref" href="#f_wait-on-semaphore" title="Function WAIT-ON-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">wait-on-semaphore</b></a>, <a class="xref" href="#f_timed-wait-on-semaphore" title="Function TIMED-WAIT-ON-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">timed-wait-on-semaphore</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
     
    86818681            <div>
    86828682              <div class="refsect1" lang="en" xml:lang="en">
    8683                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455931"></a>
     8683                <a xmlns="http://www.w3.org/1999/xhtml" id="id441003"></a>
    86848684                <div class="header">Arguments and Values:</div>
    86858685                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">semaphore</span></i>---an object of type CCL:SEMAPHORE.</p>
     
    86888688              </div>
    86898689              <div class="refsect1" lang="en" xml:lang="en">
    8690                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455967"></a>
     8690                <a xmlns="http://www.w3.org/1999/xhtml" id="id441039"></a>
    86918691                <div class="header">Description:</div>
    86928692                <p xmlns="http://www.w3.org/1999/xhtml">Atomically increments <em class="varname">semaphore</em>'s
     
    86958695              </div>
    86968696              <div class="refsect1" lang="en" xml:lang="en">
    8697                 <a xmlns="http://www.w3.org/1999/xhtml" id="id455981"></a>
     8697                <a xmlns="http://www.w3.org/1999/xhtml" id="id441053"></a>
    86988698                <div class="header">See Also:</div>
    86998699                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_wait-on-semaphore" title="Function WAIT-ON-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">wait-on-semaphore</b></a>, <a class="xref" href="#f_timed-wait-on-semaphore" title="Function TIMED-WAIT-ON-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">timed-wait-on-semaphore</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
    87008700              </div>
    87018701              <div class="refsect1" lang="en" xml:lang="en">
    8702                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456034"></a>
     8702                <a xmlns="http://www.w3.org/1999/xhtml" id="id441106"></a>
    87038703                <div class="header">Notes:</div>
    87048704                <p xmlns="http://www.w3.org/1999/xhtml"><em class="varname">result</em> should probably be interpreted
     
    87238723            <div>
    87248724              <div class="refsect1" lang="en" xml:lang="en">
    8725                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456094"></a>
     8725                <a xmlns="http://www.w3.org/1999/xhtml" id="id441166"></a>
    87268726                <div class="header">Arguments and Values:</div>
    87278727                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">semaphore</span></i>---an object of type CCL:SEMAPHORE.</p>
     
    87308730              </div>
    87318731              <div class="refsect1" lang="en" xml:lang="en">
    8732                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456130"></a>
     8732                <a xmlns="http://www.w3.org/1999/xhtml" id="id441202"></a>
    87338733                <div class="header">Description:</div>
    87348734                <p xmlns="http://www.w3.org/1999/xhtml">Waits until <em class="varname">semaphore</em>
     
    87388738              </div>
    87398739              <div class="refsect1" lang="en" xml:lang="en">
    8740                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456144"></a>
     8740                <a xmlns="http://www.w3.org/1999/xhtml" id="id441216"></a>
    87418741                <div class="header">See Also:</div>
    87428742                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_signal-semaphore" title="Function SIGNAL-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">signal-semaphore</b></a>, <a class="xref" href="#f_timed-wait-on-semaphore" title="Function TIMED-WAIT-ON-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">timed-wait-on-semaphore</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
    87438743              </div>
    87448744              <div class="refsect1" lang="en" xml:lang="en">
    8745                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456197"></a>
     8745                <a xmlns="http://www.w3.org/1999/xhtml" id="id441270"></a>
    87468746                <div class="header">Notes:</div>
    87478747                <p xmlns="http://www.w3.org/1999/xhtml"><em class="varname">result</em> should probably be interpreted
     
    87678767            <div>
    87688768              <div class="refsect1" lang="en" xml:lang="en">
    8769                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456258"></a>
     8769                <a xmlns="http://www.w3.org/1999/xhtml" id="id441330"></a>
    87708770                <div class="header">Arguments and Values:</div>
    87718771                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">semaphore</span></i>---An object of type CCL:SEMAPHORE.</p>
     
    87808780              </div>
    87818781              <div class="refsect1" lang="en" xml:lang="en">
    8782                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456324"></a>
     8782                <a xmlns="http://www.w3.org/1999/xhtml" id="id441396"></a>
    87838783                <div class="header">Description:</div>
    87848784                <p xmlns="http://www.w3.org/1999/xhtml">Waits until <em class="varname">semaphore</em>
     
    87898789              </div>
    87908790              <div class="refsect1" lang="en" xml:lang="en">
    8791                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456341"></a>
     8791                <a xmlns="http://www.w3.org/1999/xhtml" id="id441413"></a>
    87928792                <div class="header">See Also:</div>
    87938793                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_wait-on-semaphore" title="Function WAIT-ON-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">wait-on-semaphore</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
     
    88098809            <div>
    88108810              <div class="refsect1" lang="en" xml:lang="en">
    8811                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456434"></a>
     8811                <a xmlns="http://www.w3.org/1999/xhtml" id="id441506"></a>
    88128812                <div class="header">Arguments and Values:</div>
    88138813                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">fd</span></i>---a file descriptor, which is a non-negative integer
     
    88178817              </div>
    88188818              <div class="refsect1" lang="en" xml:lang="en">
    8819                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456476"></a>
     8819                <a xmlns="http://www.w3.org/1999/xhtml" id="id441548"></a>
    88208820                <div class="header">Description:</div>
    88218821                <p xmlns="http://www.w3.org/1999/xhtml">Wait until input is available on <em class="varname">fd</em>.
     
    88338833              </div>
    88348834              <div class="refsect1" lang="en" xml:lang="en">
    8835                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456509"></a>
     8835                <a xmlns="http://www.w3.org/1999/xhtml" id="id441581"></a>
    88368836                <div class="header">See Also:</div>
    88378837                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
    88388838              </div>
    88398839              <div class="refsect1" lang="en" xml:lang="en">
    8840                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456546"></a>
     8840                <a xmlns="http://www.w3.org/1999/xhtml" id="id441618"></a>
    88418841                <div class="header">Notes:</div>
    88428842                <p xmlns="http://www.w3.org/1999/xhtml">
     
    88638863            <div>
    88648864              <div class="refsect1" lang="en" xml:lang="en">
    8865                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456611"></a>
     8865                <a xmlns="http://www.w3.org/1999/xhtml" id="id441683"></a>
    88668866                <div class="header">Arguments and Values:</div>
    88678867                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">fd</span></i>---a file descriptor, which is a non-negative integer
     
    88718871              </div>
    88728872              <div class="refsect1" lang="en" xml:lang="en">
    8873                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456652"></a>
     8873                <a xmlns="http://www.w3.org/1999/xhtml" id="id441725"></a>
    88748874                <div class="header">Description:</div>
    88758875                <p xmlns="http://www.w3.org/1999/xhtml">Wait until output is possible on <em class="varname">fd</em> or until <em class="varname">timeout</em>, if
     
    88848884              </div>
    88858885              <div class="refsect1" lang="en" xml:lang="en">
    8886                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456686"></a>
     8886                <a xmlns="http://www.w3.org/1999/xhtml" id="id441758"></a>
    88878887                <div class="header">See Also:</div>
    88888888                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span>
    88898889              </div>
    88908890              <div class="refsect1" lang="en" xml:lang="en">
    8891                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456723"></a>
     8891                <a xmlns="http://www.w3.org/1999/xhtml" id="id441795"></a>
    88928892                <div class="header">Notes:</div>
    88938893                <p xmlns="http://www.w3.org/1999/xhtml">
     
    89148914            <div>
    89158915              <div class="refsect1" lang="en" xml:lang="en">
    8916                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456788"></a>
     8916                <a xmlns="http://www.w3.org/1999/xhtml" id="id441860"></a>
    89178917                <div class="header">Arguments and Values:</div>
    89188918                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">body</span></i>---an implicit progn.</p>
     
    89218921              </div>
    89228922              <div class="refsect1" lang="en" xml:lang="en">
    8923                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456826"></a>
     8923                <a xmlns="http://www.w3.org/1999/xhtml" id="id441898"></a>
    89248924                <div class="header">Description:</div>
    89258925                <p xmlns="http://www.w3.org/1999/xhtml">Requests exclusive read access to the standard terminal
     
    89298929              </div>
    89308930              <div class="refsect1" lang="en" xml:lang="en">
    8931                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456843"></a>
     8931                <a xmlns="http://www.w3.org/1999/xhtml" id="id441915"></a>
    89328932                <div class="header">See Also:</div>
    89338933                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#v_request-terminal-input-via-break" title="Variable *REQUEST-TERMINAL-INPUT-VIA-BREAK*"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">*request-terminal-input-via-break*</b></a>, <a class="xref" href="#cmd_y" title="Toplevel Command :Y"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">:y</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a></span>
     
    89488948            <div>
    89498949              <div class="refsect1" lang="en" xml:lang="en">
    8950                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456920"></a>
     8950                <a xmlns="http://www.w3.org/1999/xhtml" id="id441992"></a>
    89518951                <div class="header">Value Type:</div>
    89528952                <p xmlns="http://www.w3.org/1999/xhtml">A boolean.</p>
    89538953              </div>
    89548954              <div class="refsect1" lang="en" xml:lang="en">
    8955                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456930"></a>
     8955                <a xmlns="http://www.w3.org/1999/xhtml" id="id442002"></a>
    89568956                <div class="header">Initial Value:</div>
    89578957                <p xmlns="http://www.w3.org/1999/xhtml">NIL.</p>
    89588958              </div>
    89598959              <div class="refsect1" lang="en" xml:lang="en">
    8960                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456939"></a>
     8960                <a xmlns="http://www.w3.org/1999/xhtml" id="id442011"></a>
    89618961                <div class="header">Description:</div>
    89628962                <p xmlns="http://www.w3.org/1999/xhtml">Controls how attempts to obtain ownership of terminal input
     
    89708970              </div>
    89718971              <div class="refsect1" lang="en" xml:lang="en">
    8972                 <a xmlns="http://www.w3.org/1999/xhtml" id="id456953"></a>
     8972                <a xmlns="http://www.w3.org/1999/xhtml" id="id442025"></a>
    89738973                <div class="header">See Also:</div>
    89748974                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a>, <a class="xref" href="#cmd_y" title="Toplevel Command :Y"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">:y</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a></span>
     
    89898989            <div>
    89908990              <div class="refsect1" lang="en" xml:lang="en">
    8991                 <a xmlns="http://www.w3.org/1999/xhtml" id="id457044"></a>
     8991                <a xmlns="http://www.w3.org/1999/xhtml" id="id442116"></a>
    89928992                <div class="header">Arguments and Values:</div>
    89938993                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">p</span></i>---a lisp process (thread), designated either by
     
    89988998              </div>
    89998999              <div class="refsect1" lang="en" xml:lang="en">
    9000                 <a xmlns="http://www.w3.org/1999/xhtml" id="id457083"></a>
     9000                <a xmlns="http://www.w3.org/1999/xhtml" id="id442155"></a>
    90019001                <div class="header">Description:</div>
    90029002                <p xmlns="http://www.w3.org/1999/xhtml">:Y is a toplevel command, not a function.  As such, it
     
    90099009              </div>
    90109010              <div class="refsect1" lang="en" xml:lang="en">
    9011                 <a xmlns="http://www.w3.org/1999/xhtml" id="id457105"></a>
     9011                <a xmlns="http://www.w3.org/1999/xhtml" id="id442177"></a>
    90129012                <div class="header">See Also:</div>
    90139013                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a>, <a class="xref" href="#v_request-terminal-input-via-break" title="Variable *REQUEST-TERMINAL-INPUT-VIA-BREAK*"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">*request-terminal-input-via-break*</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a></span>
     
    90309030            <div>
    90319031              <div class="refsect1" lang="en" xml:lang="en">
    9032                 <a xmlns="http://www.w3.org/1999/xhtml" id="id457198"></a>
     9032                <a xmlns="http://www.w3.org/1999/xhtml" id="id442270"></a>
    90339033                <div class="header">Arguments and Values:</div>
    90349034                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a process, typically created by <a xmlns="http://www.w3.org/1999/xhtml" class="xref" href="#f_process-run-function" title="Function PROCESS-RUN-FUNCTION"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-run-function</b></a> or by <a xmlns="http://www.w3.org/1999/xhtml" class="xref" href="#f_make-process" title="Function MAKE-PROCESS"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-process</b></a></p>
     
    90409040              </div>
    90419041              <div class="refsect1" lang="en" xml:lang="en">
    9042                 <a xmlns="http://www.w3.org/1999/xhtml" id="id457255"></a>
     9042                <a xmlns="http://www.w3.org/1999/xhtml" id="id442328"></a>
    90439043                <div class="header">Description:</div>
    90449044                <p xmlns="http://www.w3.org/1999/xhtml">Waits for the specified process to terminate.  If the
     
    91819181            <div>
    91829182              <div class="refsect1" lang="en" xml:lang="en">
    9183                 <a xmlns="http://www.w3.org/1999/xhtml" id="id437499"></a>
     9183                <a xmlns="http://www.w3.org/1999/xhtml" id="id414511"></a>
    91849184                <div class="header">Arguments and Values:</div>
    91859185                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">address-family</span></i>---The address/protocol family of this socket. Currently
     
    92819281              </div>
    92829282              <div class="refsect1" lang="en" xml:lang="en">
    9283                 <a xmlns="http://www.w3.org/1999/xhtml" id="id432368"></a>
     9283                <a xmlns="http://www.w3.org/1999/xhtml" id="id416765"></a>
    92849284                <div class="header">Description:</div>
    92859285                <p xmlns="http://www.w3.org/1999/xhtml">Creates and returns a new socket</p>
     
    93009300            <div>
    93019301              <div class="refsect1" lang="en" xml:lang="en">
    9302                 <a xmlns="http://www.w3.org/1999/xhtml" id="id432429"></a>
     9302                <a xmlns="http://www.w3.org/1999/xhtml" id="id416827"></a>
    93039303                <div class="header">Arguments and Values:</div>
    93049304                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The listener-socket to listen on.</p>
     
    93089308              </div>
    93099309              <div class="refsect1" lang="en" xml:lang="en">
    9310                 <a xmlns="http://www.w3.org/1999/xhtml" id="id432471"></a>
     9310                <a xmlns="http://www.w3.org/1999/xhtml" id="id428228"></a>
    93119311                <div class="header">Description:</div>
    93129312                <p xmlns="http://www.w3.org/1999/xhtml">Extracts the first connection on the queue of pending
     
    93349334            <div>
    93359335              <div class="refsect1" lang="en" xml:lang="en">
    9336                 <a xmlns="http://www.w3.org/1999/xhtml" id="id432537"></a>
     9336                <a xmlns="http://www.w3.org/1999/xhtml" id="id428294"></a>
    93379337                <div class="header">Arguments and Values:</div>
    93389338                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">dotted</span></i>---A string representing an IP address in the
     
    93429342              </div>
    93439343              <div class="refsect1" lang="en" xml:lang="en">
    9344                 <a xmlns="http://www.w3.org/1999/xhtml" id="id432578"></a>
     9344                <a xmlns="http://www.w3.org/1999/xhtml" id="id428335"></a>
    93459345                <div class="header">Description:</div>
    93469346                <p xmlns="http://www.w3.org/1999/xhtml">Converts a dotted-string representation of a host address to
     
    93629362            <div>
    93639363              <div class="refsect1" lang="en" xml:lang="en">
    9364                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440499"></a>
     9364                <a xmlns="http://www.w3.org/1999/xhtml" id="id428397"></a>
    93659365                <div class="header">Arguments and Values:</div>
    93669366                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">ipaddr</span></i>---A 32-bit integer representing an internet host address</p>
     
    93719371              </div>
    93729372              <div class="refsect1" lang="en" xml:lang="en">
    9373                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440541"></a>
     9373                <a xmlns="http://www.w3.org/1999/xhtml" id="id428439"></a>
    93749374                <div class="header">Description:</div>
    93759375                <p xmlns="http://www.w3.org/1999/xhtml">Converts a 32-bit unsigned IP address into octets.</p>
     
    93909390            <div>
    93919391              <div class="refsect1" lang="en" xml:lang="en">
    9392                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440602"></a>
     9392                <a xmlns="http://www.w3.org/1999/xhtml" id="id428500"></a>
    93939393                <div class="header">Arguments and Values:</div>
    93949394                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">ipaddr</span></i>---a 32-bit integer representing an internet host address</p>
     
    93979397              </div>
    93989398              <div class="refsect1" lang="en" xml:lang="en">
    9399                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440642"></a>
     9399                <a xmlns="http://www.w3.org/1999/xhtml" id="id428540"></a>
    94009400                <div class="header">Description:</div>
    94019401                <p xmlns="http://www.w3.org/1999/xhtml">Converts a 32-bit unsigned IP address into a host name
     
    94179417            <div>
    94189418              <div class="refsect1" lang="en" xml:lang="en">
    9419                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440700"></a>
     9419                <a xmlns="http://www.w3.org/1999/xhtml" id="id424034"></a>
    94209420                <div class="header">Arguments and Values:</div>
    94219421                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">host</span></i>---Specifies the host. It can be either a host name
     
    94259425              </div>
    94269426              <div class="refsect1" lang="en" xml:lang="en">
    9427                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440727"></a>
     9427                <a xmlns="http://www.w3.org/1999/xhtml" id="id424062"></a>
    94289428                <div class="header">Description:</div>
    94299429                <p xmlns="http://www.w3.org/1999/xhtml">Converts a host spec in any of the acceptable formats into a
     
    94459445            <div>
    94469446              <div class="refsect1" lang="en" xml:lang="en">
    9447                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440785"></a>
     9447                <a xmlns="http://www.w3.org/1999/xhtml" id="id424120"></a>
    94489448                <div class="header">Arguments and Values:</div>
    94499449                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">port</span></i>---Specifies the port. It can be either a string, such as
     
    94549454              </div>
    94559455              <div class="refsect1" lang="en" xml:lang="en">
    9456                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440828"></a>
     9456                <a xmlns="http://www.w3.org/1999/xhtml" id="id424163"></a>
    94579457                <div class="header">Description:</div>
    94589458                <p xmlns="http://www.w3.org/1999/xhtml">Finds the port number for the specified port and protocol</p>
     
    94749474            <div>
    94759475              <div class="refsect1" lang="en" xml:lang="en">
    9476                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440889"></a>
     9476                <a xmlns="http://www.w3.org/1999/xhtml" id="id424224"></a>
    94779477                <div class="header">Arguments and Values:</div>
    94789478                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket to read from</p>
     
    94919491              </div>
    94929492              <div class="refsect1" lang="en" xml:lang="en">
    9493                 <a xmlns="http://www.w3.org/1999/xhtml" id="id439295"></a>
     9493                <a xmlns="http://www.w3.org/1999/xhtml" id="id424314"></a>
    94949494                <div class="header">Description:</div>
    94959495                <p xmlns="http://www.w3.org/1999/xhtml">Reads a UDP packet from a socket. If no packets are
    94969496          available, waits for a packet to arrive. Returns four values:</p>
    94979497                <div xmlns="http://www.w3.org/1999/xhtml" class="orderedlist">
    9498                   <ol type="1">
    9499                     <li>
     9498                  <ol class="orderedlist" type="1">
     9499                    <li class="listitem">
    95009500                      <p>The buffer with the data</p>
    95019501                    </li>
    9502                     <li>
     9502                    <li class="listitem">
    95039503                      <p>The number of bytes read</p>
    95049504                    </li>
    9505                     <li>
     9505                    <li class="listitem">
    95069506                      <p>The 32-bit unsigned IP address of the sender of the data</p>
    95079507                    </li>
    9508                     <li>
     9508                    <li class="listitem">
    95099509                      <p>The port number of the sender of the data</p>
    95109510                    </li>
     
    95289528            <div>
    95299529              <div class="refsect1" lang="en" xml:lang="en">
    9530                 <a xmlns="http://www.w3.org/1999/xhtml" id="id439395"></a>
     9530                <a xmlns="http://www.w3.org/1999/xhtml" id="id424414"></a>
    95319531                <div class="header">Arguments and Values:</div>
    95329532                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket to write to</p>
     
    95439543              </div>
    95449544              <div class="refsect1" lang="en" xml:lang="en">
    9545                 <a xmlns="http://www.w3.org/1999/xhtml" id="id439497"></a>
     9545                <a xmlns="http://www.w3.org/1999/xhtml" id="id422825"></a>
    95469546                <div class="header">Description:</div>
    95479547                <p xmlns="http://www.w3.org/1999/xhtml">Send a UDP packet over a socket.</p>
     
    95629562            <div>
    95639563              <div class="refsect1" lang="en" xml:lang="en">
    9564                 <a xmlns="http://www.w3.org/1999/xhtml" id="id439559"></a>
     9564                <a xmlns="http://www.w3.org/1999/xhtml" id="id422886"></a>
    95659565                <div class="header">Arguments and Values:</div>
    95669566                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket to shut down (typically a tcp-stream)</p>
     
    95699569              </div>
    95709570              <div class="refsect1" lang="en" xml:lang="en">
    9571                 <a xmlns="http://www.w3.org/1999/xhtml" id="id439599"></a>
     9571                <a xmlns="http://www.w3.org/1999/xhtml" id="id422927"></a>
    95729572                <div class="header">Description:</div>
    95739573                <p xmlns="http://www.w3.org/1999/xhtml">Shuts down part of a bidirectional connection. This is
     
    95909590            <div>
    95919591              <div class="refsect1" lang="en" xml:lang="en">
    9592                 <a xmlns="http://www.w3.org/1999/xhtml" id="id439658"></a>
     9592                <a xmlns="http://www.w3.org/1999/xhtml" id="id422985"></a>
    95939593                <div class="header">Arguments and Values:</div>
    95949594                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p>
    95959595              </div>
    95969596              <div class="refsect1" lang="en" xml:lang="en">
    9597                 <a xmlns="http://www.w3.org/1999/xhtml" id="id439684"></a>
     9597                <a xmlns="http://www.w3.org/1999/xhtml" id="id423011"></a>
    95989598                <div class="header">Description:</div>
    95999599                <p xmlns="http://www.w3.org/1999/xhtml">Returns the native OS's representation of the socket, or
     
    96209620            <div>
    96219621              <div class="refsect1" lang="en" xml:lang="en">
    9622                 <a xmlns="http://www.w3.org/1999/xhtml" id="id439745"></a>
     9622                <a xmlns="http://www.w3.org/1999/xhtml" id="id423072"></a>
    96239623                <div class="header">Arguments and Values:</div>
    96249624                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p>
    96259625              </div>
    96269626              <div class="refsect1" lang="en" xml:lang="en">
    9627                 <a xmlns="http://www.w3.org/1999/xhtml" id="id439771"></a>
     9627                <a xmlns="http://www.w3.org/1999/xhtml" id="id423098"></a>
    96289628                <div class="header">Description:</div>
    96299629                <p xmlns="http://www.w3.org/1999/xhtml">Returns the 32-bit unsigned IP address of the remote host,
     
    96459645            <div>
    96469646              <div class="refsect1" lang="en" xml:lang="en">
    9647                 <a xmlns="http://www.w3.org/1999/xhtml" id="id439845"></a>
     9647                <a xmlns="http://www.w3.org/1999/xhtml" id="id423157"></a>
    96489648                <div class="header">Arguments and Values:</div>
    96499649                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p>
    96509650              </div>
    96519651              <div class="refsect1" lang="en" xml:lang="en">
    9652                 <a xmlns="http://www.w3.org/1999/xhtml" id="id439871"></a>
     9652                <a xmlns="http://www.w3.org/1999/xhtml" id="id423183"></a>
    96539653                <div class="header">Description:</div>
    96549654                <p xmlns="http://www.w3.org/1999/xhtml">Returns the remote port number, or NIL if the socket is not
     
    96709670            <div>
    96719671              <div class="refsect1" lang="en" xml:lang="en">
    9672                 <a xmlns="http://www.w3.org/1999/xhtml" id="id439928"></a>
     9672                <a xmlns="http://www.w3.org/1999/xhtml" id="id423240"></a>
    96739673                <div class="header">Arguments and Values:</div>
    96749674                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p>
    96759675              </div>
    96769676              <div class="refsect1" lang="en" xml:lang="en">
    9677                 <a xmlns="http://www.w3.org/1999/xhtml" id="id439954"></a>
     9677                <a xmlns="http://www.w3.org/1999/xhtml" id="id423266"></a>
    96789678                <div class="header">Description:</div>
    96799679                <p xmlns="http://www.w3.org/1999/xhtml">Returns 32-bit unsigned IP address of the local host.</p>
     
    96949694            <div>
    96959695              <div class="refsect1" lang="en" xml:lang="en">
    9696                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440012"></a>
     9696                <a xmlns="http://www.w3.org/1999/xhtml" id="id423323"></a>
    96979697                <div class="header">Arguments and Values:</div>
    96989698                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p>
    96999699              </div>
    97009700              <div class="refsect1" lang="en" xml:lang="en">
    9701                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440038"></a>
     9701                <a xmlns="http://www.w3.org/1999/xhtml" id="id414602"></a>
    97029702                <div class="header">Description:</div>
    97039703                <p xmlns="http://www.w3.org/1999/xhtml">Returns the local port number</p>
     
    97189718            <div>
    97199719              <div class="refsect1" lang="en" xml:lang="en">
    9720                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440095"></a>
     9720                <a xmlns="http://www.w3.org/1999/xhtml" id="id414660"></a>
    97219721                <div class="header">Arguments and Values:</div>
    97229722                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p>
    97239723              </div>
    97249724              <div class="refsect1" lang="en" xml:lang="en">
    9725                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440121"></a>
     9725                <a xmlns="http://www.w3.org/1999/xhtml" id="id414686"></a>
    97269726                <div class="header">Description:</div>
    97279727                <p xmlns="http://www.w3.org/1999/xhtml">Returns :internet or :file, as appropriate.</p>
     
    97429742            <div>
    97439743              <div class="refsect1" lang="en" xml:lang="en">
    9744                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440179"></a>
     9744                <a xmlns="http://www.w3.org/1999/xhtml" id="id414743"></a>
    97459745                <div class="header">Arguments and Values:</div>
    97469746                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p>
    97479747              </div>
    97489748              <div class="refsect1" lang="en" xml:lang="en">
    9749                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440205"></a>
     9749                <a xmlns="http://www.w3.org/1999/xhtml" id="id414769"></a>
    97509750                <div class="header">Description:</div>
    97519751                <p xmlns="http://www.w3.org/1999/xhtml">Returns :active for tcp-stream, :passive for
     
    97679767            <div>
    97689768              <div class="refsect1" lang="en" xml:lang="en">
    9769                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440262"></a>
     9769                <a xmlns="http://www.w3.org/1999/xhtml" id="id414826"></a>
    97709770                <div class="header">Arguments and Values:</div>
    97719771                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p>
    97729772              </div>
    97739773              <div class="refsect1" lang="en" xml:lang="en">
    9774                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440288"></a>
     9774                <a xmlns="http://www.w3.org/1999/xhtml" id="id414853"></a>
    97759775                <div class="header">Description:</div>
    97769776                <p xmlns="http://www.w3.org/1999/xhtml">Returns the socket format as specified by the :format
     
    97929792            <div>
    97939793              <div class="refsect1" lang="en" xml:lang="en">
    9794                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440345"></a>
     9794                <a xmlns="http://www.w3.org/1999/xhtml" id="id414910"></a>
    97959795                <div class="header">Arguments and Values:</div>
    97969796                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p>
    97979797              </div>
    97989798              <div class="refsect1" lang="en" xml:lang="en">
    9799                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440371"></a>
     9799                <a xmlns="http://www.w3.org/1999/xhtml" id="id414936"></a>
    98009800                <div class="header">Description:</div>
    98019801                <p xmlns="http://www.w3.org/1999/xhtml">returns :stream for tcp-stream and listener-socket, and
     
    98169816            <div>
    98179817              <div class="refsect1" lang="en" xml:lang="en">
    9818                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440415"></a>
     9818                <a xmlns="http://www.w3.org/1999/xhtml" id="id414979"></a>
    98199819                <div class="header">Description:</div>
    98209820                <p xmlns="http://www.w3.org/1999/xhtml">The class of OS errors signaled by socket functions</p>
    98219821              </div>
    98229822              <div class="refsect1" lang="en" xml:lang="en">
    9823                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440426"></a>
     9823                <a xmlns="http://www.w3.org/1999/xhtml" id="id414990"></a>
    98249824                <div class="header">Superclasses:</div>
    98259825                <p xmlns="http://www.w3.org/1999/xhtml">simple-error</p>
     
    98409840            <div>
    98419841              <div class="refsect1" lang="en" xml:lang="en">
    9842                 <a xmlns="http://www.w3.org/1999/xhtml" id="id440483"></a>
     9842                <a xmlns="http://www.w3.org/1999/xhtml" id="id415047"></a>
    98439843                <div class="header">Arguments and Values:</div>
    98449844                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket-error</span></i>---the condition</p>
    98459845              </div>
    98469846              <div class="refsect1" lang="en" xml:lang="en">
    9847                 <a xmlns="http://www.w3.org/1999/xhtml" id="id437570"></a>
     9847                <a xmlns="http://www.w3.org/1999/xhtml" id="id415073"></a>
    98489848                <div class="header">Description:</div>
    98499849                <p xmlns="http://www.w3.org/1999/xhtml">The OS error code of the error</p>
     
    98649864            <div>
    98659865              <div class="refsect1" lang="en" xml:lang="en">
    9866                 <a xmlns="http://www.w3.org/1999/xhtml" id="id437628"></a>
     9866                <a xmlns="http://www.w3.org/1999/xhtml" id="id415131"></a>
    98679867                <div class="header">Arguments and Values:</div>
    98689868                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket-error</span></i>---the condition</p>
    98699869              </div>
    98709870              <div class="refsect1" lang="en" xml:lang="en">
    9871                 <a xmlns="http://www.w3.org/1999/xhtml" id="id437654"></a>
     9871                <a xmlns="http://www.w3.org/1999/xhtml" id="id415157"></a>
    98729872                <div class="header">Description:</div>
    98739873                <p xmlns="http://www.w3.org/1999/xhtml">A symbol representing the error code in a more
     
    98939893            <div>
    98949894              <div class="refsect1" lang="en" xml:lang="en">
    9895                 <a xmlns="http://www.w3.org/1999/xhtml" id="id437718"></a>
     9895                <a xmlns="http://www.w3.org/1999/xhtml" id="id423376"></a>
    98969896                <div class="header">Arguments and Values:</div>
    98979897                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket-error</span></i>---the condition</p>
    98989898              </div>
    98999899              <div class="refsect1" lang="en" xml:lang="en">
    9900                 <a xmlns="http://www.w3.org/1999/xhtml" id="id437744"></a>
     9900                <a xmlns="http://www.w3.org/1999/xhtml" id="id423403"></a>
    99019901                <div class="header">Description:</div>
    99029902                <p xmlns="http://www.w3.org/1999/xhtml">A string describing the context where the error happened. On
     
    99199919            <div>
    99209920              <div class="refsect1" lang="en" xml:lang="en">
    9921                 <a xmlns="http://www.w3.org/1999/xhtml" id="id437806"></a>
     9921                <a xmlns="http://www.w3.org/1999/xhtml" id="id423464"></a>
    99229922                <div class="header">Arguments and Values:</div>
    99239923                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket to close</p>
     
    99309930              </div>
    99319931              <div class="refsect1" lang="en" xml:lang="en">
    9932                 <a xmlns="http://www.w3.org/1999/xhtml" id="id437849"></a>
     9932                <a xmlns="http://www.w3.org/1999/xhtml" id="id423507"></a>
    99339933                <div class="header">Description:</div>
    99349934                <p xmlns="http://www.w3.org/1999/xhtml">The close generic function can be applied to sockets. It
     
    99519951            <div>
    99529952              <div class="refsect1" lang="en" xml:lang="en">
    9953                 <a xmlns="http://www.w3.org/1999/xhtml" id="id437912"></a>
     9953                <a xmlns="http://www.w3.org/1999/xhtml" id="id423569"></a>
    99549954                <div class="header">Arguments and Values:</div>
    99559955                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">var</span></i>---variable to bind</p>
     
    99589958              </div>
    99599959              <div class="refsect1" lang="en" xml:lang="en">
    9960                 <a xmlns="http://www.w3.org/1999/xhtml" id="id437967"></a>
     9960                <a xmlns="http://www.w3.org/1999/xhtml" id="id423625"></a>
    99619961                <div class="header">Description:</div>
    99629962                <p xmlns="http://www.w3.org/1999/xhtml">executes body with var bound to the result of applying
     
    1004910049          </div>
    1005010050          <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    10051             <ul type="disc">
    10052               <li>
     10051            <ul class="itemizedlist" type="disc">
     10052              <li class="listitem">
    1005310053                <p>Clozure CL and the external process may get
    1005410054        confused about who owns which streams when input, output, or
     
    1005610056        NIL.</p>
    1005710057              </li>
    10058               <li>
     10058              <li class="listitem">
    1005910059                <p>External processes that need to talk to a
    1006010060        terminal device may not work properly; the environment (SLIME,
     
    1009010090            <div>
    1009110091              <div class="refsect1" lang="en" xml:lang="en">
    10092                 <a xmlns="http://www.w3.org/1999/xhtml" id="id413342"></a>
     10092                <a xmlns="http://www.w3.org/1999/xhtml" id="id368442"></a>
    1009310093                <div class="header">Arguments and Values:</div>
    1009410094                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">program</span></i>---A string or pathname which denotes an executable file.
     
    1010710107                  to be a :STREAM.</p>
    1010810108                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">input</span></i>---Selects the input source used by the EXTERNAL-PROCESS.
    10109                   May be any of the following:<div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist"><ul type="disc"><li><p>NIL Specifies that a null input stream (e.g.,
    10110                       /dev/null) should be used.</p></li><li><p>T Specifies that the EXTERNAL-PROCESS should use
    10111                       the input source with which Clozure CL was invoked.</p></li><li><p>A string or pathname. Specifies that the
     10109                  May be any of the following:<div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>NIL Specifies that a null input stream (e.g.,
     10110                      /dev/null) should be used.</p></li><li class="listitem"><p>T Specifies that the EXTERNAL-PROCESS should use
     10111                      the input source with which Clozure CL was invoked.</p></li><li class="listitem"><p>A string or pathname. Specifies that the
    1011210112                      EXTERNAL-PROCESS should receive its input from the named
    10113                       existing file.</p></li><li><p>:STREAM Creates a Lisp stream opened for character
     10113                      existing file.</p></li><li class="listitem"><p>:STREAM Creates a Lisp stream opened for character
    1011410114                      output. Any data written to this stream (accessible as
    1011510115                      the EXTERNAL-PROCESS-INPUT-STREAM of the
    1011610116                      EXTERNAL-PROCESS object) appears as input to the
    10117                       external process.</p></li><li><p>A stream. Specifies that the lisp stream should
     10117                      external process.</p></li><li class="listitem"><p>A stream. Specifies that the lisp stream should
    1011810118                      provide input to the EXTERNAL-PROCESS.</p></li></ul></div></p>
    1011910119                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">if-input-does-not-exist</span></i>---If the input argument specifies the name of an
     
    1014110141              </div>
    1014210142              <div class="refsect1" lang="en" xml:lang="en">
    10143                 <a xmlns="http://www.w3.org/1999/xhtml" id="id409015"></a>
     10143                <a xmlns="http://www.w3.org/1999/xhtml" id="id428026"></a>
    1014410144                <div class="header">Description:</div>
    1014510145                <p xmlns="http://www.w3.org/1999/xhtml">Runs the specified program in an external (Unix) process,
     
    1016110161            <div>
    1016210162              <div class="refsect1" lang="en" xml:lang="en">
    10163                 <a xmlns="http://www.w3.org/1999/xhtml" id="id409073"></a>
     10163                <a xmlns="http://www.w3.org/1999/xhtml" id="id428085"></a>
    1016410164                <div class="header">Arguments and Values:</div>
    1016510165                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.</p>
     
    1016710167              </div>
    1016810168              <div class="refsect1" lang="en" xml:lang="en">
    10169                 <a xmlns="http://www.w3.org/1999/xhtml" id="id415621"></a>
     10169                <a xmlns="http://www.w3.org/1999/xhtml" id="id400685"></a>
    1017010170                <div class="header">Description:</div>
    1017110171                <p xmlns="http://www.w3.org/1999/xhtml">Sends the specified "signal" to the specified
     
    1019010190            <div>
    1019110191              <div class="refsect1" lang="en" xml:lang="en">
    10192                 <a xmlns="http://www.w3.org/1999/xhtml" id="id415683"></a>
     10192                <a xmlns="http://www.w3.org/1999/xhtml" id="id400746"></a>
    1019310193                <div class="header">Arguments and Values:</div>
    1019410194                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.</p>
    1019510195              </div>
    1019610196              <div class="refsect1" lang="en" xml:lang="en">
    10197                 <a xmlns="http://www.w3.org/1999/xhtml" id="id428329"></a>
     10197                <a xmlns="http://www.w3.org/1999/xhtml" id="id400772"></a>
    1019810198                <div class="header">Description:</div>
    1019910199                <p xmlns="http://www.w3.org/1999/xhtml">Returns the <span class="emphasis"><em>process id</em></span> assigned to
     
    1021710217            <div>
    1021810218              <div class="refsect1" lang="en" xml:lang="en">
    10219                 <a xmlns="http://www.w3.org/1999/xhtml" id="id428394"></a>
     10219                <a xmlns="http://www.w3.org/1999/xhtml" id="id417143"></a>
    1022010220                <div class="header">Arguments and Values:</div>
    1022110221                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.</p>
    1022210222              </div>
    1022310223              <div class="refsect1" lang="en" xml:lang="en">
    10224                 <a xmlns="http://www.w3.org/1999/xhtml" id="id388650"></a>
     10224                <a xmlns="http://www.w3.org/1999/xhtml" id="id417169"></a>
    1022510225                <div class="header">Description:</div>
    1022610226                <p xmlns="http://www.w3.org/1999/xhtml">Returns the stream created when the input argument to
     
    1024310243            <div>
    1024410244              <div class="refsect1" lang="en" xml:lang="en">
    10245                 <a xmlns="http://www.w3.org/1999/xhtml" id="id388711"></a>
     10245                <a xmlns="http://www.w3.org/1999/xhtml" id="id427896"></a>
    1024610246                <div class="header">Arguments and Values:</div>
    1024710247                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.</p>
    1024810248              </div>
    1024910249              <div class="refsect1" lang="en" xml:lang="en">
    10250                 <a xmlns="http://www.w3.org/1999/xhtml" id="id388737"></a>
     10250                <a xmlns="http://www.w3.org/1999/xhtml" id="id427921"></a>
    1025110251                <div class="header">Description:</div>
    1025210252                <p xmlns="http://www.w3.org/1999/xhtml">Returns the stream created when the output argument to
     
    1027010270            <div>
    1027110271              <div class="refsect1" lang="en" xml:lang="en">
    10272                 <a xmlns="http://www.w3.org/1999/xhtml" id="id424129"></a>
     10272                <a xmlns="http://www.w3.org/1999/xhtml" id="id427982"></a>
    1027310273                <div class="header">Arguments and Values:</div>
    1027410274                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.</p>
    1027510275              </div>
    1027610276              <div class="refsect1" lang="en" xml:lang="en">
    10277                 <a xmlns="http://www.w3.org/1999/xhtml" id="id424154"></a>
     10277                <a xmlns="http://www.w3.org/1999/xhtml" id="id415400"></a>
    1027810278                <div class="header">Description:</div>
    1027910279                <p xmlns="http://www.w3.org/1999/xhtml">Returns the stream created when the error argument to
     
    1029710297            <div>
    1029810298              <div class="refsect1" lang="en" xml:lang="en">
    10299                 <a xmlns="http://www.w3.org/1999/xhtml" id="id418330"></a>
     10299                <a xmlns="http://www.w3.org/1999/xhtml" id="id415461"></a>
    1030010300                <div class="header">Arguments and Values:</div>
    1030110301                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.</p>
    1030210302              </div>
    1030310303              <div class="refsect1" lang="en" xml:lang="en">
    10304                 <a xmlns="http://www.w3.org/1999/xhtml" id="id418356"></a>
     10304                <a xmlns="http://www.w3.org/1999/xhtml" id="id415487"></a>
    1030510305                <div class="header">Description:</div>
    1030610306                <p xmlns="http://www.w3.org/1999/xhtml">Returns, as multiple values, a keyword denoting the status
     
    1033210332                <dt>
    1033310333                  <span class="sect2">
    10334                     <a href="#id430869">9.1.1. Stream External Encoding</a>
     10334                    <a href="#id389993">9.1.1. Stream External Format</a>
    1033510335                  </span>
    1033610336                </dt>
     
    1040010400              <div>
    1040110401                <div>
    10402                   <h3 class="title"><a id="id430869"></a>9.1.1. Stream External Encoding</h3>
     10402                  <h3 class="title"><a id="id389993"></a>9.1.1. Stream External Format</h3>
    1040310403                </div>
    1040410404              </div>
    1040510405            </div>
    10406             <p xmlns="http://www.w3.org/1999/xhtml">Clozure CL streams have an external-encoding attribute that
    10407     may be read using
    10408     <span class="function"><strong>STREAM-EXTERNAL-ENCODING</strong></span> and set using <span class="function"><strong>(SETF
    10409     STREAM-EXTERNAL-ENCODING)</strong></span>.
     10406            <p xmlns="http://www.w3.org/1999/xhtml"><span class="function"><strong>STREAM-EXTERNAL-FORMAT</strong></span> can be applied to
     10407    (and may return a non-null result for) open streams that are not
     10408    <code class="literal">FILE-STREAM</code>s.</p>
     10409            <p xmlns="http://www.w3.org/1999/xhtml"><span class="function"><strong>(SETF STREAM-EXTERNAL-FORMAT)</strong></span> can be used to
     10410    change the external format of open streams created with <span class="function"><strong>
     10411    OPEN</strong></span> or <span class="function"><strong>MAKE-SOCKET</strong></span>.
    1041010412    </p>
    1041110413          </div>
     
    1056110563              </div>
    1056210564            </div>
    10563             <a xmlns="http://www.w3.org/1999/xhtml" id="id438064" class="indexterm"></a>
    10564             <a xmlns="http://www.w3.org/1999/xhtml" id="id438074" class="indexterm"></a>
    10565             <a xmlns="http://www.w3.org/1999/xhtml" id="id438084" class="indexterm"></a>
    10566             <a xmlns="http://www.w3.org/1999/xhtml" id="id438093" class="indexterm"></a>
    10567             <a xmlns="http://www.w3.org/1999/xhtml" id="id438103" class="indexterm"></a>
    10568             <a xmlns="http://www.w3.org/1999/xhtml" id="id438113" class="indexterm"></a>
     10565            <a xmlns="http://www.w3.org/1999/xhtml" id="id389513" class="indexterm"></a>
     10566            <a xmlns="http://www.w3.org/1999/xhtml" id="id389523" class="indexterm"></a>
     10567            <a xmlns="http://www.w3.org/1999/xhtml" id="id389533" class="indexterm"></a>
     10568            <a xmlns="http://www.w3.org/1999/xhtml" id="id422520" class="indexterm"></a>
     10569            <a xmlns="http://www.w3.org/1999/xhtml" id="id422530" class="indexterm"></a>
     10570            <a xmlns="http://www.w3.org/1999/xhtml" id="id422540" class="indexterm"></a>
    1056910571            <p xmlns="http://www.w3.org/1999/xhtml">A stream that is associated with a file descriptor has
    1057010572        attributes and accessors:
     
    1061910621              <div>
    1062010622                <div class="refsect1" lang="en" xml:lang="en">
    10621                   <a xmlns="http://www.w3.org/1999/xhtml" id="id437385"></a>
     10623                  <a xmlns="http://www.w3.org/1999/xhtml" id="id422705"></a>
    1062210624                  <div class="header">Values:</div>
    1062310625                  <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream-list</span></i>---A list of open file streams.  This is a copy of
     
    1062610628                </div>
    1062710629                <div class="refsect1" lang="en" xml:lang="en">
    10628                   <a xmlns="http://www.w3.org/1999/xhtml" id="id437412"></a>
     10630                  <a xmlns="http://www.w3.org/1999/xhtml" id="id422732"></a>
    1062910631                  <div class="header">Description:</div>
    1063010632                  <p xmlns="http://www.w3.org/1999/xhtml">Returns a list of open file streams.</p>
    1063110633                </div>
    1063210634                <div class="refsect1" lang="en" xml:lang="en">
    10633                   <a xmlns="http://www.w3.org/1999/xhtml" id="id437423"></a>
     10635                  <a xmlns="http://www.w3.org/1999/xhtml" id="id422743"></a>
    1063410636                  <div class="header">See Also:</div>
    1063510637                  <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_note-open-file-stream" title="Function NOTE-OPEN-FILE-STREAM"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">note-open-file-stream</b></a>, <a class="xref" href="#f_remove-open-file-stream" title="Function REMOVE-OPEN-FILE-STREAM"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">remove-open-file-stream</b></a></span>
     
    1065410656              <div>
    1065510657                <div class="refsect1" lang="en" xml:lang="en">
    10656                   <a xmlns="http://www.w3.org/1999/xhtml" id="id438422"></a>
     10658                  <a xmlns="http://www.w3.org/1999/xhtml" id="id433228"></a>
    1065710659                  <div class="header">Arguments:</div>
    1065810660                  <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">file-stream</span></i>---A file stream.</p>
    1065910661                </div>
    1066010662                <div class="refsect1" lang="en" xml:lang="en">
    10661                   <a xmlns="http://www.w3.org/1999/xhtml" id="id438448"></a>
     10663                  <a xmlns="http://www.w3.org/1999/xhtml" id="id433254"></a>
    1066210664                  <div class="header">Description:</div>
    1066310665                  <p xmlns="http://www.w3.org/1999/xhtml">Adds a file stream to the internal list of open
     
    1066810670                </div>
    1066910671                <div class="refsect1" lang="en" xml:lang="en">
    10670                   <a xmlns="http://www.w3.org/1999/xhtml" id="id438467"></a>
     10672                  <a xmlns="http://www.w3.org/1999/xhtml" id="id433273"></a>
    1067110673                  <div class="header">See Also:</div>
    1067210674                  <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_open-file-streams" title="Function OPEN-FILE-STREAMS"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">open-file-streams</b></a>, <a class="xref" href="#f_remove-open-file-stream" title="Function REMOVE-OPEN-FILE-STREAM"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">remove-open-file-stream</b></a></span>
     
    1069110693              <div>
    1069210694                <div class="refsect1" lang="en" xml:lang="en">
    10693                   <a xmlns="http://www.w3.org/1999/xhtml" id="id438548"></a>
     10695                  <a xmlns="http://www.w3.org/1999/xhtml" id="id433354"></a>
    1069410696                  <div class="header">Arguments:</div>
    1069510697                  <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">file-stream</span></i>---A file stream.</p>
    1069610698                </div>
    1069710699                <div class="refsect1" lang="en" xml:lang="en">
    10698                   <a xmlns="http://www.w3.org/1999/xhtml" id="id438574"></a>
     10700                  <a xmlns="http://www.w3.org/1999/xhtml" id="id433381"></a>
    1069910701                  <div class="header">Description:</div>
    1070010702                  <p xmlns="http://www.w3.org/1999/xhtml">Remove file stream from the internal list of open file
     
    1070510707                </div>
    1070610708                <div class="refsect1" lang="en" xml:lang="en">
    10707                   <a xmlns="http://www.w3.org/1999/xhtml" id="id438593"></a>
     10709                  <a xmlns="http://www.w3.org/1999/xhtml" id="id433400"></a>
    1070810710                  <div class="header">See Also:</div>
    1070910711                  <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_open-file-streams" title="Function OPEN-FILE-STREAMS"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">open-file-streams</b></a>, <a class="xref" href="#f_note-open-file-stream" title="Function NOTE-OPEN-FILE-STREAM"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">note-open-file-stream</b></a></span>
     
    1074510747            <p xmlns="http://www.w3.org/1999/xhtml">Here's a list of some classes which you might wish for
    1074610748        your new stream class to inherit from:</p>
    10747             <table xmlns="http://www.w3.org/1999/xhtml" class="simplelist" border="0" summary="Simple list">
     10749            <table xmlns="http://www.w3.org/1999/xhtml" border="0" summary="Simple list" class="simplelist">
    1074810750              <tr>
    1074910751                <td>fundamental-stream</td>
     
    1091410916        wish to specialize for your new stream class, and which ought to
    1091510917        be documented at some point.</p>
    10916             <table xmlns="http://www.w3.org/1999/xhtml" class="simplelist" border="0" summary="Simple list">
     10918            <table xmlns="http://www.w3.org/1999/xhtml" border="0" summary="Simple list" class="simplelist">
    1091710919              <tr>
    1091810920                <td>stream-direction stream =&gt;</td>
     
    1098210984            <p xmlns="http://www.w3.org/1999/xhtml">The following functions are standard parts of Common Lisp, but
    1098310985        behave in special ways with regard to Gray streams.</p>
    10984             <table xmlns="http://www.w3.org/1999/xhtml" class="simplelist" border="0" summary="Simple list">
     10986            <table xmlns="http://www.w3.org/1999/xhtml" border="0" summary="Simple list" class="simplelist">
    1098510987              <tr>
    1098610988                <td>open-stream-p stream =&gt; generalized-boolean</td>
     
    1101611018            <p xmlns="http://www.w3.org/1999/xhtml">The following are standard, and do not behave specially
    1101711019        with regard to Gray streams, but probably should.</p>
    11018             <table xmlns="http://www.w3.org/1999/xhtml" class="simplelist" border="0" summary="Simple list">
     11020            <table xmlns="http://www.w3.org/1999/xhtml" border="0" summary="Simple list" class="simplelist">
    1101911021              <tr>
    1102011022                <td>stream-external-format</td>
     
    1113811140              <div>
    1113911141                <div class="refsect1" lang="en" xml:lang="en">
    11140                   <a xmlns="http://www.w3.org/1999/xhtml" id="id439180"></a>
     11142                  <a xmlns="http://www.w3.org/1999/xhtml" id="id433986"></a>
    1114111143                  <div class="header">Arguments and Values:</div>
    1114211144                  <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream</span></i>---a stream, presumably a fundamental-input-stream.</p>
     
    1114911151                </div>
    1115011152                <div class="refsect1" lang="en" xml:lang="en">
    11151                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448135"></a>
     11153                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434045"></a>
    1115211154                  <div class="header">Description:</div>
    1115311155                  <p xmlns="http://www.w3.org/1999/xhtml">Should try to read up to count elements from stream into the
     
    1117011172              <div>
    1117111173                <div class="refsect1" lang="en" xml:lang="en">
    11172                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448194"></a>
     11174                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434104"></a>
    1117311175                  <div class="header">Arguments and Values:</div>
    1117411176                  <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream</span></i>---a stream, presumably a fundamental-output-stream.</p>
     
    1118111183                </div>
    1118211184                <div class="refsect1" lang="en" xml:lang="en">
    11183                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448253"></a>
     11185                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434162"></a>
    1118411186                  <div class="header">Description:</div>
    1118511187                  <p xmlns="http://www.w3.org/1999/xhtml">should try to write the first count elements of list to
     
    1120111203              <div>
    1120211204                <div class="refsect1" lang="en" xml:lang="en">
    11203                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448311"></a>
     11205                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434220"></a>
    1120411206                  <div class="header">Arguments and Values:</div>
    1120511207                  <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream</span></i>---a stream, presumably a fundamental-input-stream</p>
     
    1121711219                </div>
    1121811220                <div class="refsect1" lang="en" xml:lang="en">
    11219                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448386"></a>
     11221                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434296"></a>
    1122011222                  <div class="header">Description:</div>
    1122111223                  <p xmlns="http://www.w3.org/1999/xhtml">should try to read successive elements from stream into
     
    1124011242              <div>
    1124111243                <div class="refsect1" lang="en" xml:lang="en">
    11242                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448446"></a>
     11244                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434356"></a>
    1124311245                  <div class="header">Arguments and Values:</div>
    1124411246                  <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream</span></i>---a stream, presumably a fundamental-output-stream</p>
     
    1125611258                </div>
    1125711259                <div class="refsect1" lang="en" xml:lang="en">
    11258                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448522"></a>
     11260                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434431"></a>
    1125911261                  <div class="header">Description:</div>
    1126011262                  <p xmlns="http://www.w3.org/1999/xhtml">should try to write successive elements of vector to stream,
     
    1127811280              <div>
    1127911281                <div class="refsect1" lang="en" xml:lang="en">
    11280                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448581"></a>
     11282                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434491"></a>
    1128111283                  <div class="header">Method Signatures:</div>
    1128211284                  <div class="synopsis"><span xmlns="http://www.w3.org/1999/xhtml" class="function"><strong>ccl::stream-device</strong></span> <i>
     
    1128411286                </div>
    1128511287                <div class="refsect1" lang="en" xml:lang="en">
    11286                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448600"></a>
     11288                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434509"></a>
    1128711289                  <div class="header">Arguments and Values:</div>
    1128811290                  <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">s</span></i>---a stream.</p>
     
    1129511297                </div>
    1129611298                <div class="refsect1" lang="en" xml:lang="en">
    11297                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448665"></a>
     11299                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434574"></a>
    1129811300                  <div class="header">Description:</div>
    1129911301                  <p xmlns="http://www.w3.org/1999/xhtml">Returns the file descriptor associated with
     
    1131911321              <div>
    1132011322                <div class="refsect1" lang="en" xml:lang="en">
    11321                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448735"></a>
     11323                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434644"></a>
    1132211324                  <div class="header">Description:</div>
    1132311325                  <p xmlns="http://www.w3.org/1999/xhtml">Reads up to max-octets octets from stream into ivector,
     
    1132611328                </div>
    1132711329                <div class="refsect1" lang="en" xml:lang="en">
    11328                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448747"></a>
     11330                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434656"></a>
    1132911331                  <div class="header">Arguments:</div>
    1133011332                  <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream</span></i>---An input stream. The method defined on
     
    1135111353              <div>
    1135211354                <div class="refsect1" lang="en" xml:lang="en">
    11353                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448866"></a>
     11355                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434776"></a>
    1135411356                  <div class="header">Description:</div>
    1135511357                  <p xmlns="http://www.w3.org/1999/xhtml">Writes max-octets octets to stream from ivector, starting at
     
    1135711359                </div>
    1135811360                <div class="refsect1" lang="en" xml:lang="en">
    11359                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448878"></a>
     11361                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434787"></a>
    1136011362                  <div class="header">Arguments:</div>
    1136111363                  <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream</span></i>---An input stream. The method defined on
     
    1136711369                </div>
    1136811370                <div class="refsect1" lang="en" xml:lang="en">
    11369                   <a xmlns="http://www.w3.org/1999/xhtml" id="id448950"></a>
     11371                  <a xmlns="http://www.w3.org/1999/xhtml" id="id434860"></a>
    1137011372                  <div class="header">Examples:</div>
    1137111373                  <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting">
     
    1138811390;;; Write a vector of DOUBLE-FLOATs. Note that (to maintain
    1138911391;;; alignment) there are 4 octets of padding before the 0th
    11390 ;;; element of a (VECTOR DOUBLE-FLOAT).
    11391 ;;; (Note that (= (- arch::misc-dfloat-offset
    11392 ;;;                  arch::misc-data-offset) 4))
     11392;;; element of a (VECTOR DOUBLE-FLOAT) on 32-bit platforms.
     11393;;; (Note that (= (- target::misc-dfloat-offset
     11394;;;                  target::misc-data-offset) 4))
    1139311395(defun write-double-float-vector
    1139411396    (stream vector &amp;key (start 0) (end (length vector)))
    1139511397     (check-type vector (vector double-float))
    1139611398     (let* ((start-octet (+ (* start 8)
    11397                             (- arch::misc-dfloat-offset
    11398                                arch::misc-data-offset)))
     11399                            (- target::misc-dfloat-offset
     11400                               target::misc-data-offset)))
    1139911401                (num-octets (* 8 (- end start))))
    1140011402       (stream-write-ivector stream vector start-octet num-octets)))
     
    1222012222            </div>
    1222112223            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    12222               <ul type="disc">
    12223                 <li>
     12224              <ul class="itemizedlist" type="disc">
     12225                <li class="listitem">
    1222412226                  <p><code class="code">oprofile</code> itself, which is almost certainly available via
    1222512227            your distribution's package management system if not already
    1222612228            preinstalled.</p>
    1222712229                </li>
    12228                 <li>
     12230                <li class="listitem">
    1222912231                  <p><code class="code">libelf</code>, which provides utilities for reading and writing
    1223012232            ELF files (and is likewise likely preinstalled or readily installable.)</p>
     
    1224412246        <code class="code">oprofile</code>- based profiling, we need to:</p>
    1224512247            <div xmlns="http://www.w3.org/1999/xhtml" class="orderedlist">
    12246               <ol type="1">
    12247                 <li>
     12248              <ol class="orderedlist" type="1">
     12249                <li class="listitem">
    1224812250                  <p>load any code that we want to profile</p>
    1224912251                </li>
    12250                 <li>
     12252                <li class="listitem">
    1225112253                  <p>generate a file that contains ELF symbol information describing the
    1225212254            names and addresses of all lisp functions.</p>
     
    1226412266            file to the indicated pathname.  This typically takes a few seconds.</p>
    1226512267                </li>
    12266                 <li>
     12268                <li class="listitem">
    1226712269                  <p>Generate a lisp heap image in which the ELF symbols generated in the
    1226812270            previous step are prepended.</p>
     
    1241412416            <p xmlns="http://www.w3.org/1999/xhtml">Two of the CHUD component programs are of particular interest:</p>
    1241512417            <div xmlns="http://www.w3.org/1999/xhtml" class="orderedlist">
    12416               <ol type="1">
    12417                 <li>
     12418              <ol class="orderedlist" type="1">
     12419                <li class="listitem">
    1241812420                  <p>The "Shark" application (often installed in
    1241912421            "/Developer/Applications/Performance Tools/Shark.app"), which provides a
     
    1242212424            things.</p>
    1242312425                </li>
    12424                 <li>
     12426                <li class="listitem">
    1242512427                  <p>The "shark" program ("/usr/bin/shark"), which can be used to control the
    1242612428            CHUD profiling facility and to collect sampling data, which can then be
     
    1245612458          things to prepare subsequent profiling sessions.  Those things include:</p>
    1245712459            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    12458               <ul type="disc">
    12459                 <li>
     12460              <ul class="itemizedlist" type="disc">
     12461                <li class="listitem">
    1246012462                  <p>creating a directory to store files that are related to using the CHUD
    1246112463              tools in this lisp session.  This directory is created in the user's home
     
    1246812470              timestamp.</p>
    1246912471                </li>
    12470                 <li>
     12472                <li class="listitem">
    1247112473                  <p>does whatever needs to be done to ensure that currently-defined lisp
    1247212474              functions don't move around as the result of GC activity, then writes a text
     
    1247712479              <a class="ulink" href="http://developer.apple.com/documentation/DeveloperTools/Conceptual/SharkUserGuide/MiscellaneousTopics/chapter_951_section_4.html#//apple_ref/doc/uid/TP40005233-CH14-DontLinkElementID_42" target="_top">http://developer.apple.com/documentation/DeveloperTools/Conceptual/SharkUserGuide/MiscellaneousTopics/chapter_951_section_4.html#//apple_ref/doc/uid/TP40005233-CH14-DontLinkElementID_42</a></p>
    1247812480                </li>
    12479                 <li>
     12481                <li class="listitem">
    1248012482                  <p>run the shark program ("/usr/bin/shark") and wait until it's ready to
    1248112483              receive signals that control its operation.</p>
     
    1250212504            <p xmlns="http://www.w3.org/1999/xhtml">By default, a shark profiling session will:</p>
    1250312505            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    12504               <ul type="disc">
    12505                 <li>
     12506              <ul class="itemizedlist" type="disc">
     12507                <li class="listitem">
    1250612508                  <p>use "time based" sampling, to periodically interrupt the lisp
    1250712509            process and note the value of the program counter and at least a few levels of
    1250812510            call history.</p>
    1250912511                </li>
    12510                 <li>
     12512                <li class="listitem">
    1251112513                  <p>do this sampling once every millisecond</p>
    1251212514                </li>
    12513                 <li>
     12515                <li class="listitem">
    1251412516                  <p>run for up to 30 seconds, unless told to stop earlier.</p>
    1251512517                </li>
     
    1253312535            </div>
    1253412536            <p xmlns="http://www.w3.org/1999/xhtml">
    12535             <a id="id386774" class="indexterm"></a>
     12537            <a id="id422360" class="indexterm"></a>
    1253612538            <span class="command"><strong><em class="varname"><a id="chud_shark-config-file"></a>CHUD:*SHARK-CONFIG-FILE*</em> [Variable]</strong></span>
    1253712539          </p>
     
    1253912541          configuration file created by the "Config Editor" in Shark.app.</p>
    1254012542            <p xmlns="http://www.w3.org/1999/xhtml">
    12541             <a id="id386800" class="indexterm"></a>
     12543            <a id="id388728" class="indexterm"></a>
    1254212544            <span class="command"><strong><em class="varname"><a id="chud_meter"></a>CHUD:METER</em> form <em class="varname">&amp;key</em> (reset nil) (debug-output nil) [Macro]</strong></span>
    1254312545          </p>
     
    1288812890        following conveniences for each supported type:</p>
    1288912891              <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    12890                 <ul type="disc">
    12891                   <li>
     12892                <ul class="itemizedlist" type="disc">
     12893                  <li class="listitem">
    1289212894                    <p>a <code class="code">PRINT-OBJECT</code> method is defined</p>
    1289312895                  </li>
    12894                   <li>
     12896                  <li class="listitem">
    1289512897                    <p>a foreign type name is created and treated as an alias
    1289612898          for the corresponding type. As an example, the
     
    1290112903          specify a structure of type <code class="code">NS-RECT</code>.</p>
    1290212904                  </li>
    12903                   <li>
     12905                  <li class="listitem">
    1290412906                    <p>the class is integrated into the type system so that
    1290512907            <code class="code">(TYPEP R 'NS:NS-RECT)</code> is implemented with
    1290612908            fair efficiency.</p>
    1290712909                  </li>
    12908                   <li>
     12910                  <li class="listitem">
    1290912911                    <p>inlined accessor and <code class="code">SETF</code> inverses are
    1291012912            defined for the structure type's fields.  In the case of
     
    1291812920            applicable.</p>
    1291912921                  </li>
    12920                   <li>
     12922                  <li class="listitem">
    1292112923                    <p>an initialization function is defined; for
    1292212924            example,</p>
     
    1293112933                    <p>but might be a little more efficient.</p>
    1293212934                  </li>
    12933                   <li>
     12935                  <li class="listitem">
    1293412936                    <p>a creation function is defined; for
    1293512937            example</p>
     
    1294412946          </pre>
    1294512947                  </li>
    12946                   <li>
     12948                  <li class="listitem">
    1294712949                    <p>a macro is defined which, like <code class="code">RLET</code>,
    1294812950            stack-allocates an instance of the foreign record type,
     
    1295612958          </pre>
    1295712959                  </li>
    12958                   <li>
     12960                  <li class="listitem">
    1295912961                    <p></p>
    1296012962                  </li>
     
    1297212974            </div>
    1297312975            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    12974               <ul type="disc">
    12975                 <li>
     12976              <ul class="itemizedlist" type="disc">
     12977                <li class="listitem">
    1297612978                  <p>Some foreign types are builtin: keywords denote
    1297712979            primitive,builtin types such as the IEEE-double-float type
     
    1298012982            types.</p>
    1298112983                </li>
    12982                 <li>
     12984                <li class="listitem">
    1298312985                  <p>Constructors such as :SIGNED and :UNSIGNED can be
    1298412986            used to denote signed and unsigned integer subtypes
     
    1298712989            :UNSIGNED is shorthand for (:UNSIGNED 32).</p>
    1298812990                </li>
    12989                 <li>
     12991                <li class="listitem">
    1299012992                  <p>Aliases for other (perhaps more complicated) types
    1299112993            can be defined via CCL:DEF-FOREIGN-TYPE (sort of like
     
    1299412996            (:UNSIGNED 8) on others.</p>
    1299512997                </li>
    12996                 <li>
     12998                <li class="listitem">
    1299712999                  <p>The construct (:STRUCT <span class="emphasis"><em>name</em></span>)
    1299813000                can be used to refer to a named structure type; (:UNION
     
    1300113003                union type's fields in order to refer to the type.</p>
    1300213004                </li>
    13003                 <li>
     13005                <li class="listitem">
    1300413006                  <p>If <span class="emphasis"><em>X</em></span> is a valid foreign type
    1300513007                reference,then (:* <span class="emphasis"><em>X</em></span>) denotes the
     
    1300813010                vaguely equivalent to "void*" in C.</p>
    1300913011                </li>
    13010                 <li>
     13012                <li class="listitem">
    1301113013                  <p>If a fieldlist is a list of lists, each of whose CAR
    1301213014                is a foreign field name (keyword) and whose CADR is a
     
    1302213024                to define a type alias or a pointer type.</p>
    1302313025                </li>
    13024                 <li>
     13026                <li class="listitem">
    1302513027                  <p>If <span class="emphasis"><em>X</em></span> is a defined foreign type
    1302613028                , then (:array <span class="emphasis"><em>X</em></span> &amp;rest dims)
     
    1326913271          discussed in greater detail below, but they include:</p>
    1327013272              <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    13271                 <ul type="disc">
    13272                   <li>
     13273                <ul class="itemizedlist" type="disc">
     13274                  <li class="listitem">
    1327313275                    <p>Creating a MACPTR with a specified address, usually
    1327413276                  via the function CCL:%INT-TO-PTR.</p>
    1327513277                  </li>
    13276                   <li>
     13278                  <li class="listitem">
    1327713279                    <p>Referencing the return value of a foreign function
    1327813280                  call (see )that's specified to return an address.</p>
    1327913281                  </li>
    13280                   <li>
     13282                  <li class="listitem">
    1328113283                    <p>Referencing a memory location that's specified to
    1328213284                  contain an address.</p>
     
    1362913631                <div>
    1363013632                  <div>
    13631                     <h4 class="title"><a id="id450804"></a>12.3.2.4. %int-to-ptr [Function]</h4>
     13633                    <h4 class="title"><a id="id437214"></a>12.3.2.4. %int-to-ptr [Function]</h4>
    1363213634                  </div>
    1363313635                </div>
     
    1367013672                <div>
    1367113673                  <div>
    13672                     <h4 class="title"><a id="id450878"></a>12.3.2.5. %inc-ptr [Function]</h4>
     13674                    <h4 class="title"><a id="id437288"></a>12.3.2.5. %inc-ptr [Function]</h4>
    1367313675                  </div>
    1367413676                </div>
     
    1372013722                <div>
    1372113723                  <div>
    13722                     <h4 class="title"><a id="id450970"></a>12.3.2.6. %ptr-to-int [Function]</h4>
     13724                    <h4 class="title"><a id="id437380"></a>12.3.2.6. %ptr-to-int [Function]</h4>
    1372313725                  </div>
    1372413726                </div>
     
    1376213764                <div>
    1376313765                  <div>
    13764                     <h4 class="title"><a id="id451045"></a>12.3.2.7. %null-ptr [Macro]</h4>
     13766                    <h4 class="title"><a id="id437455"></a>12.3.2.7. %null-ptr [Macro]</h4>
    1376513767                  </div>
    1376613768                </div>
     
    1378713789                <div>
    1378813790                  <div>
    13789                     <h4 class="title"><a id="id451086"></a>12.3.2.8. %null-ptr-p [Function]</h4>
     13791                    <h4 class="title"><a id="id437496"></a>12.3.2.8. %null-ptr-p [Function]</h4>
    1379013792                  </div>
    1379113793                </div>
     
    1382913831                <div>
    1383013832                  <div>
    13831                     <h4 class="title"><a id="id451161"></a>12.3.2.9. %setf-macptr [Function]</h4>
     13833                    <h4 class="title"><a id="id437572"></a>12.3.2.9. %setf-macptr [Function]</h4>
    1383213834                  </div>
    1383313835                </div>
     
    1387713879                <div>
    1387813880                  <div>
    13879                     <h4 class="title"><a id="id451252"></a>12.3.2.10. %incf-ptr [Macro]</h4>
     13881                    <h4 class="title"><a id="id437662"></a>12.3.2.10. %incf-ptr [Macro]</h4>
    1388013882                  </div>
    1388113883                </div>
     
    1392513927                <div>
    1392613928                  <div>
    13927                     <h4 class="title"><a id="id451342"></a>12.3.2.11. with-macptrs [Macro]</h4>
     13929                    <h4 class="title"><a id="id437752"></a>12.3.2.11. with-macptrs [Macro]</h4>
    1392813930                  </div>
    1392913931                </div>
     
    1397513977                <div>
    1397613978                  <div>
    13977                     <h4 class="title"><a id="id451434"></a>12.3.2.12. %stack-block [Macro]</h4>
     13979                    <h4 class="title"><a id="id437844"></a>12.3.2.12. %stack-block [Macro]</h4>
    1397813980                  </div>
    1397913981                </div>
     
    1402614028                <div>
    1402714029                  <div>
    14028                     <h4 class="title"><a id="id451526"></a>12.3.2.13. make-cstring [Function]</h4>
     14030                    <h4 class="title"><a id="id437936"></a>12.3.2.13. make-cstring [Function]</h4>
    1402914031                  </div>
    1403014032                </div>
     
    1406914071                <div>
    1407014072                  <div>
    14071                     <h4 class="title"><a id="id451602"></a>12.3.2.14. with-cstrs [Macro]</h4>
     14073                    <h4 class="title"><a id="id438013"></a>12.3.2.14. with-cstrs [Macro]</h4>
    1407214074                  </div>
    1407314075                </div>
     
    1411914121                <div>
    1412014122                  <div>
    14121                     <h4 class="title"><a id="id451694"></a>12.3.2.15. with-encoded-cstrs [Macro]</h4>
     14123                    <h4 class="title"><a id="id438104"></a>12.3.2.15. with-encoded-cstrs [Macro]</h4>
    1412214124                  </div>
    1412314125                </div>
     
    1418214184                <div>
    1418314185                  <div>
    14184                     <h4 class="title"><a id="id451818"></a>12.3.2.16. %get-cstring [Function]</h4>
     14186                    <h4 class="title"><a id="id438228"></a>12.3.2.16. %get-cstring [Function]</h4>
    1418514187                  </div>
    1418614188                </div>
     
    1422414226                <div>
    1422514227                  <div>
    14226                     <h4 class="title"><a id="id469035"></a>12.3.2.17. %str-from-ptr [Function]</h4>
     14228                    <h4 class="title"><a id="id454099"></a>12.3.2.17. %str-from-ptr [Function]</h4>
    1422714229                  </div>
    1422814230                </div>
     
    1429814300            <p xmlns="http://www.w3.org/1999/xhtml"><code class="literal">CCL</code> defines reader macros that consult these databases:</p>
    1429914301            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    14300               <ul type="disc">
    14301                 <li>
     14302              <ul class="itemizedlist" type="disc">
     14303                <li class="listitem">
    1430214304                  <p>#$foo looks up the value of the constant definition of foo</p>
    1430314305                </li>
    14304                 <li>
     14306                <li class="listitem">
    1430514307                  <p>#_foo looks up the foreign function definition for foo</p>
    1430614308                </li>
     
    1433614338            </div>
    1433714339            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    14338               <ul type="disc">
    14339                 <li>
     14340              <ul class="itemizedlist" type="disc">
     14341                <li class="listitem">
    1434014342                  <p><code class="literal">CCL</code> now preserves the case of external symbols in
    1434114343                its database
     
    1434414346                case in foreign symbol names.</p>
    1434514347                </li>
    14346                 <li>
     14348                <li class="listitem">
    1434714349                  <p>The Linux databases are derived from a somewhat
    1434814350                arbitrary set of Linux header files. Linux is enough of a
     
    1446814470        database files in that directory:</p>
    1446914471            <div xmlns="http://www.w3.org/1999/xhtml" class="orderedlist">
    14470               <ol type="1">
    14471                 <li>
     14472              <ol class="orderedlist" type="1">
     14473                <li class="listitem">
    1447214474                  <p>Create a subdirectory of "ccl:headers;" named
    1447314475                "foo".</p>
    1447414476                </li>
    14475                 <li>
     14477                <li class="listitem">
    1447614478                  <p>Create a subdirectory of "ccl:headers;foo;" named
    1447714479                "C".</p>
    1447814480                </li>
    14479                 <li>
     14481                <li class="listitem">
    1448014482                  <p>Create a file in "ccl:headers;foo;C;" named
    1448114483                "populate.sh".</p>
     
    1448614488          </pre>
    1448714489                </li>
    14488                 <li>
     14490                <li class="listitem">
    1448914491                  <p>Edit the file created above, using the "populate.sh"
    1449014492                files in the distribution as guidelines.</p>
     
    1458814590            </div>
    1458914591            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    14590               <ul type="disc">
    14591                 <li>
     14592              <ul class="itemizedlist" type="disc">
     14593                <li class="listitem">
    1459214594                  <p>Don't get me started.</p>
    1459314595                </li>
    14594                 <li>
     14596                <li class="listitem">
    1459514597                  <p>The underlying functionality has a poor notion of
    1459614598                dependency;it's not always possible to open libraries that
     
    1461414616            <p xmlns="http://www.w3.org/1999/xhtml">Darwin shared libraries come in two (basic) flavors:</p>
    1461514617            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    14616               <ul type="disc">
    14617                 <li>
     14618              <ul class="itemizedlist" type="disc">
     14619                <li class="listitem">
    1461814620                  <p>"dylibs" (which often have the extension".dylib") are
    1461914621                primarily intended to be linked against at compile/link
     
    1462814630                first and all subsequent calls.</p>
    1462914631                </li>
    14630                 <li>
     14632                <li class="listitem">
    1463114633                  <p>"bundles" are intended to serve as application
    1463214634                extensions; they can be opened multiple times (creating
     
    1471114713            </div>
    1471214714            <div xmlns="http://www.w3.org/1999/xhtml" class="orderedlist">
    14713               <ol type="1">
    14714                 <li>
     14715              <ol class="orderedlist" type="1">
     14716                <li class="listitem">
    1471514717                  <p>Ensure that the FFIGEN program is installed. See
    1471614718                the"README" file generated during the FFIGEN build process for
     
    1471914721                headers directory. </p>
    1472014722                </li>
    14721                 <li>
     14723                <li class="listitem">
    1472214724                  <p>Edit the
    1472314725                "ccl:headers;<span class="emphasis"><em>subdir</em></span>;C;populate.sh"shell
     
    1472914731                script.</p>
    1473014732                </li>
    14731                 <li>
     14733                <li class="listitem">
    1473214734                  <p>Run <code class="literal">CCL</code>:
    1473314735            </p>
     
    1484114843            foreign names via the following set of conventions:</p>
    1484214844            <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist">
    14843               <ul type="disc">
    14844                 <li>
     14845              <ul class="itemizedlist" type="disc">
     14846                <li class="listitem">
    1484514847                  <p>All instances of &lt; and &gt; in the symbol's pname
    1484614848                are balanced and don't nest.</p>
    1484714849                </li>
    14848                 <li>
     14850                <li class="listitem">
    1484914851                  <p>Any alphabetic characters in the symbol's pname
    1485014852                that aren't enclosed in angle brackets are treated as
     
    1485214854                regardless of the case in which they were written.</p>
    1485314855                </li>
    14854                 <li>
     14856                <li class="listitem">
    1485514857                  <p>Alphabetic characters that appear within angle
    1485614858                brackets are mapped to upper-case, again regardless of how
     
    1500515007      -install_name ./libtypetest.dylib
    1500615008    </pre>
    15007           <div xmlns="http://www.w3.org/1999/xhtml" class="tip" style="margin-left: 0.5in; margin-right: 0.5in;">
     15009          <div xmlns="http://www.w3.org/1999/xhtml" class="tip" title="Tip" style="margin-left: 0.5in; margin-right: 0.5in;">
    1500815010            <h3 class="title">Tip</h3>
    1500915011            <p>Users of 64-bit platforms may need to pass options such
     
    1567015672            <div>
    1567115673              <div class="refsect1" lang="en" xml:lang="en">
    15672                 <a xmlns="http://www.w3.org/1999/xhtml" id="id470989"></a>
     15674                <a xmlns="http://www.w3.org/1999/xhtml" id="id456053"></a>
    1567315675                <div class="header">Description:</div>
    1567415676                <p xmlns="http://www.w3.org/1999/xhtml">Reads a symbol from the current input stream, with *PACKAGE*
     
    1572215724            <div>
    1572315725              <div class="refsect1" lang="en" xml:lang="en">
    15724                 <a xmlns="http://www.w3.org/1999/xhtml" id="id471095"></a>
     15726                <a xmlns="http://www.w3.org/1999/xhtml" id="id456159"></a>
    1572515727                <div class="header">Description:</div>
    1572615728                <p xmlns="http://www.w3.org/1999/xhtml">In <code class="literal">CCL</code> 1.2 and later, the #&amp; reader macro can be used to
     
    1578115783            <div>
    1578215784              <div class="refsect1" lang="en" xml:lang="en">
    15783                 <a xmlns="http://www.w3.org/1999/xhtml" id="id471213"></a>
     15785                <a xmlns="http://www.w3.org/1999/xhtml" id="id456276"></a>
    1578415786                <div class="header">Description:</div>
    1578515787                <p xmlns="http://www.w3.org/1999/xhtml">In <code class="literal">CCL</code> 0.14.2 and later, the #? reader macro can be used
     
    1582815830            <div>
    1582915831              <div class="refsect1" lang="en" xml:lang="en">
    15830                 <a xmlns="http://www.w3.org/1999/xhtml" id="id471295"></a>
     15832                <a xmlns="http://www.w3.org/1999/xhtml" id="id456359"></a>
    1583115833                <div class="header">Description:</div>
    1583215834                <p xmlns="http://www.w3.org/1999/xhtml">In <code class="literal">CCL</code> 1.2 and later, the #/ reader macro can be used to
     
    1593115933            <div>
    1593215934              <div class="refsect1" lang="en" xml:lang="en">
    15933                 <a xmlns="http://www.w3.org/1999/xhtml" id="id471434"></a>
     15935                <a xmlns="http://www.w3.org/1999/xhtml" id="id456498"></a>
    1593415936                <div class="header">Description:</div>
    1593515937                <p xmlns="http://www.w3.org/1999/xhtml">In <code class="literal">CCL</code> 1.2 and later, the #&gt; reader macro reads
     
    1596015962            <div>
    1596115963              <div class="refsect1" lang="en" xml:lang="en">
    15962                 <a xmlns="http://www.w3.org/1999/xhtml" id="id471509"></a>
     15964                <a xmlns="http://www.w3.org/1999/xhtml" id="id456572"></a>
    1596315965                <div class="header">Values:</div>
    1596415966                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">library</span></i>---either an object of type SHLIB, or a string which
     
    1596715969              </div>
    1596815970              <div class="refsect1" lang="en" xml:lang="en">
    15969                 <a xmlns="http://www.w3.org/1999/xhtml" id="id471545"></a>
     15971                <a xmlns="http://www.w3.org/1999/xhtml" id="id456609"></a>
    1597015972                <div class="header">Description:</div>
    1597115973                <p xmlns="http://www.w3.org/1999/xhtml">If <em class="varname">completely</em> is T, sets the
     
    1599615998            <div>
    1599715999              <div class="refsect1" lang="en" xml:lang="en">
    15998                 <a xmlns="http://www.w3.org/1999/xhtml" id="id471621"></a>
     16000                <a xmlns="http://www.w3.org/1999/xhtml" id="id456685"></a>
    1599916001                <div class="header">Values:</div>
    1600016002                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---A symbol which can be made into a special variable</p>
     
    1601316015              </div>
    1601416016              <div class="refsect1" lang="en" xml:lang="en">
    16015                 <a xmlns="http://www.w3.org/1999/xhtml" id="id471692"></a>
     16017                <a xmlns="http://www.w3.org/1999/xhtml" id="id456756"></a>
    1601616018                <div class="header">Description:</div>
    1601716019                <p xmlns="http://www.w3.org/1999/xhtml">Proclaims <em class="varname">name</em>
     
    1604916051            <div>
    1605016052              <div class="refsect1" lang="en" xml:lang="en">
    16051                 <a xmlns="http://www.w3.org/1999/xhtml" id="id471772"></a>
     16053                <a xmlns="http://www.w3.org/1999/xhtml" id="id456835"></a>
    1605216054                <div class="header">Values:</div>
    1605316055                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---NIL or a keyword; the keyword may contain
     
    1605716059              </div>
    1605816060              <div class="refsect1" lang="en" xml:lang="en">
    16059                 <a xmlns="http://www.w3.org/1999/xhtml" id="id471813"></a>
     16061                <a xmlns="http://www.w3.org/1999/xhtml" id="id456877"></a>
    1606016062                <div class="header">Description:</div>
    1606116063                <p xmlns="http://www.w3.org/1999/xhtml">If name is non-NIL, defines name to be an alias for the
     
    1609116093            <div>
    1609216094              <div class="refsect1" lang="en" xml:lang="en">
    16093                 <a xmlns="http://www.w3.org/1999/xhtml" id="id471886"></a>
     16095                <a xmlns="http://www.w3.org/1999/xhtml" id="id456949"></a>
    1609416096                <div class="header">Values:</div>
    1609516097                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---
     
    1610416106              </div>
    1610516107              <div class="refsect1" lang="en" xml:lang="en">
    16106                 <a xmlns="http://www.w3.org/1999/xhtml" id="id471926"></a>
     16108                <a xmlns="http://www.w3.org/1999/xhtml" id="id456990"></a>
    1610716109                <div class="header">Description:</div>
    1610816110                <p xmlns="http://www.w3.org/1999/xhtml">If there is already an EXTERNAL-ENTRY-POINT for
     
    1613216134            <div>
    1613316135              <div class="refsect1" lang="en" xml:lang="en">
    16134                 <a xmlns="http://www.w3.org/1999/xhtml" id="id471995"></a>
     16136                <a xmlns="http://www.w3.org/1999/xhtml" id="id457059"></a>
    1613516137                <div class="header">Values:</div>
    1613616138                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---A lisp string. See external, above.</p>
     
    1614516147              </div>
    1614616148              <div class="refsect1" lang="en" xml:lang="en">
    16147                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472069"></a>
     16149                <a xmlns="http://www.w3.org/1999/xhtml" id="id457132"></a>
    1614816150                <div class="header">Description:</div>
    1614916151                <p xmlns="http://www.w3.org/1999/xhtml">Calls the foreign function at the address obtained by
     
    1617216174            <div>
    1617316175              <div class="refsect1" lang="en" xml:lang="en">
    16174                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472128"></a>
     16176                <a xmlns="http://www.w3.org/1999/xhtml" id="id457192"></a>
    1617516177                <div class="header">Values:</div>
    1617616178                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">entrypoint</span></i>---A fixnum or MACPTR</p>
     
    1618316185              </div>
    1618416186              <div class="refsect1" lang="en" xml:lang="en">
    16185                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472191"></a>
     16187                <a xmlns="http://www.w3.org/1999/xhtml" id="id457255"></a>
    1618616188                <div class="header">Description:</div>
    1618716189                <p xmlns="http://www.w3.org/1999/xhtml">Calls the foreign function at address entrypoint passing the
     
    1620916211            <div>
    1621016212              <div class="refsect1" lang="en" xml:lang="en">
    16211                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472250"></a>
     16213                <a xmlns="http://www.w3.org/1999/xhtml" id="id457314"></a>
    1621216214                <div class="header">Values:</div>
    1621316215                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">entrypoint</span></i>---A fixnum or MACPTR</p>
     
    1622216224              </div>
    1622316225              <div class="refsect1" lang="en" xml:lang="en">
    16224                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472324"></a>
     16226                <a xmlns="http://www.w3.org/1999/xhtml" id="id457387"></a>
    1622516227                <div class="header">Description:</div>
    1622616228                <p xmlns="http://www.w3.org/1999/xhtml">Calls the foreign function at address entrypoint passing the
     
    1624716249            <div>
    1624816250              <div class="refsect1" lang="en" xml:lang="en">
    16249                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472380"></a>
     16251                <a xmlns="http://www.w3.org/1999/xhtml" id="id457443"></a>
    1625016252                <div class="header">Values:</div>
    1625116253                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---A lisp string.</p>
    1625216254              </div>
    1625316255              <div class="refsect1" lang="en" xml:lang="en">
    16254                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472402"></a>
     16256                <a xmlns="http://www.w3.org/1999/xhtml" id="id457466"></a>
    1625516257                <div class="header">Description:</div>
    1625616258                <p xmlns="http://www.w3.org/1999/xhtml">Tries to resolve the address of the foreign symbol
     
    1627516277            <div>
    1627616278              <div class="refsect1" lang="en" xml:lang="en">
    16277                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472461"></a>
     16279                <a xmlns="http://www.w3.org/1999/xhtml" id="id457525"></a>
    1627816280                <div class="header">Values:</div>
    1627916281                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---A lisp string.</p>
    1628016282              </div>
    1628116283              <div class="refsect1" lang="en" xml:lang="en">
    16282                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472484"></a>
     16284                <a xmlns="http://www.w3.org/1999/xhtml" id="id457547"></a>
    1628316285                <div class="header">Description:</div>
    1628416286                <p xmlns="http://www.w3.org/1999/xhtml">Tries to resolve the address of the foreign symbol name. If
     
    1630216304            <div>
    1630316305              <div class="refsect1" lang="en" xml:lang="en">
    16304                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472538"></a>
     16306                <a xmlns="http://www.w3.org/1999/xhtml" id="id457601"></a>
    1630516307                <div class="header">Values:</div>
    1630616308                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">ptr</span></i>---A <code xmlns="http://www.w3.org/1999/xhtml" class="code">MACPTR</code> that points to a block of
     
    1630816310              </div>
    1630916311              <div class="refsect1" lang="en" xml:lang="en">
    16310                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472564"></a>
     16312                <a xmlns="http://www.w3.org/1999/xhtml" id="id457627"></a>
    1631116313                <div class="header">Description:</div>
    1631216314                <p xmlns="http://www.w3.org/1999/xhtml">In <code class="literal">CCL</code> 1.2 and later, the <code class="code">CCL:FREE</code>
     
    1634016342            <div>
    1634116343              <div class="refsect1" lang="en" xml:lang="en">
    16342                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472657"></a>
     16344                <a xmlns="http://www.w3.org/1999/xhtml" id="id457720"></a>
    1634316345                <div class="header">Values:</div>
    1634416346                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">element-count</span></i>---A positive integer.</p>
     
    1635516357              </div>
    1635616358              <div class="refsect1" lang="en" xml:lang="en">
    16357                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472732"></a>
     16359                <a xmlns="http://www.w3.org/1999/xhtml" id="id457795"></a>
    1635816360                <div class="header">Description:</div>
    1635916361                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1639016392            <div>
    1639116393              <div class="refsect1" lang="en" xml:lang="en">
    16392                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472804"></a>
     16394                <a xmlns="http://www.w3.org/1999/xhtml" id="id457867"></a>
    1639316395                <div class="header">Values:</div>
    1639416396                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">typespec</span></i>---A foreign type specifier, or a keyword which is used
     
    1640716409              </div>
    1640816410              <div class="refsect1" lang="en" xml:lang="en">
    16409                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472871"></a>
     16411                <a xmlns="http://www.w3.org/1999/xhtml" id="id457934"></a>
    1641016412                <div class="header">Description:</div>
    1641116413                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1645616458            <div>
    1645716459              <div class="refsect1" lang="en" xml:lang="en">
    16458                 <a xmlns="http://www.w3.org/1999/xhtml" id="id472993"></a>
     16460                <a xmlns="http://www.w3.org/1999/xhtml" id="id458057"></a>
    1645916461                <div class="header">Values:</div>
    1646016462                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">typespec</span></i>---A foreign type specifier, or a keyword which is used
     
    1647016472              </div>
    1647116473              <div class="refsect1" lang="en" xml:lang="en">
    16472                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473051"></a>
     16474                <a xmlns="http://www.w3.org/1999/xhtml" id="id458115"></a>
    1647316475                <div class="header">Description:</div>
    1647416476                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1651116513              </div>
    1651216514              <div class="refsect1" lang="en" xml:lang="en">
    16513                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473141"></a>
     16515                <a xmlns="http://www.w3.org/1999/xhtml" id="id458204"></a>
    1651416516                <div class="header">Notes:</div>
    1651516517                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1654416546            <div>
    1654516547              <div class="refsect1" lang="en" xml:lang="en">
    16546                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473224"></a>
     16548                <a xmlns="http://www.w3.org/1999/xhtml" id="id458288"></a>
    1654716549                <div class="header">Values:</div>
    1654816550                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---A SIMPLE-STRING which is presumed to be the so-name of
     
    1655216554              </div>
    1655316555              <div class="refsect1" lang="en" xml:lang="en">
    16554                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473264"></a>
     16556                <a xmlns="http://www.w3.org/1999/xhtml" id="id458328"></a>
    1655516557                <div class="header">Description:</div>
    1655616558                <p xmlns="http://www.w3.org/1999/xhtml">If the library denoted by <em class="varname">name</em> can
     
    1656316565              </div>
    1656416566              <div class="refsect1" lang="en" xml:lang="en">
    16565                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473280"></a>
     16567                <a xmlns="http://www.w3.org/1999/xhtml" id="id458344"></a>
    1656616568                <div class="header">Examples:</div>
    1656716569                <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting">;;; Try to do something simple.
     
    1659816600              </div>
    1659916601              <div class="refsect1" lang="en" xml:lang="en">
    16600                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473301"></a>
     16602                <a xmlns="http://www.w3.org/1999/xhtml" id="id458364"></a>
    1660116603                <div class="header">Notes:</div>
    1660216604                <p xmlns="http://www.w3.org/1999/xhtml">It would be helpful to describe what an soname is and give
     
    1662116623            <div>
    1662216624              <div class="refsect1" lang="en" xml:lang="en">
    16623                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473358"></a>
     16625                <a xmlns="http://www.w3.org/1999/xhtml" id="id458422"></a>
    1662416626                <div class="header">Values:</div>
    1662516627                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">ptr</span></i>---<a xmlns="http://www.w3.org/1999/xhtml" class="link" href="#Referencing-and-Using-Foreign-Memory-Addresses" title="12.3. Referencing and Using Foreign Memory Addresses">a MACPTR</a>.</p>
     
    1662916631              </div>
    1663016632              <div class="refsect1" lang="en" xml:lang="en">
    16631                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473402"></a>
     16633                <a xmlns="http://www.w3.org/1999/xhtml" id="id458466"></a>
    1663216634                <div class="header">Description:</div>
    1663316635                <p xmlns="http://www.w3.org/1999/xhtml">References an instance of a foreign type (or a component of
     
    1665516657            <div>
    1665616658              <div class="refsect1" lang="en" xml:lang="en">
    16657                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473468"></a>
     16659                <a xmlns="http://www.w3.org/1999/xhtml" id="id458531"></a>
    1665816660                <div class="header">Values:</div>
    1665916661                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">eep</span></i>---An EXTERNAL-ENTRY-POINT, as obtained by the EXTERNAL
     
    1666116663              </div>
    1666216664              <div class="refsect1" lang="en" xml:lang="en">
    16663                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473491"></a>
     16665                <a xmlns="http://www.w3.org/1999/xhtml" id="id458554"></a>
    1666416666                <div class="header">Description:</div>
    1666516667                <p xmlns="http://www.w3.org/1999/xhtml">Tries to resolve the address of the EXTERNAL-ENTRY-POINT
     
    1668416686            <div>
    1668516687              <div class="refsect1" lang="en" xml:lang="en">
    16686                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473562"></a>
     16688                <a xmlns="http://www.w3.org/1999/xhtml" id="id458626"></a>
    1668716689                <div class="header">Values:</div>
    1668816690                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">var</span></i>---A symbol (a lisp variable)</p>
     
    1669216694              </div>
    1669316695              <div class="refsect1" lang="en" xml:lang="en">
    16694                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473613"></a>
     16696                <a xmlns="http://www.w3.org/1999/xhtml" id="id458677"></a>
    1669516697                <div class="header">Description:</div>
    1669616698                <p xmlns="http://www.w3.org/1999/xhtml">Executes <em class="varname">body</em>
     
    1672216724            <div>
    1672316725              <div class="refsect1" lang="en" xml:lang="en">
    16724                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473694"></a>
     16726                <a xmlns="http://www.w3.org/1999/xhtml" id="id458758"></a>
    1672516727                <div class="header">Values:</div>
    1672616728                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">var</span></i>---A symbol (a lisp variable)</p>
     
    1672916731              </div>
    1673016732              <div class="refsect1" lang="en" xml:lang="en">
    16731                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473742"></a>
     16733                <a xmlns="http://www.w3.org/1999/xhtml" id="id458806"></a>
    1673216734                <div class="header">Description:</div>
    1673316735                <p xmlns="http://www.w3.org/1999/xhtml">Executes body in an environment in which each var is
     
    1675616758            <div>
    1675716759              <div class="refsect1" lang="en" xml:lang="en">
    16758                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473809"></a>
     16760                <a xmlns="http://www.w3.org/1999/xhtml" id="id458873"></a>
    1675916761                <div class="header">Values:</div>
    1676016762                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">object</span></i>---A CLOS object of a class for which there exists
     
    1676416766              </div>
    1676516767              <div class="refsect1" lang="en" xml:lang="en">
    16766                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473838"></a>
     16768                <a xmlns="http://www.w3.org/1999/xhtml" id="id458901"></a>
    1676716769                <div class="header">Description:</div>
    1676816770                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1680116803              </div>
    1680216804              <div class="refsect1" lang="en" xml:lang="en">
    16803                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473894"></a>
     16805                <a xmlns="http://www.w3.org/1999/xhtml" id="id458958"></a>
    1680416806                <div class="header">Example:</div>
    1680516807                <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting">
     
    1681516817              </div>
    1681616818              <div class="refsect1" lang="en" xml:lang="en">
    16817                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473909"></a>
     16819                <a xmlns="http://www.w3.org/1999/xhtml" id="id458972"></a>
    1681816820                <div class="header">See Also:</div>
    1681916821                <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist">
     
    1683716839            <div>
    1683816840              <div class="refsect1" lang="en" xml:lang="en">
    16839                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473969"></a>
     16841                <a xmlns="http://www.w3.org/1999/xhtml" id="id459032"></a>
    1684016842                <div class="header">Values:</div>
    1684116843                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">dir-id</span></i>---A keyword whose pname, mapped to lower case, names a
     
    1684416846              </div>
    1684516847              <div class="refsect1" lang="en" xml:lang="en">
    16846                 <a xmlns="http://www.w3.org/1999/xhtml" id="id473992"></a>
     16848                <a xmlns="http://www.w3.org/1999/xhtml" id="id459056"></a>
    1684716849                <div class="header">Description:</div>
    1684816850                <p xmlns="http://www.w3.org/1999/xhtml">Tells <code class="literal">CCL</code> to remove the interface directory denoted by
     
    1686816870            <div>
    1686916871              <div class="refsect1" lang="en" xml:lang="en">
    16870                 <a xmlns="http://www.w3.org/1999/xhtml" id="id474052"></a>
     16872                <a xmlns="http://www.w3.org/1999/xhtml" id="id459116"></a>
    1687116873                <div class="header">Values:</div>
    1687216874                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">dir-id</span></i>---A keyword whose pname, mapped to lower case, names a
     
    1687516877              </div>
    1687616878              <div class="refsect1" lang="en" xml:lang="en">
    16877                 <a xmlns="http://www.w3.org/1999/xhtml" id="id474076"></a>
     16879                <a xmlns="http://www.w3.org/1999/xhtml" id="id459140"></a>
    1687816880                <div class="header">Description:</div>
    1687916881                <p xmlns="http://www.w3.org/1999/xhtml">Tells <code class="literal">CCL</code> to add the interface directory denoted by
     
    1689716899              </div>
    1689816900              <div class="refsect1" lang="en" xml:lang="en">
    16899                 <a xmlns="http://www.w3.org/1999/xhtml" id="id474114"></a>
     16901                <a xmlns="http://www.w3.org/1999/xhtml" id="id459178"></a>
    1690016902                <div class="header">Examples:</div>
    1690116903                <p xmlns="http://www.w3.org/1999/xhtml">One typically wants interface information to be
     
    1790517907          <p xmlns="http://www.w3.org/1999/xhtml">To see how a given Objective-C or Lisp name will be translated by
    1790617908      the bridge, you can use the following functions:</p>
    17907           <table xmlns="http://www.w3.org/1999/xhtml" class="simplelist" border="0" summary="Simple list">
     17909          <table xmlns="http://www.w3.org/1999/xhtml" border="0" summary="Simple list" class="simplelist">
    1790817910            <tr>
    1790917911              <td>(ccl::objc-to-lisp-classname string)</td>
     
    1831318315            <p xmlns="http://www.w3.org/1999/xhtml">All of the symbols described below are currently internal to
    1831418316        the CCL package.</p>
    18315             <table xmlns="http://www.w3.org/1999/xhtml" class="simplelist" border="0" summary="Simple list">
     18317            <table xmlns="http://www.w3.org/1999/xhtml" border="0" summary="Simple list" class="simplelist">
    1831618318              <tr>
    1831718319                <td>
     
    1855018552            <div>
    1855118553              <div class="refsect1" lang="en" xml:lang="en">
    18552                 <a xmlns="http://www.w3.org/1999/xhtml" id="id464768"></a>
     18554                <a xmlns="http://www.w3.org/1999/xhtml" id="id450675"></a>
    1855318555                <div class="header">Arguments and Values:</div>
    1855418556                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---a string which is the name of an existing
     
    1856018562              </div>
    1856118563              <div class="refsect1" lang="en" xml:lang="en">
    18562                 <a xmlns="http://www.w3.org/1999/xhtml" id="id464813"></a>
     18564                <a xmlns="http://www.w3.org/1999/xhtml" id="id450720"></a>
    1856318565                <div class="header">Description:</div>
    1856418566                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1858118583            <div>
    1858218584              <div class="refsect1" lang="en" xml:lang="en">
    18583                 <a xmlns="http://www.w3.org/1999/xhtml" id="id464874"></a>
     18585                <a xmlns="http://www.w3.org/1999/xhtml" id="id452269"></a>
    1858418586                <div class="header">Arguments and Values:</div>
    1858518587                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---a string which is the name of a new or existing
     
    1859418596              </div>
    1859518597              <div class="refsect1" lang="en" xml:lang="en">
    18596                 <a xmlns="http://www.w3.org/1999/xhtml" id="id464934"></a>
     18598                <a xmlns="http://www.w3.org/1999/xhtml" id="id452329"></a>
    1859718599                <div class="header">Description:</div>
    1859818600                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1861818620            <div>
    1861918621              <div class="refsect1" lang="en" xml:lang="en">
    18620                 <a xmlns="http://www.w3.org/1999/xhtml" id="id464996"></a>
     18622                <a xmlns="http://www.w3.org/1999/xhtml" id="id452391"></a>
    1862118623                <div class="header">Values:</div>
    1862218624                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">path</span></i>---a string, an absolute pathname in Posix format - with
     
    1862418626              </div>
    1862518627              <div class="refsect1" lang="en" xml:lang="en">
    18626                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465023"></a>
     18628                <a xmlns="http://www.w3.org/1999/xhtml" id="id452418"></a>
    1862718629                <div class="header">Description:</div>
    1862818630                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1864618648            <div>
    1864718649              <div class="refsect1" lang="en" xml:lang="en">
    18648                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465082"></a>
     18650                <a xmlns="http://www.w3.org/1999/xhtml" id="id452477"></a>
    1864918651                <div class="header">Values:</div>
    1865018652                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">uid</span></i>---a non-negative integer, identifying a specific user
     
    1865218654              </div>
    1865318655              <div class="refsect1" lang="en" xml:lang="en">
    18654                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465109"></a>
     18656                <a xmlns="http://www.w3.org/1999/xhtml" id="id452504"></a>
    1865518657                <div class="header">Description:</div>
    1865618658                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1867218674            <div>
    1867318675              <div class="refsect1" lang="en" xml:lang="en">
    18674                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465166"></a>
     18676                <a xmlns="http://www.w3.org/1999/xhtml" id="id452561"></a>
    1867518677                <div class="header">Arguments and Values:</div>
    1867618678                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">uid</span></i>---a non-negative integer, identifying a specific user
     
    1868118683              </div>
    1868218684              <div class="refsect1" lang="en" xml:lang="en">
    18683                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465209"></a>
     18685                <a xmlns="http://www.w3.org/1999/xhtml" id="id452604"></a>
    1868418686                <div class="header">Description:</div>
    1868518687                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1870418706            <div>
    1870518707              <div class="refsect1" lang="en" xml:lang="en">
    18706                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465268"></a>
     18708                <a xmlns="http://www.w3.org/1999/xhtml" id="id452663"></a>
    1870718709                <div class="header">Arguments and Values:</div>
    1870818710                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">gid</span></i>---a non-negative integer, identifying a specific
     
    1871318715              </div>
    1871418716              <div class="refsect1" lang="en" xml:lang="en">
    18715                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465311"></a>
     18717                <a xmlns="http://www.w3.org/1999/xhtml" id="id452706"></a>
    1871618718                <div class="header">Description:</div>
    1871718719                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1873618738            <div>
    1873718739              <div class="refsect1" lang="en" xml:lang="en">
    18738                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465370"></a>
     18740                <a xmlns="http://www.w3.org/1999/xhtml" id="id452765"></a>
    1873918741                <div class="header">Values:</div>
    1874018742                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">pid</span></i>---a non-negative integer, identifying an OS process</p>
    1874118743              </div>
    1874218744              <div class="refsect1" lang="en" xml:lang="en">
    18743                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465396"></a>
     18745                <a xmlns="http://www.w3.org/1999/xhtml" id="id452791"></a>
    1874418746                <div class="header">Description:</div>
    1874518747                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1876218764            <div>
    1876318765              <div class="refsect1" lang="en" xml:lang="en">
    18764                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465453"></a>
     18766                <a xmlns="http://www.w3.org/1999/xhtml" id="id452848"></a>
    1876518767                <div class="header">Values:</div>
    1876618768                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">uid</span></i>---a non-negative integer, identifying a specific user
     
    1877018772              </div>
    1877118773              <div class="refsect1" lang="en" xml:lang="en">
    18772                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465496"></a>
     18774                <a xmlns="http://www.w3.org/1999/xhtml" id="id452891"></a>
    1877318775                <div class="header">Description:</div>
    1877418776                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1879518797            <div>
    1879618798              <div class="refsect1" lang="en" xml:lang="en">
    18797                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465565"></a>
     18799                <a xmlns="http://www.w3.org/1999/xhtml" id="id452960"></a>
    1879818800                <div class="header">Values:</div>
    1879918801                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">command-line</span></i>---a string, obeying all the whitespace and
     
    1880418806              </div>
    1880518807              <div class="refsect1" lang="en" xml:lang="en">
    18806                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465607"></a>
     18808                <a xmlns="http://www.w3.org/1999/xhtml" id="id453002"></a>
    1880718809                <div class="header">Description:</div>
    1880818810                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1882018822              </div>
    1882118823              <div class="refsect1" lang="en" xml:lang="en">
    18822                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465641"></a>
     18824                <a xmlns="http://www.w3.org/1999/xhtml" id="id453036"></a>
    1882318825                <div class="header">Notes:</div>
    1882418826                <p xmlns="http://www.w3.org/1999/xhtml">
     
    1884518847            <div>
    1884618848              <div class="refsect1" lang="en" xml:lang="en">
    18847                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465701"></a>
     18849                <a xmlns="http://www.w3.org/1999/xhtml" id="id453096"></a>
    1884818850                <div class="header">Arguments and Values:</div>
    1884918851                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">class-name</span></i>---a string which denotes an existing class name, or a
     
    1885218854              </div>
    1885318855              <div class="refsect1" lang="en" xml:lang="en">
    18854                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465729"></a>
     18856                <a xmlns="http://www.w3.org/1999/xhtml" id="id453124"></a>
    1885518857                <div class="header">Description:</div>
    1885618858                <p xmlns="http://www.w3.org/1999/xhtml">Used to refer to a known ObjC class by name. (Via the use
     
    1887718879            <div>
    1887818880              <div class="refsect1" lang="en" xml:lang="en">
    18879                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465798"></a>
     18881                <a xmlns="http://www.w3.org/1999/xhtml" id="id453193"></a>
    1888018882                <div class="header">Arguments and Values:</div>
    1888118883                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">string</span></i>---a string constant, used to canonically refer to an
     
    1888318885              </div>
    1888418886              <div class="refsect1" lang="en" xml:lang="en">
    18885                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465824"></a>
     18887                <a xmlns="http://www.w3.org/1999/xhtml" id="id453219"></a>
    1888618888                <div class="header">Description:</div>
    1888718889                <p xmlns="http://www.w3.org/1999/xhtml">Used to refer to an ObjC method selector (method name). Uses
     
    1890518907            <div>
    1890618908              <div class="refsect1" lang="en" xml:lang="en">
    18907                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465890"></a>
     18909                <a xmlns="http://www.w3.org/1999/xhtml" id="id453285"></a>
    1890818910                <div class="header">Arguments and Values:</div>
    1890918911                <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name-and-result-type</span></i>---either an Objective-C message name, for methods
     
    1892718929              </div>
    1892818930              <div class="refsect1" lang="en" xml:lang="en">
    18929                 <a xmlns="http://www.w3.org/1999/xhtml" id="id465971"></a>
     18931                <a xmlns="http://www.w3.org/1999/xhtml" id="id453366"></a>
    1893018932                <div class="header">Description:</div>
    1893118933                <p xmlns="http://www.w3.org/1999/xhtml">Defines an Objective-C-callable method which implements
     
    1895218954            <div>
    1895318955              <div class="ref