Changeset 10552
- Timestamp:
- 08/22/08 19:00:39 (3 months ago)
- Files:
-
- trunk/source/doc/ccl-documentation.html (modified) (489 diffs)
- trunk/source/doc/src/makefile-common (modified) (2 diffs)
Legend:
- Unmodified
- Added
- Removed
- Modified
- Copied
- Moved
trunk/source/doc/ccl-documentation.html
r9209 r10552 6 6 <title>Clozure CL Documentation</title> 7 7 <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /> 8 <link rel="start" href="#id 301106" title="Clozure CL Documentation" />9 <link rel="next" href="#id 322476" title="Chapter 1. About Clozure CL" />8 <link rel="start" href="#id472427" title="Clozure CL Documentation" /> 9 <link rel="next" href="#id491128" title="Chapter 1. About Clozure CL" /> 10 10 </head> 11 11 <body> … … 14 14 <div> 15 15 <div> 16 <h1 class="title"><a id="id 301106"></a>Clozure CL Documentation</h1>16 <h1 class="title"><a id="id472427"></a>Clozure CL Documentation</h1> 17 17 </div> 18 18 </div> … … 23 23 <dt> 24 24 <span class="chapter"> 25 <a href="#id 322476">1. About Clozure CL</a>25 <a href="#id491128">1. About Clozure CL</a> 26 26 </span> 27 27 </dt> … … 30 30 <dt> 31 31 <span class="sect1"> 32 <a href="#id 378260">1.1. Introduction to Clozure CL</a>32 <a href="#id547615">1.1. Introduction to Clozure CL</a> 33 33 </span> 34 34 </dt> … … 37 37 <dt> 38 38 <span class="chapter"> 39 <a href="#id 335115">2. Obtaining, Installing, and Running Clozure CL</a>39 <a href="#id503984">2. Obtaining, Installing, and Running Clozure CL</a> 40 40 </span> 41 41 </dt> … … 44 44 <dt> 45 45 <span class="sect1"> 46 <a href="#id 360672">2.1. Releases and System Requirements</a>46 <a href="#id540208">2.1. Releases and System Requirements</a> 47 47 </span> 48 48 </dt> 49 49 <dt> 50 50 <span class="sect1"> 51 <a href="#id 364310">2.2. Obtaining Clozure CL</a>51 <a href="#id538413">2.2. Obtaining Clozure CL</a> 52 52 </span> 53 53 </dt> 54 54 <dt> 55 55 <span class="sect1"> 56 <a href="#id 308181">2.3. Command Line Set Up</a>56 <a href="#id548194">2.3. Command Line Set Up</a> 57 57 </span> 58 58 </dt> … … 81 81 <dt> 82 82 <span class="chapter"> 83 <a href="#id 321732">3. Building Clozure CL from its Source Code</a>83 <a href="#id503558">3. Building Clozure CL from its Source Code</a> 84 84 </span> 85 85 </dt> … … 115 115 <dt> 116 116 <span class="chapter"> 117 <a href="#id 322946">4. Using Clozure CL</a>117 <a href="#id518767">4. Using Clozure CL</a> 118 118 </span> 119 119 </dt> … … 122 122 <dt> 123 123 <span class="sect1"> 124 <a href="#id 370264">4.1. Introduction</a>124 <a href="#id565771">4.1. Introduction</a> 125 125 </span> 126 126 </dt> … … 159 159 <dt> 160 160 <span class="chapter"> 161 <a href="#id 351866">5. The Clozure CL IDE</a>161 <a href="#id552477">5. The Clozure CL IDE</a> 162 162 </span> 163 163 </dt> … … 166 166 <dt> 167 167 <span class="sect1"> 168 <a href="#id 391992">5.1. Introduction</a>168 <a href="#id544505">5.1. Introduction</a> 169 169 </span> 170 170 </dt> 171 171 <dt> 172 172 <span class="sect1"> 173 <a href="#id 388704">5.2. Building the IDE</a>173 <a href="#id524038">5.2. Building the IDE</a> 174 174 </span> 175 175 </dt> 176 176 <dt> 177 177 <span class="sect1"> 178 <a href="#id 352336">5.3. Running the IDE</a>178 <a href="#id562577">5.3. Running the IDE</a> 179 179 </span> 180 180 </dt> 181 181 <dt> 182 182 <span class="sect1"> 183 <a href="#id 349170">5.4. IDE Features</a>183 <a href="#id530061">5.4. IDE Features</a> 184 184 </span> 185 185 </dt> 186 186 <dt> 187 187 <span class="sect1"> 188 <a href="#id 394341">5.5. IDE Sources</a>188 <a href="#id526212">5.5. IDE Sources</a> 189 189 </span> 190 190 </dt> 191 191 <dt> 192 192 <span class="sect1"> 193 <a href="#id 394374">5.6. The Application Builder</a>193 <a href="#id526247">5.6. The Application Builder</a> 194 194 </span> 195 195 </dt> … … 198 198 <dt> 199 199 <span class="chapter"> 200 <a href="# Questions-and-Answers">6. Questions and Answers</a>200 <a href="#Programming-with-Threads">6. Programming with Threads</a> 201 201 </span> 202 202 </dt> … … 205 205 <dt> 206 206 <span class="sect1"> 207 <a href="# How-can-I-do-nonblocking--aka--unbuffered--and--raw---IO-">6.1. How can I do nonblocking (aka "unbuffered" and "raw") IO?</a>207 <a href="#Threads-overview">6.1. Threads Overview</a> 208 208 </span> 209 209 </dt> 210 210 <dt> 211 211 <span class="sect1"> 212 <a href="#I-m-using-the-graphics-demos--Why-doesn-t-the-menubar-change-">6.2. I'm using the graphics demos. Why doesn't the menubar 213 change?</a> 212 <a href="#Intentionally--Missing-Functionality">6.2. (Intentionally) Missing Functionality</a> 214 213 </span> 215 214 </dt> 216 215 <dt> 217 216 <span class="sect1"> 218 <a href="#I-m-using-Slime-and-Cocoa--Why-doesn-t--standard-output--seem-to-work-">6.3. I'm using Slime and Cocoa. Why doesn't *standard-output* 219 seem to work? </a> 217 <a href="#Implementation-Decisions-and-Open-Questions">6.3. Implementation Decisions and Open Questions</a> 218 </span> 219 </dt> 220 <dt> 221 <span class="sect1"> 222 <a href="#Porting-Code-from-the-Old-Thread-Model">6.4. Porting Code from the Old Thread Model</a> 223 </span> 224 </dt> 225 <dt> 226 <span class="sect1"> 227 <a href="#Background-Terminal-Input">6.5. Background Terminal Input</a> 228 </span> 229 </dt> 230 <dt> 231 <span class="sect1"> 232 <a href="#The-Threads-which-CCL-Uses-for-Its-Own-Purposes">6.6. The Threads which Clozure CL Uses for Its Own Purposes</a> 233 </span> 234 </dt> 235 <dt> 236 <span class="sect1"> 237 <a href="#Threads-Dictionary">6.7. Threads Dictionary</a> 220 238 </span> 221 239 </dt> … … 224 242 <dt> 225 243 <span class="chapter"> 226 <a href="#Programming-with- Threads">7. Programming with Threads</a>244 <a href="#Programming-with-Sockets">7. Programming with Sockets</a> 227 245 </span> 228 246 </dt> … … 231 249 <dt> 232 250 <span class="sect1"> 233 <a href="# Threads-overview">7.1. ThreadsOverview</a>251 <a href="#Sockets-Overview">7.1. Overview</a> 234 252 </span> 235 253 </dt> 236 254 <dt> 237 255 <span class="sect1"> 238 <a href="#Intentionally--Missing-Functionality">7.2. (Intentionally) Missing Functionality</a> 239 </span> 240 </dt> 241 <dt> 242 <span class="sect1"> 243 <a href="#Implementation-Decisions-and-Open-Questions">7.3. Implementation Decisions and Open Questions</a> 244 </span> 245 </dt> 246 <dt> 247 <span class="sect1"> 248 <a href="#Porting-Code-from-the-Old-Thread-Model">7.4. Porting Code from the Old Thread Model</a> 249 </span> 250 </dt> 251 <dt> 252 <span class="sect1"> 253 <a href="#Background-Terminal-Input">7.5. Background Terminal Input</a> 254 </span> 255 </dt> 256 <dt> 257 <span class="sect1"> 258 <a href="#The-Threads-which-CCL-Uses-for-Its-Own-Purposes">7.6. The Threads which Clozure CL Uses for Its Own Purposes</a> 259 </span> 260 </dt> 261 <dt> 262 <span class="sect1"> 263 <a href="#Threads-Dictionary">7.7. Threads Dictionary</a> 256 <a href="#Sockets-Dictionary">7.2. Sockets Dictionary</a> 264 257 </span> 265 258 </dt> … … 268 261 <dt> 269 262 <span class="chapter"> 270 <a href="# Programming-with-Sockets">8. Programming with Sockets</a>263 <a href="#Running-Other-Programs-as-Subprocesses">8. Running Other Programs as Subprocesses</a> 271 264 </span> 272 265 </dt> … … 275 268 <dt> 276 269 <span class="sect1"> 277 <a href="#S ockets-Overview">8.1. Overview</a>270 <a href="#Subprocess-Overview">8.1. Overview</a> 278 271 </span> 279 272 </dt> 280 273 <dt> 281 274 <span class="sect1"> 282 <a href="#Sockets-Dictionary">8.2. Sockets Dictionary</a> 275 <a href="#Subprocess-Examples">8.2. Examples</a> 276 </span> 277 </dt> 278 <dt> 279 <span class="sect1"> 280 <a href="#Limitations-and-known-bugs">8.3. Limitations and known bugs</a> 281 </span> 282 </dt> 283 <dt> 284 <span class="sect1"> 285 <a href="#External-Program-Dictionary">8.4. External-Program Dictionary</a> 283 286 </span> 284 287 </dt> … … 287 290 <dt> 288 291 <span class="chapter"> 289 <a href="# Running-Other-Programs-as-Subprocesses">9. Running Other Programs as Subprocesses</a>292 <a href="#Streams">9. Streams</a> 290 293 </span> 291 294 </dt> … … 294 297 <dt> 295 298 <span class="sect1"> 296 <a href="# Subprocess-Overview">9.1. Overview</a>299 <a href="#CCL-Stream-Extensions">9.1. Stream Extensions</a> 297 300 </span> 298 301 </dt> 299 302 <dt> 300 303 <span class="sect1"> 301 <a href="#Subprocess-Examples">9.2. Examples</a> 302 </span> 303 </dt> 304 <dt> 305 <span class="sect1"> 306 <a href="#Limitations-and-known-bugs">9.3. Limitations and known bugs</a> 307 </span> 308 </dt> 309 <dt> 310 <span class="sect1"> 311 <a href="#External-Program-Dictionary">9.4. External-Program Dictionary</a> 304 <a href="#Creating-Your-Own-Stream-Classes-with-Gray-Streams">9.2. Creating Your Own Stream Classes with Gray Streams</a> 312 305 </span> 313 306 </dt> … … 316 309 <dt> 317 310 <span class="chapter"> 318 <a href="# Streams">10. Streams</a>311 <a href="#Writing-Portable-Extensions-to-the-Object-System-using-the-MetaObject-Protocol">10. Writing Portable Extensions to the Object System using the MetaObject Protocol</a> 319 312 </span> 320 313 </dt> … … 323 316 <dt> 324 317 <span class="sect1"> 325 <a href="# CCL-Stream-Extensions">10.1. Stream Extensions</a>318 <a href="#MOP-Overview">10.1. Overview</a> 326 319 </span> 327 320 </dt> 328 321 <dt> 329 322 <span class="sect1"> 330 <a href="#Creating-Your-Own-Stream-Classes-with-Gray-Streams">10.2. Creating Your Own Stream Classes with Gray Streams</a> 323 <a href="#MOP-Implementation-status">10.2. Implementation status</a> 324 </span> 325 </dt> 326 <dt> 327 <span class="sect1"> 328 <a href="#Concurrency-issues">10.3. Concurrency issues</a> 331 329 </span> 332 330 </dt> … … 335 333 <dt> 336 334 <span class="chapter"> 337 <a href="# Writing-Portable-Extensions-to-the-Object-System-using-the-MetaObject-Protocol">11. Writing Portable Extensions to the Object System using the MetaObject Protocol</a>335 <a href="#Profiling">11. Profiling</a> 338 336 </span> 339 337 </dt> … … 342 340 <dt> 343 341 <span class="sect1"> 344 <a href="# MOP-Overview">11.1. Overview</a>342 <a href="#Profiling-Using the Linux oprofile system-level profiler">11.1. Using the Linux oprofile system-level profiler</a> 345 343 </span> 346 344 </dt> 347 345 <dt> 348 346 <span class="sect1"> 349 <a href="#MOP-Implementation-status">11.2. Implementation status</a> 350 </span> 351 </dt> 352 <dt> 353 <span class="sect1"> 354 <a href="#Concurrency-issues">11.3. Concurrency issues</a> 347 <a href="#Profiling-Using-Apples-CHUD-metering-tools">11.2. Using Apple's CHUD metering tools</a> 355 348 </span> 356 349 </dt> … … 421 414 <dt> 422 415 <span class="sect1"> 423 <a href="#id 430545">12.12. The Foreign-Function-Interface Dictionary</a>416 <a href="#id602931">12.12. The Foreign-Function-Interface Dictionary</a> 424 417 </span> 425 418 </dt> … … 632 625 </dd> 633 626 <dt> 627 <span class="chapter"> 628 <a href="#Questions-and-Answers">18. Questions and Answers</a> 629 </span> 630 </dt> 631 <dd> 632 <dl> 633 <dt> 634 <span class="sect1"> 635 <a href="#How-can-I-do-nonblocking--aka--unbuffered--and--raw---IO-">18.1. How can I do nonblocking (aka "unbuffered" and "raw") IO?</a> 636 </span> 637 </dt> 638 <dt> 639 <span class="sect1"> 640 <a href="#I-m-using-the-graphics-demos--Why-doesn-t-the-menubar-change-">18.2. I'm using the graphics demos. Why doesn't the menubar 641 change?</a> 642 </span> 643 </dt> 644 <dt> 645 <span class="sect1"> 646 <a href="#I-m-using-Slime-and-Cocoa--Why-doesn-t--standard-output--seem-to-work-">18.3. I'm using Slime and Cocoa. Why doesn't *standard-output* 647 seem to work? </a> 648 </span> 649 </dt> 650 </dl> 651 </dd> 652 <dt> 634 653 <span class="glossary"> 635 654 <a href="#glossary">Glossary of Terms</a> … … 656 675 <div> 657 676 <div> 658 <h2 class="title"><a id="id 322476"></a>Chapter 1. About Clozure CL</h2>677 <h2 class="title"><a id="id491128"></a>Chapter 1. About Clozure CL</h2> 659 678 </div> 660 679 </div> … … 664 683 <dt> 665 684 <span class="sect1"> 666 <a href="#id 378260">1.1. Introduction to Clozure CL</a>685 <a href="#id547615">1.1. Introduction to Clozure CL</a> 667 686 </span> 668 687 </dt> … … 673 692 <div> 674 693 <div> 675 <h2 class="title" style="clear: both"><a id="id 378260"></a>1.1. Introduction to Clozure CL</h2>694 <h2 class="title" style="clear: both"><a id="id547615"></a>1.1. Introduction to Clozure CL</h2> 676 695 </div> 677 696 </div> … … 746 765 </li> 747 766 <li> 748 <p>An IDE on theMac OS X, fully integrated with767 <p>An IDE on Mac OS X, fully integrated with 749 768 the Macintosh window system and User Interface 750 769 standards.</p> … … 761 780 <li> 762 781 <p>Many extensions including: files mapped to 763 Common Lisp vectors for fast file I/O; thread local hash tables782 Common Lisp vectors for fast file I/O; thread-local hash tables 764 783 and streams to eliminate locking overhead; cons hashing support; 765 784 and much more</p> … … 782 801 <div> 783 802 <div> 784 <h2 class="title"><a id="id 335115"></a>Chapter 2. Obtaining, Installing, and Running Clozure CL</h2>803 <h2 class="title"><a id="id503984"></a>Chapter 2. Obtaining, Installing, and Running Clozure CL</h2> 785 804 </div> 786 805 </div> … … 790 809 <dt> 791 810 <span class="sect1"> 792 <a href="#id 360672">2.1. Releases and System Requirements</a>811 <a href="#id540208">2.1. Releases and System Requirements</a> 793 812 </span> 794 813 </dt> … … 797 816 <dt> 798 817 <span class="sect2"> 799 <a href="#id 369379">2.1.1. LinuxPPC</a>818 <a href="#id525742">2.1.1. LinuxPPC</a> 800 819 </span> 801 820 </dt> 802 821 <dt> 803 822 <span class="sect2"> 804 <a href="#id 349897">2.1.2. Linux X8664</a>823 <a href="#id535678">2.1.2. Linux X8664</a> 805 824 </span> 806 825 </dt> 807 826 <dt> 808 827 <span class="sect2"> 809 <a href="#id 347997">2.1.3. FreeBSD-amd64</a>828 <a href="#id543148">2.1.3. FreeBSD-amd64</a> 810 829 </span> 811 830 </dt> 812 831 <dt> 813 832 <span class="sect2"> 814 <a href="#id 366253">2.1.4. DarwinPPC-MacOS-X</a>833 <a href="#id471818">2.1.4. DarwinPPC-MacOS-X</a> 815 834 </span> 816 835 </dt> 817 836 <dt> 818 837 <span class="sect2"> 819 <a href="#id 364292">2.1.5. Darwinx8664-MacOS-X</a>838 <a href="#id538393">2.1.5. Darwinx8664-MacOS-X</a> 820 839 </span> 821 840 </dt> … … 824 843 <dt> 825 844 <span class="sect1"> 826 <a href="#id 364310">2.2. Obtaining Clozure CL</a>845 <a href="#id538413">2.2. Obtaining Clozure CL</a> 827 846 </span> 828 847 </dt> … … 831 850 <dt> 832 851 <span class="sect2"> 833 <a href="#id 364330">2.2.1. The Mac Way</a>852 <a href="#id538435">2.2.1. The Mac Way</a> 834 853 </span> 835 854 </dt> 836 855 <dt> 837 856 <span class="sect2"> 838 <a href="#id 397955">2.2.2. Getting Clozure CL with Subversion</a>857 <a href="#id473036">2.2.2. Getting Clozure CL with Subversion</a> 839 858 </span> 840 859 </dt> 841 860 <dt> 842 861 <span class="sect2"> 843 <a href="#id 308156">2.2.3. Tarballs</a>862 <a href="#id548167">2.2.3. Tarballs</a> 844 863 </span> 845 864 </dt> … … 848 867 <dt> 849 868 <span class="sect1"> 850 <a href="#id 308181">2.3. Command Line Set Up</a>869 <a href="#id548194">2.3. Command Line Set Up</a> 851 870 </span> 852 871 </dt> … … 894 913 <dt> 895 914 <span class="sect2"> 896 <a href="#id 371816">2.6.3. Installing SLIME</a>915 <a href="#id529312">2.6.3. Installing SLIME</a> 897 916 </span> 898 917 </dt> … … 930 949 <div> 931 950 <div> 932 <h2 class="title" style="clear: both"><a id="id 360672"></a>2.1. Releases and System Requirements</h2>951 <h2 class="title" style="clear: both"><a id="id540208"></a>2.1. Releases and System Requirements</h2> 933 952 </div> 934 953 </div> … … 967 986 following subsections.</p> 968 987 <p xmlns="http://www.w3.org/1999/xhtml">Older versions are still available for downloading as 969 tarballs. Version 1.0 was a stable releasereleased in late 2005.988 tarballs. Version 1.0 was a stable version released in late 2005. 970 989 Version 1.1 was under active development until late 2007. A final 971 990 1.1 release was never made. It was distributed as a series of 972 991 development "snapshots" and CVS updates. 1.1 snapshots introduced 973 992 support for x86-64 platforms, internal use of Unicode, and many 974 other features, but were a moving target. </p>993 other features, but were moving targets. </p> 975 994 <div class="sect2" lang="en" xml:lang="en"> 976 995 <div xmlns="http://www.w3.org/1999/xhtml" class="titlepage"> 977 996 <div> 978 997 <div> 979 <h3 class="title"><a id="id 369379"></a>2.1.1. LinuxPPC</h3>998 <h3 class="title"><a id="id525742"></a>2.1.1. LinuxPPC</h3> 980 999 </div> 981 1000 </div> … … 989 1008 <div> 990 1009 <div> 991 <h3 class="title"><a id="id 349897"></a>2.1.2. Linux X8664</h3>1010 <h3 class="title"><a id="id535678"></a>2.1.2. Linux X8664</h3> 992 1011 </div> 993 1012 </div> … … 1002 1021 Linux have been known to have problems compiling some of the C 1003 1022 code in the kernel; some very old Linux distributions don't 1004 follow the current ABI standards w rt segment register usage;1005 some early Linux kernels for x86-64 had problems mapping large1006 regions of the address space; and so on. It's difficult to1007 enumerate exactly what versions of wh atLinux distributions have1023 follow the current ABI standards with regard to segment register 1024 usage; some early Linux kernels for x86-64 had problems mapping 1025 large regions of the address space; and so on. It's difficult to 1026 enumerate exactly what versions of which Linux distributions have 1008 1027 what problems. A rule of thumb is thatâbecause much of 1009 1028 the development of Clozure CL for x86-64 took place in that time … … 1015 1034 <div> 1016 1035 <div> 1017 <h3 class="title"><a id="id 347997"></a>2.1.3. FreeBSD-amd64</h3>1036 <h3 class="title"><a id="id543148"></a>2.1.3. FreeBSD-amd64</h3> 1018 1037 </div> 1019 1038 </div> … … 1030 1049 <div> 1031 1050 <div> 1032 <h3 class="title"><a id="id 366253"></a>2.1.4. DarwinPPC-MacOS-X</h3>1051 <h3 class="title"><a id="id471818"></a>2.1.4. DarwinPPC-MacOS-X</h3> 1033 1052 </div> 1034 1053 </div> … … 1050 1069 <div> 1051 1070 <div> 1052 <h3 class="title"><a id="id 364292"></a>2.1.5. Darwinx8664-MacOS-X</h3>1071 <h3 class="title"><a id="id538393"></a>2.1.5. Darwinx8664-MacOS-X</h3> 1053 1072 </div> 1054 1073 </div> … … 1069 1088 <div> 1070 1089 <div> 1071 <h2 class="title" style="clear: both"><a id="id 364310"></a>2.2. Obtaining Clozure CL</h2>1090 <h2 class="title" style="clear: both"><a id="id538413"></a>2.2. Obtaining Clozure CL</h2> 1072 1091 </div> 1073 1092 </div> … … 1092 1111 <div> 1093 1112 <div> 1094 <h3 class="title"><a id="id 364330"></a>2.2.1. The Mac Way</h3>1113 <h3 class="title"><a id="id538435"></a>2.2.1. The Mac Way</h3> 1095 1114 </div> 1096 1115 </div> … … 1120 1139 <div> 1121 1140 <div> 1122 <h3 class="title"><a id="id 397955"></a>2.2.2. Getting Clozure CL with Subversion</h3>1141 <h3 class="title"><a id="id473036"></a>2.2.2. Getting Clozure CL with Subversion</h3> 1123 1142 </div> 1124 1143 </div> … … 1129 1148 the Mac Way. Subversion is a source code control system that is 1130 1149 in wide usage. Most modern OSes come with subversion 1131 pre-installed. A complete, buildable and runnable set of Clozure 1132 CLsources and binaries can be retrieved by doing one subversion1150 pre-installed. A complete, buildable and runnable set of Clozure CL 1151 sources and binaries can be retrieved by doing one subversion 1133 1152 checkout.</p> 1134 <p xmlns="http://www.w3.org/1999/xhtml">One subversion command will createa1153 <p xmlns="http://www.w3.org/1999/xhtml">One subversion command creates a 1135 1154 <code class="literal">ccl</code> directory with runnable binaries, and a 1136 1155 complete set of buildable sources. To get the bleeding edge … … 1143 1162 <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting"> 1144 1163 1145 svn co http://svn.clozure.com/publicsvn/openmcl/release s/1.2/darwinx8664/ccl1164 svn co http://svn.clozure.com/publicsvn/openmcl/release/1.2/darwinx8664/ccl 1146 1165 </pre> 1147 1166 <p xmlns="http://www.w3.org/1999/xhtml">These examples fetch the complete sources and binaries … … 1181 1200 Welcome to Clozure Common Lisp Version 1.2 (DarwinX8664)! 1182 1201 ? (rebuild-ccl :full t) 1202 1183 1203 <lots of compilation output> 1204 1184 1205 ? (quit) 1185 1206 joe:ccl> … … 1202 1223 </pre> 1203 1224 <p xmlns="http://www.w3.org/1999/xhtml"> 1204 If Subversion is installed, it will saysomething like:1225 If Subversion is installed, you will see something like: 1205 1226 </p> 1206 1227 <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting"> … … 1209 1230 </pre> 1210 1231 <p xmlns="http://www.w3.org/1999/xhtml"> 1211 If Subversion is not installed, it will saysomething1232 If Subversion is not installed, you will see something 1212 1233 like: 1213 1234 </p> … … 1228 1249 <div> 1229 1250 <div> 1230 <h3 class="title"><a id="id 308156"></a>2.2.3. Tarballs</h3>1251 <h3 class="title"><a id="id548167"></a>2.2.3. Tarballs</h3> 1231 1252 </div> 1232 1253 </div> … … 1243 1264 <div> 1244 1265 <div> 1245 <h2 class="title" style="clear: both"><a id="id 308181"></a>2.3. Command Line Set Up</h2>1266 <h2 class="title" style="clear: both"><a id="id548194"></a>2.3. Command Line Set Up</h2> 1246 1267 </div> 1247 1268 </div> 1248 1269 </div> 1249 1270 <p xmlns="http://www.w3.org/1999/xhtml">Sometimes it's convenient to use Clozure CL from a Unix 1250 shell command line. This is especially true when using Clozure 1251 CLas a way to run Common Lisp utilities.</p>1271 shell command line. This is especially true when using Clozure CL 1272 as a way to run Common Lisp utilities.</p> 1252 1273 <div class="sect2" lang="en" xml:lang="en"> 1253 1274 <div xmlns="http://www.w3.org/1999/xhtml" class="titlepage"> … … 1291 1312 <code class="literal">~/bin</code>. It is better to do this than to 1292 1313 add <code class="literal">ccl/scripts</code> to your 1293 <em class="varname">PATH</em> since the script needs to be edited, 1294 it will show up as modified to Subversion.</p> 1314 <em class="varname">PATH</em>, because the script needs to be edited, 1315 and editing it in-place means that Subversion sees the script as 1316 modified..</p> 1295 1317 </li> 1296 1318 <li> … … 1346 1368 you use to whatever you want. For example, if you are on a 1347 1369 64-bit system, and you only use Clozure CL in 64-bit mode, then 1348 you can rename <code class="literal">ccl64</code> to1370 you can rename <code class="literal">ccl64</code> to 1349 1371 <code class="literal">ccl</code> so that you only need to type 1350 1372 "<code class="literal">ccl</code>" to run it.</p> … … 1398 1420 </div> 1399 1421 <p xmlns="http://www.w3.org/1999/xhtml">By default Clozure CL tries to load the file 1400 <code class="literal">"home: openmcl-init.lisp"</code> or the compiled1422 <code class="literal">"home:ccl-init.lisp"</code> or the compiled 1401 1423 1402 <code class="literal">"home:openmcl-init.fasl"</code> upon starting up. It 1403 does this by executing <code class="literal">(load 1404 "home:openmcl-init")</code>. If it's unable to load the file 1424 <code class="literal">"home:ccl-init.fasl"</code> upon starting up. For 1425 the sake of backward compatibility, it also tries to load the 1426 file <code class="literal">"home:openmcl-init.lisp"</code>, or its compiled 1427 equivalent. Clozure CL does this by executing <code class="literal">(load 1428 "home:ccl-init")</code>. If it's unable to load the file 1405 1429 (for example because the file doesn't exist), Clozure CL doesn't 1406 1430 signal an error or warning, it just completes its startup … … 1410 1434 your home directory. Clozure CL therefore looks for either of the 1411 1435 files 1412 <code class="literal">~/ openmcl-init.lisp</code> or1413 <code class="literal">~/ openmcl-init.fasl</code>.</p>1436 <code class="literal">~/ccl-init.lisp</code> or 1437 <code class="literal">~/ccl-init.fasl</code>.</p> 1414 1438 <p xmlns="http://www.w3.org/1999/xhtml">Because the init file is loaded the same way as normal Lisp 1415 1439 code is, you can put anything you want in it. For example, you … … 1427 1451 </div> 1428 1452 </div> 1429 <p xmlns="http://www.w3.org/1999/xhtml">When using Clozure CL from the command line, the se1453 <p xmlns="http://www.w3.org/1999/xhtml">When using Clozure CL from the command line, the following 1430 1454 options may be used to modify its behavior. The exact set of 1431 1455 Clozure CL command-line arguments may vary per platform and … … 1445 1469 <p><code class="literal">-V</code> (or 1446 1470 <code class="literal">--version</code>). Prints the version of 1447 Clozure CL then exits. Th is is the same thing that is1448 returned by1449 <span class="function"><strong>LISP- APPLICATION-VERSION</strong></span>.</p>1471 Clozure CL then exits. The version string is the same value 1472 that is returned by 1473 <span class="function"><strong>LISP-IMPLEMENTATION-VERSION</strong></span>.</p> 1450 1474 </li> 1451 1475 <li> … … 1468 1492 </pre> 1469 1493 <p> 1470 will havethe effect of making the standard CL streams use1494 has the effect of making the standard CL streams use 1471 1495 <code class="literal">:UTF-8</code> as their character 1472 1496 encoding.</p> … … 1474 1498 <li> 1475 1499 <p><code class="literal">-n</code> (or 1476 <code class="literal">--no-init</code>). If this option is given, 1477 the init file is not loaded. This is useful if Clozure CL is 1478 being invoked by a shell script which should not be 1479 affected by whatever customizations a user might have in 1480 place.</p> 1500 <code class="literal">--no-init</code>). If this option is given, the 1501 init file is not loaded. This is useful if Clozure CL is being 1502 invoked by a shell script that should not be affected by 1503 whatever customizations a user might have in place.</p> 1481 1504 </li> 1482 1505 <li> … … 1516 1539 <p><code class="literal">-S</code> <em class="parameter"><code>n</code></em> (or 1517 1540 <code class="literal">--stack-size</code> <em class="parameter"><code>n</code></em>). Sets the size of the 1518 initial control stack to <em class="parameter"><code>n</code></em>. (see <a class="xref" href="#Thread-Stack-Sizes" title=" 7.3.1. Thread Stack Sizes">Section 7.3.1, âThread Stack Sizesâ</a>)</p>1541 initial control stack to <em class="parameter"><code>n</code></em>. (see <a class="xref" href="#Thread-Stack-Sizes" title="6.3.1. Thread Stack Sizes">Section 6.3.1, âThread Stack Sizesâ</a>)</p> 1519 1542 </li> 1520 1543 <li> … … 1522 1545 <code class="literal">--thread-stack-size</code> 1523 1546 <em class="parameter"><code>n</code></em>). Sets the size of the first 1524 thread's stack to <em class="parameter"><code>n</code></em>. (see <a class="xref" href="#Thread-Stack-Sizes" title=" 7.3.1. Thread Stack Sizes">Section 7.3.1, âThread Stack Sizesâ</a>)</p>1547 thread's stack to <em class="parameter"><code>n</code></em>. (see <a class="xref" href="#Thread-Stack-Sizes" title="6.3.1. Thread Stack Sizes">Section 6.3.1, âThread Stack Sizesâ</a>)</p> 1525 1548 </li> 1526 1549 <li> 1527 1550 <p><code class="literal">-b</code> (or <code class="literal">--batch</code>). Execute in "batch mode". End-of-file 1528 from <em class="varname">*STANDARD-INPUT*</em> will cause Clozure CL to exit, as willattempts to1551 from <em class="varname">*STANDARD-INPUT*</em> causes Clozure CL to exit, as do attempts to 1529 1552 enter a break loop.</p> 1530 1553 </li> … … 1613 1636 <p>You have a working installation of GNU Emacs. If you 1614 1637 don't have a working copy of GNU Emacs, see the web page on 1615 obtaining Emacs. If you prefer to use XEmacs instead of 1616 GNU Emacs,these instructions should still work; SLIME 1617 supports XEmacs Version21. Mac OS X includes an Emacs 1618 installation. If you want to look into different versions, 1619 you can check out theEmacsWiki, which maintains a 1620 page,EmacsForMacOS,that provides much more information 1638 <a class="ulink" href="http://www.gnu.org/software/emacs/#Obtaining" target="_top">obtaining 1639 Emacs</a>. If you prefer to use XEmacs instead of GNU 1640 Emacs, these instructions should still work; SLIME supports 1641 XEmacs Version21. Mac OS X includes an Emacs installation. 1642 If you want to look into different versions, you can check 1643 out theEmacsWiki, which maintains a 1644 page, EmacsForMacOS, that provides much more information 1621 1645 about using Emacs on the Mac.</p> 1622 1646 <p>A popular version of Emacs among Mac users is 1623 Aquamacs. This application is a version of GNU Emacs1624 with a number of customizations meant to make it behave1625 more like a standard Macintosh application, with1626 windows, a menubar, etc. Aquamacs includes SLIME; if1627 you like Aquamacs then you can use SLIME right away,1628 without getting and installing it separate
