Index: /trunk/source/doc/ccl-documentation.html =================================================================== --- /trunk/source/doc/ccl-documentation.html (revision 13830) +++ /trunk/source/doc/ccl-documentation.html (revision 13831) @@ -6,5 +6,5 @@ Clozure CL Documentation - + @@ -14,5 +14,5 @@
-

Clozure CL Documentation

+

Clozure CL Documentation

@@ -132,50 +132,55 @@
- 4.3. Directory + 4.3. Advising
- 4.4. Unicode + 4.4. Directory
- 4.5. Pathnames + 4.5. Unicode
- 4.6. Memory-mapped Files + 4.6. Pathnames
- 4.7. Static Variables + 4.7. Memory-mapped Files
- 4.8. Saving Applications + 4.8. Static Variables
- 4.9. Concatenating FASL Files + 4.9. Saving Applications
- 4.10. Floating Point Numbers + 4.10. Concatenating FASL Files
- 4.11. Watched Objects + 4.11. Floating Point Numbers
- 4.12. Code Coverage + 4.12. Watched Objects + +
+
+ + 4.13. Code Coverage
@@ -1076,5 +1081,5 @@

So that Clozure CL can locate its source code, and for other reasons explained in - Section 4.5.2, “Predefined Logical Hosts”, you keep the + Section 4.6.2, “Predefined Logical Hosts”, you keep the Clozure CL application in the ccl directory. If you use a shell, @@ -1478,5 +1483,5 @@ character-encoding-name). Specifies the character encoding to use for - *TERMINAL-IO* (see Section 4.4.4, “Character Encodings”). Specifically, the + *TERMINAL-IO* (see Section 4.5.4, “Character Encodings”). Specifically, the character-encoding-name string is uppercased and interned in the KEYWORD package. If an @@ -1735,5 +1740,5 @@

The following terms are used in subsequent sections; it may be helpful to refer to these definitions.

-

fasl +

fasl files are the object files produced by compile-file. fasl files store the @@ -1746,5 +1751,5 @@ see Table 3.1, “Platform-specific filename conventions”

-

The Lisp +

The Lisp kernel is a C program with a fair amount of platform-specific assembly language code. Its basic job is to @@ -1756,5 +1761,5 @@ files on different platforms; see Table 3.1, “Platform-specific filename conventions”.

-

A heap +

A heap image is a file that can be quickly mapped into a process's address space. Conceptually, it's not too different @@ -1767,5 +1772,5 @@ standard full heap image files on different platforms; see Table 3.1, “Platform-specific filename conventions”.

-

A bootstrapping image is a minimal +

A bootstrapping image is a minimal heap image used in the process of building Clozure CL itself. The bootstrapping image contains just enough code to load the rest @@ -1779,5 +1784,5 @@ as-yet-unsupported ones) has a uniquely named subdirectory of ccl/lisp-kernel/; each such - + contains a Makefile and may contain some auxiliary files (linker scripts, etc.) that are used to build the lisp kernel on a @@ -2403,10 +2408,15 @@

- 4.3. Directory + 4.3. Advising
- 4.4. Unicode + 4.4. Directory + +
+
+ + 4.5. Unicode
@@ -2415,20 +2425,20 @@
- 4.4.1. Characters + 4.5.1. Characters
- 4.4.2. External Formats + 4.5.2. External Formats
- 4.4.3. Line Termination Keywords + 4.5.3. Line Termination Keywords
- 4.4.4. Character Encodings + 4.5.4. Character Encodings
@@ -2437,5 +2447,5 @@
- 4.5. Pathnames + 4.6. Pathnames
@@ -2444,25 +2454,25 @@
- 4.5.1. Pathname Expansion + 4.6.1. Pathname Expansion
- 4.5.2. Predefined Logical Hosts + 4.6.2. Predefined Logical Hosts
- 4.5.3. OS X (Darwin) + 4.6.3. OS X (Darwin)
- 4.5.4. Linux + 4.6.4. Linux
- 4.5.5. FreeBSD + 4.6.5. FreeBSD
@@ -2471,30 +2481,30 @@
- 4.6. Memory-mapped Files + 4.7. Memory-mapped Files
- 4.7. Static Variables + 4.8. Static Variables
- 4.8. Saving Applications + 4.9. Saving Applications
- 4.9. Concatenating FASL Files + 4.10. Concatenating FASL Files
- 4.10. Floating Point Numbers + 4.11. Floating Point Numbers
- 4.11. Watched Objects + 4.12. Watched Objects
@@ -2503,25 +2513,25 @@
- 4.11.1. WATCH + 4.12.1. WATCH
- 4.11.2. UNWATCH + 4.12.2. UNWATCH
- 4.11.3. WRITE-TO-WATCHED-OBJECT + 4.12.3. WRITE-TO-WATCHED-OBJECT
- 4.11.4. Notes + 4.12.4. Notes
- 4.11.5. Examples + 4.12.5. Examples
@@ -2530,5 +2540,5 @@
- 4.12. Code Coverage + 4.13. Code Coverage
@@ -2537,15 +2547,15 @@
- 4.12.1. Overview + 4.13.1. Overview
- 4.12.2. Limitations + 4.13.2. Limitations
- 4.12.3. Usage + 4.13.3. Usage
@@ -2586,5 +2596,5 @@

- + TRACE {keyword global-value}* {spec | @@ -3030,15 +3040,15 @@

- + CCL:*TRACE-LEVEL* [Variable]

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.

- + CCL:*TRACE-MAX-INDENT* [Variable]

The default before and after print actions will not indent by more than the value of ccl:*trace-max-indent* regardless of the current trace level.

- + CCL:TRACE-FUNCTION spec &key {keyword value}* [Function]

@@ -3048,5 +3058,5 @@

- + CCL:*TRACE-PRINT-LEVEL* [Variable]

@@ -3056,5 +3066,5 @@ explicit printing done by user code.

- + CCL:*TRACE-PRINT-LENGTH* [Variable]

@@ -3064,5 +3074,5 @@ explicit printing done by user code.

- + CCL:*TRACE-BAR-FREQUENCY* [Variable]

@@ -3075,5 +3085,188 @@
-

4.3. Directory

+

4.3. Advising

+
+
+ +

+ The advise macro can be thought of as a more + general version of trace. It allows code that + you specify to run before, after, or around a given function, for + the purpose of changing the behavior of the function. Each piece + of added code is called a piece of advice. Each piece of advice + has a unique name, so that you can have multiple pieces of advice + on the same function, including multiple + :before, :after, and + :around pieces of advice. +

+

+ The :name and :when + keywords serve to identify the piece of advice. A later call to + advise with the same values of + :name and :when will replace + the existing piece of advice; a call with different values will not. +

+

+

+ + [Macro] +

+ advise spec form &key when name +
+
+ Add a piece of advice to the function or method specified by + spec according to + form. +
+

+

+

+
+ +
Arguments and Values:
+

spec--- + A specification of the function on which to put the + advice. This is either a symbol that is the name of a + function or generic function, or an expression of the + form (setf symbol), or a + specific method of a generic function in the form + (:method symbol {qualifiers} (specializer {specializer})). +

+

form--- + A form to execute before, after, or around the advised + function. The form can refer to the variable arglist + that is bound to the arguments with which the advised + function was called. You can exit from form with + (return). +

+

name--- + A name that identifies the piece of advice. +

+

when--- + An argument that specifies when the piece of advice is + run. There are three allowable values. The default is + :before, which specifies that form is + executed before the advised function is called. Other + possible values are :after, which + specifies that form is executed after the advised + function is called, and :around, + which specifies that form is executed around the call to + the advised function. Use (:do-it) + within form to indicate invocation of the original + definition. +

+
+
+ +
Examples:
+

+ The function foo, already defined, does + something with a list of numbers. The following code uses a + piece of advice to make foo return zero if any of its + arguments is not a number. Using :around advice, you can do + the following: +

+ 
+(advise foo (if (some #'(lambda (n) (not (numberp n))) arglist)
+	      0
+	      (:do-it))
+	:when :around :name :zero-if-not-nums)
+
+

+

+

+ To do the same thing using a :before piece of advice: +

+ 
+(advise foo (if (some #'(lambda (n) (not (numberp n))) arglist)
+	      (return 0))
+	:when :before :name :zero-if-not-nums)
+
+

+

+
+
+

+

+

+ + [Macro] +

+ unadvise spec &key when name +
+
+ Remove the piece or pieces of advice matching spec, + when, and name. +
+

+

+

+
+ +
Description:
+

+ The unadvise macro removes the piece or pieces of advice + matching spec, when, + and name. When the value of + spec is t and the values of when + and name are nil, unadvise + removes every piece of advice; when spec is + t, the argument when is nil, and + name is non-nil, unadvise removes all + pieces of advice with the given name. +

+
+
+ +
Arguments and Values:
+

+ The arguments have the same meaning as in + advise. +

+
+
+

+

+

+ + [Macro] +

+ advisedp spec &key when name +
+
+ Return a list of the pieces of advice matching spec, + when, and name. +
+

+

+

+
+ +
Description:
+

+ The advisedp macro returns a list of existing pieces of advice + that match spec, when, + and name. When the value of + spec is t and the values of + when and name are nil, + advisedp returns all existing pieces of advice. +

+
+
+ +
Arguments and Values:
+

+ The arguments have the same meaning as in + advise. +

+
+
+

+ +
+
+
+
+

4.4. Directory

@@ -3115,5 +3308,5 @@
-

4.4. Unicode

+

4.5. Unicode

@@ -3130,5 +3323,5 @@
-

4.4.1. Characters

+

4.5.1. Characters

@@ -3170,5 +3363,5 @@
-

4.4.2. External Formats

+

4.5.2. External Formats

@@ -3179,6 +3372,6 @@ of :EXTERNAL-FORMAT can be :DEFAULT (the default value), a line - termination keyword (see Section 4.4.3, “Line Termination Keywords”), a character encoding - keyword (see Section 4.4.4, “Character Encodings”), an + termination keyword (see Section 4.5.3, “Line Termination Keywords”), a character encoding + keyword (see Section 4.5.4, “Character Encodings”), an external-format object created using CCL::MAKE-EXTERNAL-FORMAT (see make-external-format), or a plist with keys: @@ -3228,5 +3421,5 @@
- +
Arguments and Values:

domain---This is used to indicate where the external @@ -3242,5 +3435,5 @@ line-termination.

character-encoding---A keyword that specifies the character encoding - for the external format. Section 4.4.4, “Character Encodings”. Defaults to + for the external format. Section 4.5.4, “Character Encodings”. Defaults to :DEFAULT which means if domain is @@ -3255,5 +3448,5 @@ :ISO-8859-1 encoding.

line-termination---A keyword that indicates a line termination - keyword Section 4.4.3, “Line Termination Keywords”. + keyword Section 4.5.3, “Line Termination Keywords”. Defaults to :DEFAULT which means use the value of the variable @@ -3262,5 +3455,5 @@

- +
Description:

Despite the function's name, it doesn't necessarily create a @@ -3277,5 +3470,5 @@

-

4.4.3. Line Termination Keywords

+

4.5.3. Line Termination Keywords

@@ -3401,5 +3594,5 @@
-

4.4.4. Character Encodings

+

4.5.4. Character Encodings

@@ -3411,5 +3604,5 @@ character encodings. Clozure CL implements some of these encodings as detailed below. These encodings are part of the specification of - external formats Section 4.4.2, “External Formats”. When reading + external formats Section 4.5.2, “External Formats”. When reading from a stream, characters are converted from the specified external character encoding to UTF-32. When writing to a stream, @@ -3430,5 +3623,5 @@
-

4.4.4.1. Encoding Problems

+

4.5.4.1. Encoding Problems

@@ -3446,5 +3639,5 @@
-

4.4.4.2. Byte Order Marks

+

4.5.4.2. Byte Order Marks

@@ -3474,5 +3667,5 @@
-

4.4.4.3. DESCRIBE-CHARACTER-ENCODINGS

+

4.5.4.3. DESCRIBE-CHARACTER-ENCODINGS

@@ -3496,5 +3689,5 @@ @@ -3516,5 +3709,5 @@
-

4.4.4.4. Supported Character Encodings

+

4.5.4.4. Supported Character Encodings

@@ -3936,5 +4129,5 @@
-

4.4.4.5. Encoding and Decoding Strings

+

4.5.4.5. Encoding and Decoding Strings

@@ -3961,5 +4154,5 @@
- +
Description:

@@ -3992,5 +4185,5 @@

- +
Description:

@@ -4035,5 +4228,5 @@

- +
Description:

@@ -4081,5 +4274,5 @@

- +
Description:

@@ -4103,5 +4296,5 @@

-

4.5. Pathnames

+

4.6. Pathnames

@@ -4111,5 +4304,5 @@
-

4.5.1. Pathname Expansion

+

4.6.1. Pathname Expansion

@@ -4126,10 +4319,10 @@
-

4.5.2. Predefined Logical Hosts

+

4.6.2. Predefined Logical Hosts

Clozure CL sets up logical pathname translations for logical hosts: ccl and home

- +

The CCL logical host should point to the ccl directory. It is used for a variety of @@ -4147,5 +4340,5 @@

-

4.5.3. OS X (Darwin)

+

4.6.3. OS X (Darwin)

@@ -4157,5 +4350,5 @@
-

4.5.4. Linux

+

4.6.4. Linux

@@ -4170,5 +4363,5 @@
-

4.5.5. FreeBSD

+

4.6.5. FreeBSD

@@ -4183,5 +4376,5 @@
-

4.6. Memory-mapped Files

+

4.7. Memory-mapped Files

@@ -4235,5 +4428,5 @@ platforms.

- + CCL:MAP-FILE-TO-IVECTOR pathname @@ -4295,5 +4488,5 @@ a memory error.

- + CCL:UNMAP-IVECTOR displaced-array @@ -4307,5 +4500,5 @@ target is an empty vector (of length zero).

- + CCL:MAP-FILE-TO-OCTET-VECTOR pathname @@ -4317,5 +4510,5 @@ bytes.

- + CCL:UNMAP-OCTET-VECTOR displaced-array @@ -4329,5 +4522,5 @@

-

4.7. Static Variables

+

4.8. Static Variables

@@ -4356,5 +4549,5 @@ static.

- + DEFSTATIC var @@ -4406,9 +4599,9 @@

-

4.8. Saving Applications

-
-
-
- +

4.9. Saving Applications

+
+
+
+

Clozure CL provides the function CCL:SAVE-APPLICATION, which creates a file @@ -4490,5 +4683,5 @@ converted, because address 0 can always be relied upon to refer to the same thing.

- +

As of Clozure CL 1.2, the constant CCL:+NULL-PTR+ refers to a MACPTR object that points to address 0.

@@ -4501,5 +4694,5 @@ or opencml64 script.

- + SAVE-APPLICATION filename @@ -4604,5 +4797,5 @@

-

4.9. Concatenating FASL Files

+

4.10. Concatenating FASL Files

@@ -4625,5 +4818,5 @@
- +
Arguments and Values:

out-file--- @@ -4639,5 +4832,5 @@

- +
Description:

@@ -4665,5 +4858,5 @@

-

4.10. Floating Point Numbers

+

4.11. Floating Point Numbers

@@ -4699,5 +4892,5 @@
- +
Arguments and Values:

mode--- @@ -4707,5 +4900,5 @@

- +
Description:

@@ -4746,5 +4939,5 @@

- +
Arguments and Values:

rounding-mode--- @@ -4755,5 +4948,5 @@

- +
Description:

@@ -4771,5 +4964,5 @@

-

4.11. Watched Objects

+

4.12. Watched Objects

@@ -4786,5 +4979,5 @@
-

4.11.1. WATCH

+

4.12.1. WATCH

@@ -4804,5 +4997,5 @@
- +
Arguments and Values:

object--- @@ -4811,5 +5004,5 @@

- +
Description:

@@ -4960,5 +5153,5 @@

-

4.11.2. UNWATCH

+

4.12.2. UNWATCH

@@ -4978,5 +5171,5 @@
- +
Description:

@@ -4994,5 +5187,5 @@

-

4.11.3. WRITE-TO-WATCHED-OBJECT

+

4.12.3. WRITE-TO-WATCHED-OBJECT

@@ -5012,5 +5205,5 @@
- +
Discussion:

@@ -5030,5 +5223,5 @@

- +
Restarts:

@@ -5053,5 +5246,5 @@

-

4.11.4. Notes

+

4.12.4. Notes

@@ -5086,5 +5279,5 @@
-

4.11.5. Examples

+

4.12.5. Examples

@@ -5098,5 +5291,5 @@
-

4.11.5.1. Fancy arrays

+

4.12.5.1. Fancy arrays

@@ -5125,5 +5318,5 @@
-

4.11.5.2. Hash tables

+

4.12.5.2. Hash tables

@@ -5173,5 +5366,5 @@
-

4.11.5.3. Lists

+

4.12.5.3. Lists

@@ -5202,5 +5395,5 @@
-

4.12. Code Coverage

+

4.13. Code Coverage

@@ -5210,5 +5403,5 @@
-

4.12.1. Overview

+

4.13.1. Overview

@@ -5246,5 +5439,5 @@
-

4.12.2. Limitations

+

4.13.2. Limitations

@@ -5299,5 +5492,5 @@
-

4.12.3. Usage

+

4.13.3. Usage

@@ -5342,5 +5535,5 @@
- +
Arguments and Values:

html--- @@ -5364,5 +5557,5 @@

- +
Example:

@@ -5398,5 +5591,5 @@

- +
Summary:

@@ -5420,5 +5613,5 @@

- +
Summary:

@@ -5446,5 +5639,5 @@

- +
Summary:

@@ -5472,5 +5665,5 @@

- +
Summary:

@@ -5503,5 +5696,5 @@

- +
Summary:

@@ -5530,5 +5723,5 @@

- +
Summary:

@@ -5553,5 +5746,5 @@

- +
Summary:

@@ -5580,5 +5773,5 @@

- +
Summary:

@@ -5607,5 +5800,5 @@

- +
Summary:

@@ -5774,5 +5967,5 @@

- +
Summary:

@@ -5799,5 +5992,5 @@

- +
Summary:

@@ -6030,5 +6223,5 @@

-

5.4.2.1. Checking for Updates

+

5.4.2.1. Checking for Updates

@@ -6162,5 +6355,5 @@ the required subsystems, if necessary.

- + BUILD-APPLICATION &key (name "MyApplication") @@ -6462,5 +6655,5 @@

- 6.3.2. As of August 2003: + 6.3.2. As of August 2003:
@@ -6713,5 +6906,5 @@
-

6.3.2.  As of August 2003:

+

6.3.2.  As of August 2003:

@@ -7165,5 +7358,5 @@
- +
Values:

result---a list of all lisp processes (threads) @@ -7171,5 +7364,5 @@

- +
Description:

Returns a list of all lisp processes (threads) known @@ -7183,5 +7376,5 @@

- +
See Also:
@@ -7211,5 +7404,5 @@
- +
Arguments and Values:

name---a string, used to identify the process.

@@ -7250,5 +7443,5 @@
- +
Description:

Creates and returns a new lisp process (thread) with the @@ -7271,5 +7464,5 @@

- +
See Also:
process-preset, process-enable, process-run-function @@ -7290,5 +7483,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -7300,5 +7493,5 @@
- +
Description:

Suspends process, preventing it from @@ -7322,10 +7515,10 @@

- +
See Also:
process-resume, process-suspend-count
- +
Notes:

process-suspend was previously called @@ -7353,5 +7546,5 @@

- +
Arguments and Values:

process---a lisp process (thread).

@@ -7364,5 +7557,5 @@
- +
Description:

Undoes the effect of a previous call to @@ -7375,10 +7568,10 @@

- +
See Also:
process-suspend, process-suspend-count
- +
Notes:

@@ -7406,5 +7599,5 @@

- +
Arguments and Values:

process---a lisp process (thread).

@@ -7416,5 +7609,5 @@
- +
Description:

An "outstanding" process-suspend call @@ -7431,5 +7624,5 @@

- +
See Also:
process-suspend, process-resume @@ -7452,5 +7645,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -7463,5 +7656,5 @@
- +
Description:

Typically used to initialize a newly-created or newly-reset @@ -7477,5 +7670,5 @@

- +
See Also:
make-process, process-enable, process-run-function @@ -7498,5 +7691,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -7507,5 +7700,5 @@
- +
Description:

Tries to begin the execution of process. @@ -7524,10 +7717,10 @@

- +
See Also:
make-process, process-preset, process-run-function
- +
Notes:

It would be nice to have more discussion of what it means @@ -7550,5 +7743,5 @@

- +
Arguments and Values:

name---a string, used to identify the process. @@ -7572,5 +7765,5 @@

- +
Description:

Creates a lisp process (thread) via @@ -7585,5 +7778,5 @@

- +
See Also:
make-process, process-preset, process-enable @@ -7606,5 +7799,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -7619,5 +7812,5 @@
- +
Description:

Arranges for process @@ -7650,5 +7843,5 @@

- +
See Also:
@@ -7659,5 +7852,5 @@
- +
Notes:

It would probably be better for result @@ -7689,10 +7882,10 @@

- +
Value Type:

A lisp process (thread).

- +
Initial Value:

Bound separately in each process, to that process itself. @@ -7700,5 +7893,5 @@

- +
Description:

Used when lisp code needs to find out what process it is @@ -7706,5 +7899,5 @@

- +
See Also:
@@ -7730,5 +7923,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -7737,5 +7930,5 @@
- +
Description:

Causes process to cleanly exit @@ -7764,5 +7957,5 @@

- +
See Also:
process-kill, process-abort @@ -7784,5 +7977,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -7790,5 +7983,5 @@
- +
Description:

Entirely equivalent to calling @@ -7797,5 +7990,5 @@

- +
See Also:
process-reset, process-abort @@ -7819,5 +8012,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -7825,5 +8018,5 @@
- +
Description:

Entirely equivalent to calling @@ -7839,5 +8032,5 @@

- +
See Also:
process-reset, process-kill @@ -7858,10 +8051,10 @@
- +
Value Type:

A positive integer.

- +
Initial Value:

The clock resolution of the OS scheduler. Currently, @@ -7870,5 +8063,5 @@

- +
Description:

This value is ordinarily of marginal interest at best, @@ -7878,5 +8071,5 @@

- +
See Also:
@@ -7902,5 +8095,5 @@
- +
Description:

This information is primarily for the benefit of @@ -7916,10 +8109,10 @@

- +
See Also:
process-wait, process-wait-with-timeout, with-terminal-input
- +
Notes:

This should arguably be SETFable, but doesn't seem to @@ -7945,5 +8138,5 @@

- +
Description:

Advises the OS scheduler that the current thread has nothing @@ -7954,10 +8147,10 @@

- +
See Also:
make-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input
- +
Notes:

This is a holdover from the days of cooperative @@ -7982,5 +8175,5 @@

- +
Arguments and Values:

whostate---a string, which will be the value of @@ -7995,5 +8188,5 @@

- +
Description:

Causes the current lisp process (thread) to repeatedly @@ -8012,5 +8205,5 @@

- +
See Also:
process-whostate, process-wait-with-timeout, make-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -8032,5 +8225,5 @@
- +
Arguments and Values:

whostate---a string, which will be the value of @@ -8050,5 +8243,5 @@

- +
Description:

If ticks is NIL, behaves exactly like @@ -8067,5 +8260,5 @@

- +
See Also:
*ticks-per-second*, process-whostate, process-wait, make-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -8087,5 +8280,5 @@
- +
Arguments and Values:

body---an implicit progn.

@@ -8094,5 +8287,5 @@
- +
Description:

Executes body @@ -8109,5 +8302,5 @@

- +
See Also:
@@ -8133,5 +8326,5 @@
- +
Arguments and Values:

name---any lisp object; saved as part of @@ -8143,5 +8336,5 @@

- +
Description:

Creates and returns a lock object, which can @@ -8153,5 +8346,5 @@

- +
See Also:
with-lock-grabbed, grab-lock, release-lock, try-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -8173,5 +8366,5 @@
- +
Arguments and Values:

lock---an object of type CCL:LOCK.

@@ -8181,5 +8374,5 @@
- +
Description:

Waits until lock is either free or @@ -8192,5 +8385,5 @@

- +
See Also:
make-lock, grab-lock, release-lock, try-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -8211,10 +8404,10 @@
- +
Arguments and Values:

lock---an object of type CCL:LOCK.

- +
Description:

Blocks until lock is owned by the @@ -8227,5 +8420,5 @@

- +
See Also:
make-lock, with-lock-grabbed, release-lock, try-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -8245,10 +8438,10 @@
- +
Arguments and Values:

lock---an object of type CCL:LOCK.

- +
Description:

Signals an error of type CCL:LOCK-NOT-OWNER if @@ -8263,5 +8456,5 @@

- +
See Also:
make-lock, with-lock-grabbed, grab-lock, try-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -8282,5 +8475,5 @@
- +
Arguments and Values:

lock---an object of type CCL:LOCK.

@@ -8289,5 +8482,5 @@
- +
Description:

Tests whether lock @@ -8302,5 +8495,5 @@

- +
See Also:
make-lock, with-lock-grabbed, grab-lock, release-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -8322,5 +8515,5 @@
- +
Arguments and Values:

read-write-lock---a newly-allocated object of type @@ -8328,5 +8521,5 @@

- +
Description:

Creates and returns an object of type CCL::READ-WRITE-LOCK. @@ -8339,10 +8532,10 @@

- +
See Also:
with-read-lock, with-write-lock, make-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input
- +
Notes:

There probably should be some way to @@ -8367,5 +8560,5 @@

- +
Arguments and Values:

read-write-lock---an object of type @@ -8376,5 +8569,5 @@

- +
Description:

Waits until read-write-lock has no @@ -8390,5 +8583,5 @@

- +
See Also:
make-read-write-lock, with-write-lock, make-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -8410,5 +8603,5 @@
- +
Arguments and Values:

read-write-lock---an object of type @@ -8419,5 +8612,5 @@

- +
Description:

Waits until read-write-lock has no @@ -8434,5 +8627,5 @@

- +
See Also:
make-read-write-lock, with-read-lock, make-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -8454,10 +8647,10 @@
- +
Arguments and Values:

semaphore---a newly-allocated object of type CCL:SEMAPHORE.

- +
Description:

Creates and returns an object of type CCL:SEMAPHORE. @@ -8468,5 +8661,5 @@

- +
See Also:
signal-semaphore, wait-on-semaphore, timed-wait-on-semaphore, make-lock, make-read-write-lock, process-input-wait, process-output-wait, with-terminal-input @@ -8488,5 +8681,5 @@
- +
Arguments and Values:

semaphore---an object of type CCL:SEMAPHORE.

@@ -8495,5 +8688,5 @@
- +
Description:

Atomically increments semaphore's @@ -8502,10 +8695,10 @@

- +
See Also:
make-semaphore, wait-on-semaphore, timed-wait-on-semaphore, make-lock, make-read-write-lock, process-input-wait, process-output-wait, with-terminal-input
- +
Notes:

result should probably be interpreted @@ -8530,5 +8723,5 @@

- +
Arguments and Values:

semaphore---an object of type CCL:SEMAPHORE.

@@ -8537,5 +8730,5 @@
- +
Description:

Waits until semaphore @@ -8545,10 +8738,10 @@

- +
See Also:
make-semaphore, signal-semaphore, timed-wait-on-semaphore, make-lock, make-read-write-lock, process-input-wait, process-output-wait, with-terminal-input
- +
Notes:

result should probably be interpreted @@ -8574,5 +8767,5 @@

- +
Arguments and Values:

semaphore---An object of type CCL:SEMAPHORE.

@@ -8587,5 +8780,5 @@
- +
Description:

Waits until semaphore @@ -8596,5 +8789,5 @@

- +
See Also:
make-semaphore, wait-on-semaphore, make-lock, make-read-write-lock, process-input-wait, process-output-wait, with-terminal-input @@ -8616,5 +8809,5 @@
- +
Arguments and Values:

fd---a file descriptor, which is a non-negative integer @@ -8624,5 +8817,5 @@

- +
Description:

Wait until input is available on fd. @@ -8640,10 +8833,10 @@

- +
See Also:
make-lock, make-read-write-lock, make-semaphore, process-output-wait, with-terminal-input
- +
Notes:

@@ -8670,5 +8863,5 @@

- +
Arguments and Values:

fd---a file descriptor, which is a non-negative integer @@ -8678,5 +8871,5 @@

- +
Description:

Wait until output is possible on fd or until timeout, if @@ -8691,10 +8884,10 @@

- +
See Also:
make-lock, make-read-write-lock, make-semaphore, process-input-wait, with-terminal-input
- +
Notes:

@@ -8721,5 +8914,5 @@

- +
Arguments and Values:

body---an implicit progn.

@@ -8728,5 +8921,5 @@
- +
Description:

Requests exclusive read access to the standard terminal @@ -8736,5 +8929,5 @@

- +
See Also:
*request-terminal-input-via-break*, :y, make-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait @@ -8755,15 +8948,15 @@
- +
Value Type:

A boolean.

- +
Initial Value:

NIL.

- +
Description:

Controls how attempts to obtain ownership of terminal input @@ -8777,5 +8970,5 @@

- +
See Also:
with-terminal-input, :y, make-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait @@ -8796,5 +8989,5 @@
- +
Arguments and Values:

p---a lisp process (thread), designated either by @@ -8805,5 +8998,5 @@

- +
Description:

:Y is a toplevel command, not a function. As such, it @@ -8816,5 +9009,5 @@

- +
See Also:
with-terminal-input, *request-terminal-input-via-break*, make-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait @@ -8837,5 +9030,5 @@
- +
Arguments and Values:

process---a process, typically created by process-run-function or by make-process

@@ -8847,5 +9040,5 @@
- +
Description:

Waits for the specified process to terminate. If the @@ -8988,5 +9181,5 @@

- +
Arguments and Values:

address-family---The address/protocol family of this socket. Currently @@ -9088,5 +9281,5 @@

- +
Description:

Creates and returns a new socket

@@ -9107,5 +9300,5 @@
- +
Arguments and Values:

socket---The listener-socket to listen on.

@@ -9115,5 +9308,5 @@
- +
Description:

Extracts the first connection on the queue of pending @@ -9141,5 +9334,5 @@

- +
Arguments and Values:

dotted---A string representing an IP address in the @@ -9149,5 +9342,5 @@

- +
Description:

Converts a dotted-string representation of a host address to @@ -9169,5 +9362,5 @@

- +
Arguments and Values:

ipaddr---A 32-bit integer representing an internet host address

@@ -9178,5 +9371,5 @@
- +
Description:

Converts a 32-bit unsigned IP address into octets.

@@ -9197,5 +9390,5 @@
- +
Arguments and Values:

ipaddr---a 32-bit integer representing an internet host address

@@ -9204,5 +9397,5 @@
- +
Description:

Converts a 32-bit unsigned IP address into a host name @@ -9224,5 +9417,5 @@

- +
Arguments and Values:

host---Specifies the host. It can be either a host name @@ -9232,5 +9425,5 @@

- +
Description:

Converts a host spec in any of the acceptable formats into a @@ -9252,5 +9445,5 @@

- +
Arguments and Values:

port---Specifies the port. It can be either a string, such as @@ -9261,5 +9454,5 @@

- +
Description:

Finds the port number for the specified port and protocol

@@ -9281,5 +9474,5 @@
- +
Arguments and Values:

socket---The socket to read from

@@ -9298,5 +9491,5 @@
- +
Description:

Reads a UDP packet from a socket. If no packets are @@ -9335,5 +9528,5 @@

- +
Arguments and Values:

socket---The socket to write to

@@ -9350,5 +9543,5 @@
- +
Description:

Send a UDP packet over a socket.

@@ -9369,5 +9562,5 @@
- +
Arguments and Values:

socket---The socket to shut down (typically a tcp-stream)

@@ -9376,5 +9569,5 @@
- +
Description:

Shuts down part of a bidirectional connection. This is @@ -9397,10 +9590,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the native OS's representation of the socket, or @@ -9427,10 +9620,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the 32-bit unsigned IP address of the remote host, @@ -9452,10 +9645,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the remote port number, or NIL if the socket is not @@ -9477,10 +9670,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

Returns 32-bit unsigned IP address of the local host.

@@ -9501,10 +9694,10 @@
- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the local port number

@@ -9525,10 +9718,10 @@
- +
Arguments and Values:

socket---The socket

- +
Description:

Returns :internet or :file, as appropriate.

@@ -9549,10 +9742,10 @@
- +
Arguments and Values:

socket---The socket

- +
Description:

Returns :active for tcp-stream, :passive for @@ -9574,10 +9767,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the socket format as specified by the :format @@ -9599,10 +9792,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

returns :stream for tcp-stream and listener-socket, and @@ -9623,10 +9816,10 @@

- +
Description:

The class of OS errors signaled by socket functions

- +
Superclasses:

simple-error

@@ -9647,10 +9840,10 @@
- +
Arguments and Values:

socket-error---the condition

- +
Description:

The OS error code of the error

@@ -9671,10 +9864,10 @@
- +
Arguments and Values:

socket-error---the condition

- +
Description:

A symbol representing the error code in a more @@ -9700,10 +9893,10 @@

- +
Arguments and Values:

socket-error---the condition

- +
Description:

A string describing the context where the error happened. On @@ -9726,5 +9919,5 @@

- +
Arguments and Values:

socket---The socket to close

@@ -9737,5 +9930,5 @@
- +
Description:

The close generic function can be applied to sockets. It @@ -9758,5 +9951,5 @@

- +
Arguments and Values:

var---variable to bind

@@ -9765,5 +9958,5 @@
- +
Description:

executes body with var bound to the result of applying @@ -9897,5 +10090,5 @@

- +
Arguments and Values:

program---A string or pathname which denotes an executable file. @@ -9942,5 +10135,5 @@ EXTERNAL-PROCESS.

external-format--- - The external format (see Section 4.4.2, “External Formats”) for all of the + The external format (see Section 4.5.2, “External Formats”) for all of the streams (input, output, and error) used to communicate with the external process. @@ -9948,5 +10141,5 @@

- +
Description:

Runs the specified program in an external (Unix) process, @@ -9968,5 +10161,5 @@

- +
Arguments and Values:

proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.

@@ -9974,5 +10167,5 @@
- +
Description:

Sends the specified "signal" to the specified @@ -9997,10 +10190,10 @@

- +
Arguments and Values:

proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.

- +
Description:

Returns the process id assigned to @@ -10024,10 +10217,10 @@

- +
Arguments and Values:

proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.

- +
Description:

Returns the stream created when the input argument to @@ -10050,10 +10243,10 @@

- +
Arguments and Values:

proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.

- +
Description:

Returns the stream created when the output argument to @@ -10077,10 +10270,10 @@

- +
Arguments and Values:

proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.

- +
Description:

Returns the stream created when the error argument to @@ -10104,10 +10297,10 @@

- +
Arguments and Values:

proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.

- +
Description:

Returns, as multiple values, a keyword denoting the status @@ -10139,5 +10332,5 @@

- 9.1.1. Stream External Encoding + 9.1.1. Stream External Encoding
@@ -10207,5 +10400,5 @@
-

9.1.1. Stream External Encoding

+

9.1.1. Stream External Encoding

@@ -10368,10 +10561,10 @@
- - - - - - + + + + + +

A stream that is associated with a file descriptor has attributes and accessors: @@ -10426,5 +10619,5 @@

- +
Values:

stream-list---A list of open file streams. This is a copy of @@ -10433,10 +10626,10 @@

- +
Description:

Returns a list of open file streams.

- +
See Also:
note-open-file-stream, remove-open-file-stream @@ -10461,10 +10654,10 @@
- +
Arguments:

file-stream---A file stream.

- +
Description:

Adds a file stream to the internal list of open @@ -10475,5 +10668,5 @@

- +
See Also:
open-file-streams, remove-open-file-stream @@ -10498,10 +10691,10 @@
- +
Arguments:

file-stream---A file stream.

- +
Description:

Remove file stream from the internal list of open file @@ -10512,5 +10705,5 @@

- +
See Also:
open-file-streams, note-open-file-stream @@ -10945,5 +11138,5 @@
- +
Arguments and Values:

stream---a stream, presumably a fundamental-input-stream.

@@ -10956,5 +11149,5 @@
- +
Description:

Should try to read up to count elements from stream into the @@ -10977,5 +11170,5 @@

- +
Arguments and Values:

stream---a stream, presumably a fundamental-output-stream.

@@ -10988,5 +11181,5 @@
- +
Description:

should try to write the first count elements of list to @@ -11008,5 +11201,5 @@

- +
Arguments and Values:

stream---a stream, presumably a fundamental-input-stream

@@ -11024,5 +11217,5 @@
- +
Description:

should try to read successive elements from stream into @@ -11047,5 +11240,5 @@

- +
Arguments and Values:

stream---a stream, presumably a fundamental-output-stream

@@ -11063,5 +11256,5 @@
- +
Description:

should try to write successive elements of vector to stream, @@ -11085,5 +11278,5 @@

- +
Method Signatures:
ccl::stream-device @@ -11091,5 +11284,5 @@
- +
Arguments and Values:

s---a stream.

@@ -11102,5 +11295,5 @@
- +
Description:

Returns the file descriptor associated with @@ -11126,5 +11319,5 @@

- +
Description:

Reads up to max-octets octets from stream into ivector, @@ -11133,5 +11326,5 @@

- +
Arguments:

stream---An input stream. The method defined on @@ -11158,5 +11351,5 @@

- +
Description:

Writes max-octets octets to stream from ivector, starting at @@ -11164,5 +11357,5 @@

- +
Arguments:

stream---An input stream. The method defined on @@ -11174,5 +11367,5 @@

- +
Examples:
@@ -12340,5 +12533,5 @@

- + CHUD:*SHARK-CONFIG-FILE* [Variable]

@@ -12346,5 +12539,5 @@ configuration file created by the "Config Editor" in Shark.app.

- + CHUD:METER form &key (reset nil) (debug-output nil) [Macro]

@@ -13436,5 +13629,5 @@
-

12.3.2.4. %int-to-ptr [Function]

+

12.3.2.4. %int-to-ptr [Function]

@@ -13477,5 +13670,5 @@
-

12.3.2.5. %inc-ptr [Function]

+

12.3.2.5. %inc-ptr [Function]

@@ -13527,5 +13720,5 @@
-

12.3.2.6. %ptr-to-int [Function]

+

12.3.2.6. %ptr-to-int [Function]

@@ -13569,5 +13762,5 @@
-

12.3.2.7. %null-ptr [Macro]

+

12.3.2.7. %null-ptr [Macro]

@@ -13594,5 +13787,5 @@
-

12.3.2.8. %null-ptr-p [Function]

+

12.3.2.8. %null-ptr-p [Function]

@@ -13636,5 +13829,5 @@
-

12.3.2.9. %setf-macptr [Function]

+

12.3.2.9. %setf-macptr [Function]

@@ -13684,5 +13877,5 @@
-

12.3.2.10. %incf-ptr [Macro]

+

12.3.2.10. %incf-ptr [Macro]

@@ -13732,5 +13925,5 @@
-

12.3.2.11. with-macptrs [Macro]

+

12.3.2.11. with-macptrs [Macro]

@@ -13782,5 +13975,5 @@
-

12.3.2.12. %stack-block [Macro]

+

12.3.2.12. %stack-block [Macro]

@@ -13833,5 +14026,5 @@
-

12.3.2.13. make-cstring [Function]

+

12.3.2.13. make-cstring [Function]

@@ -13876,5 +14069,5 @@
-

12.3.2.14. with-cstrs [Macro]

+

12.3.2.14. with-cstrs [Macro]

@@ -13926,5 +14119,5 @@
-

12.3.2.15. with-encoded-cstrs [Macro]

+

12.3.2.15. with-encoded-cstrs [Macro]

@@ -13989,5 +14182,5 @@
-

12.3.2.16. %get-cstring [Function]

+

12.3.2.16. %get-cstring [Function]

@@ -14031,5 +14224,5 @@
-

12.3.2.17. %str-from-ptr [Function]

+

12.3.2.17. %str-from-ptr [Function]

@@ -15477,5 +15670,5 @@
- +
Description:

Reads a symbol from the current input stream, with *PACKAGE* @@ -15529,5 +15722,5 @@

- +
Description:

In CCL 1.2 and later, the #& reader macro can be used to @@ -15588,5 +15781,5 @@

- +
Description:

In CCL 0.14.2 and later, the #? reader macro can be used @@ -15635,5 +15828,5 @@

- +
Description:

In CCL 1.2 and later, the #/ reader macro can be used to @@ -15738,5 +15931,5 @@

- +
Description:

In CCL 1.2 and later, the #> reader macro reads @@ -15767,5 +15960,5 @@

- +
Values:

library---either an object of type SHLIB, or a string which @@ -15774,5 +15967,5 @@

- +
Description:

If completely is T, sets the @@ -15803,5 +15996,5 @@

- +
Values:

name---A symbol which can be made into a special variable

@@ -15820,5 +16013,5 @@
- +
Description:

Proclaims name @@ -15856,5 +16049,5 @@

- +
Values:

name---NIL or a keyword; the keyword may contain @@ -15864,5 +16057,5 @@

- +
Description:

If name is non-NIL, defines name to be an alias for the @@ -15898,5 +16091,5 @@

- +
Values:

name--- @@ -15911,5 +16104,5 @@

- +
Description:

If there is already an EXTERNAL-ENTRY-POINT for @@ -15939,5 +16132,5 @@

- +
Values:

name---A lisp string. See external, above.

@@ -15952,5 +16145,5 @@
- +
Description:

Calls the foreign function at the address obtained by @@ -15979,5 +16172,5 @@

- +
Values:

entrypoint---A fixnum or MACPTR

@@ -15990,5 +16183,5 @@
- +
Description:

Calls the foreign function at address entrypoint passing the @@ -16016,5 +16209,5 @@

- +
Values:

entrypoint---A fixnum or MACPTR

@@ -16029,5 +16222,5 @@
- +
Description:

Calls the foreign function at address entrypoint passing the @@ -16054,10 +16247,10 @@

- +
Values:

name---A lisp string.

- +
Description:

Tries to resolve the address of the foreign symbol @@ -16082,10 +16275,10 @@

- +
Values:

name---A lisp string.

- +
Description:

Tries to resolve the address of the foreign symbol name. If @@ -16109,5 +16302,5 @@

- +
Values:

ptr---A MACPTR that points to a block of @@ -16115,5 +16308,5 @@

- +
Description:

In CCL 1.2 and later, the CCL:FREE @@ -16147,5 +16340,5 @@

- +
Values:

element-count---A positive integer.

@@ -16162,5 +16355,5 @@
- +
Description:

@@ -16197,5 +16390,5 @@

- +
Values:

typespec---A foreign type specifier, or a keyword which is used @@ -16214,5 +16407,5 @@

- +
Description:

@@ -16263,5 +16456,5 @@

- +
Values:

typespec---A foreign type specifier, or a keyword which is used @@ -16277,5 +16470,5 @@

- +
Description:

@@ -16318,5 +16511,5 @@

- +
Notes:

@@ -16351,5 +16544,5 @@

- +
Values:

name---A SIMPLE-STRING which is presumed to be the so-name of @@ -16359,5 +16552,5 @@

- +
Description:

If the library denoted by name can @@ -16370,5 +16563,5 @@

- +
Examples:
;;; Try to do something simple.
@@ -16405,5 +16598,5 @@
- +
Notes:

It would be helpful to describe what an soname is and give @@ -16428,5 +16621,5 @@

- +
Values:

ptr---a MACPTR.

@@ -16436,5 +16629,5 @@
- +
Description:

References an instance of a foreign type (or a component of @@ -16462,5 +16655,5 @@

- +
Values:

eep---An EXTERNAL-ENTRY-POINT, as obtained by the EXTERNAL @@ -16468,5 +16661,5 @@

- +
Description:

Tries to resolve the address of the EXTERNAL-ENTRY-POINT @@ -16491,5 +16684,5 @@

- +
Values:

var---A symbol (a lisp variable)

@@ -16499,5 +16692,5 @@
- +
Description:

Executes body @@ -16529,5 +16722,5 @@

- +
Values:

var---A symbol (a lisp variable)

@@ -16536,5 +16729,5 @@
- +
Description:

Executes body in an environment in which each var is @@ -16563,5 +16756,5 @@

- +
Values:

object---A CLOS object of a class for which there exists @@ -16571,5 +16764,5 @@

- +
Description:

@@ -16608,5 +16801,5 @@

- +
Example:
@@ -16622,5 +16815,5 @@
- +
See Also:
@@ -16644,5 +16837,5 @@
- +
Values:

dir-id---A keyword whose pname, mapped to lower case, names a @@ -16651,5 +16844,5 @@

- +
Description:

Tells CCL to remove the interface directory denoted by @@ -16675,5 +16868,5 @@

- +
Values:

dir-id---A keyword whose pname, mapped to lower case, names a @@ -16682,5 +16875,5 @@

- +
Description:

Tells CCL to add the interface directory denoted by @@ -16704,5 +16897,5 @@

- +
Examples:

One typically wants interface information to be @@ -16890,5 +17083,5 @@ The class's Lisp name is now proclaimed to be a "static" variable (as if by DEFSTATIC, as described in the - "Static Variables" + "Static Variables" section) and given the class object as its value. In other words:

@@ -18357,5 +18550,5 @@
- +
Arguments and Values:

name---a string which is the name of an existing @@ -18367,5 +18560,5 @@

- +
Description:

@@ -18388,5 +18581,5 @@

- +
Arguments and Values:

name---a string which is the name of a new or existing @@ -18401,5 +18594,5 @@

- +
Description:

@@ -18425,5 +18618,5 @@

- +
Values:

path---a string, an absolute pathname in Posix format - with @@ -18431,5 +18624,5 @@

- +
Description:

@@ -18453,5 +18646,5 @@

- +
Values:

uid---a non-negative integer, identifying a specific user @@ -18459,5 +18652,5 @@

- +
Description:

@@ -18479,5 +18672,5 @@

- +
Arguments and Values:

uid---a non-negative integer, identifying a specific user @@ -18488,5 +18681,5 @@

- +
Description:

@@ -18511,5 +18704,5 @@

- +
Arguments and Values:

gid---a non-negative integer, identifying a specific @@ -18520,5 +18713,5 @@

- +
Description:

@@ -18543,10 +18736,10 @@

- +
Values:

pid---a non-negative integer, identifying an OS process

- +
Description:

@@ -18569,5 +18762,5 @@

- +
Values:

uid---a non-negative integer, identifying a specific user @@ -18577,5 +18770,5 @@

- +
Description:

@@ -18602,5 +18795,5 @@

- +
Values:

command-line---a string, obeying all the whitespace and @@ -18611,5 +18804,5 @@

- +
Description:

@@ -18627,5 +18820,5 @@

- +
Notes:

@@ -18652,5 +18845,5 @@

- +
Arguments and Values:

class-name---a string which denotes an existing class name, or a @@ -18659,5 +18852,5 @@

- +
Description:

Used to refer to a known ObjC class by name. (Via the use @@ -18684,5 +18877,5 @@

- +
Arguments and Values:

string---a string constant, used to canonically refer to an @@ -18690,5 +18883,5 @@

- +
Description:

Used to refer to an ObjC method selector (method name). Uses @@ -18712,5 +18905,5 @@

- +
Arguments and Values:

name-and-result-type---either an Objective-C message name, for methods @@ -18734,5 +18927,5 @@

- +
Description:

Defines an Objective-C-callable method which implements @@ -18759,5 +18952,5 @@

- +
Arguments and Values:

selector---either a string which represents the name of the @@ -18774,5 +18967,5 @@

- +
Description:

Defines an ObjC-callable method which implements the @@ -18795,10 +18988,10 @@

- +
Arguments and Values:

As per DEFINE-OBJC-METHOD

- +
Description:

Like DEFINE-OBJC-METHOD, only used to define methods on the @@ -18842,5 +19035,5 @@

- +
Description:

This variable is currently only used by the standard reader macro @@ -18877,5 +19070,5 @@

- +
Description:

Per ANSI CL, Clozure CL supports the :EXTERNAL-FORMAT keyword @@ -18921,5 +19114,5 @@

- +
Description:

The value of this variable is used when :EXTERNAL-FORMAT is @@ -18945,10 +19138,10 @@

- +
Superclasses:

NS:NS-STRING

- +
Initargs:

:string--- @@ -18958,5 +19151,5 @@

- +
Description:

@@ -18976,5 +19169,5 @@

- +
Examples:

@@ -19007,5 +19200,5 @@

- +
Notes:

@@ -19347,5 +19540,5 @@

- +
Arguments and Values:

type---The type of population, one of :LIST (the default) or :ALIST

@@ -19355,5 +19548,5 @@
- +
Description:

Creates a new population of the specified type.

@@ -19373,5 +19566,5 @@
- +
Description:

returns the type of population, one of :LIST or :ALIST

@@ -19391,5 +19584,5 @@
- +
Description:

returns the list encapsulated in population. @@ -19414,5 +19607,5 @@

- +
Description:

Sets the list encapsulated in population to @@ -19447,5 +19640,5 @@

- +
Description:

Returns the value of the kernel variable that specifies the @@ -19468,10 +19661,10 @@

- +
Arguments and Values:

new-threshold---The requested new lisp-heap-gc-threshold.

- +
Description:

Sets the value of the kernel variable that specifies the @@ -19497,5 +19690,5 @@

- +
Description:

Tries to grow or shrink lisp's heap space, so that the @@ -19517,10 +19710,10 @@

- +
Arguments and Values:

arg---a generalized boolean

- +
Description:

Enables the EGC if arg is non-nil, disables the EGC @@ -19548,5 +19741,5 @@

- +
Description:

Returns T if the EGC was enabled at the time of the call, @@ -19571,5 +19764,5 @@

- +
Description:

Returns T if the EGC was active at the time of the call, NIL @@ -19596,5 +19789,5 @@

- +
Description:

Returns, as multiple values, the sizes in kilobytes of the @@ -19618,5 +19811,5 @@

- +
Arguments and Values:

generation-0-size---the requested threshold size of the youngest @@ -19628,5 +19821,5 @@

- +
Description:

Puts the indicated threshold sizes in effect. @@ -19652,10 +19845,10 @@

- +
Arguments and Values:

arg---a generalized boolean

- +
Description:

Tries to influence the GC to retain/recycle the pages @@ -19682,5 +19875,5 @@

- +
Description:

Returns T if the GC tries to retain pages between full GCs @@ -19837,5 +20030,5 @@

- 16.7.2. Recommended Reading + 16.7.2. Recommended Reading
@@ -21113,5 +21306,5 @@

  • To support a feature called GCTWA - [1] + [1] , the vector that contains the internal symbols of the current package is marked on entry to the @@ -21246,5 +21439,5 @@

    -

    [1] I believe that the acronym comes from MACLISP, +

    [1] I believe that the acronym comes from MACLISP, where it stood for "Garbage Collection of Truly Worthless Atoms".

    @@ -21306,5 +21499,5 @@ generations looking for such intergenerational references, the runtime system must note all such intergenerational references - at the point where they're created (via Setf).[2] The + at the point where they're created (via Setf).[2] The set of pointers that may contain intergenerational references is sometimes called the remembered set.

    @@ -21353,5 +21546,5 @@ that might introduce an intergenerational reference must be memoized. - [3] It's always safe to + [3] It's always safe to push any cons cell or gvector locative onto the memo stack; it's never safe to push anything else. @@ -21374,5 +21567,5 @@
    -

    [2] This is +

    [2] This is sometimes called "The Write Barrier": all assignments which might result in intergenerational references must be noted, as @@ -21380,5 +21573,5 @@

    -

    [3] Note that the implicit setfs that occur when +

    [3] Note that the implicit setfs that occur when initializing an object - as in the case of a call to cons or vector - can't introduce intergenerational references, since @@ -21496,5 +21689,5 @@

    -

    16.7.2. Recommended Reading

    +

    16.7.2. Recommended Reading

    @@ -21909,5 +22102,5 @@
    - +
    Description:

    When true, attempts to redefine (via DEFUN or DEFMETHOD) @@ -21934,5 +22127,5 @@

    - +
    Description:

    Arranges that the outermost special bindings of *PACKAGE* @@ -21958,5 +22151,5 @@

    - +
    Description:

    Arranges that the outermost special bindings of *PACKAGE* @@ -21981,5 +22174,5 @@

    - +
    Description:

    This variable is initialized each time an Clozure CL session @@ -22006,5 +22199,5 @@

    - +
    Description:

    Returns non-NIL if AltiVec is available.

    @@ -22024,5 +22217,5 @@
    - +
    Description:

    Intended to control the expansion of certain lap macros. @@ -22046,5 +22239,5 @@

    - +
    Arguments and Values:

    reglist---A list of vector register names (vr0 .. vr31).

    @@ -22052,5 +22245,5 @@
    - +
    Description:

    Specifies the set of AltiVec registers used in body. If @@ -22078,5 +22271,5 @@

    - +
    Arguments and Values:

    base---Any available general-purpose register.

    @@ -22087,5 +22280,5 @@
    - +
    Description:

    Generates code which allocates a 16-byte aligned buffer @@ -22481,4 +22674,6 @@

    accept-connection, Function ACCEPT-CONNECTION
    +
    advise, Macro ADVISE
    +
    advisedp, Macro ADVISEDP
    all-processes, Function ALL-PROCESSES
    altivec-available-p, Function ALTIVEC-AVAILABLE-P
    @@ -22722,4 +22917,5 @@

    U

    +
    unadvise, Macro UNADVISE
    unuse-interface-dir, Function UNUSE-INTERFACE-DIR
    unwatch, Function UNWATCH
    @@ -22752,5 +22948,5 @@ Symbol Index
    -

    This document was last modified at 3:0 on June 9, 2010, in UTC.

    It uses version 1.73.2 of the Norman Walsh Docbook stylesheets.

    Built from subversion rev 13790

    Using libxml 20631, libxslt 10122 and libexslt 813.

    +

    This document was last modified at 19:0 on June 15, 2010, in UTC.

    It uses version 1.73.2 of the Norman Walsh Docbook stylesheets.

    Built from subversion rev 13830

    Using libxml 20631, libxslt 10122 and libexslt 813.