Index: /trunk/source/doc/src/build.xml =================================================================== --- /trunk/source/doc/src/build.xml (revision 16295) +++ /trunk/source/doc/src/build.xml (revision 16296) @@ -40,7 +40,7 @@ may be helpful to refer to these definitions. - fasl - filesfasl - files are the object files produced + + + fasl files are the object files produced by compile-file. fasl files store the machine code associated with function definitions and the @@ -53,7 +53,5 @@ - The lisp - kernel Lisp - kernel is a C program with a fair amount of + The Lisp kernel is a C program with a fair amount of platform-specific assembly language code. Its basic job is to map a lisp heap image into memory, transfer control to some @@ -65,7 +63,5 @@ . - A heap - image heap - image is a file that can be quickly mapped into a + A heap image is a file that can be quickly mapped into a process's address space. Conceptually, it's not too different from an executable file or shared library in the OS's native @@ -78,6 +74,6 @@ . - A bootstrapping - image bootstrapping image is a minimal + A bootstrapping image () + is a minimal heap image used in the process of building &CCL; itself. The bootstrapping image contains just enough code to load the rest @@ -92,5 +88,5 @@ as-yet-unsupported ones) has a uniquely named subdirectory of ccl/lisp-kernel/; each such - kernel build directory + kernel build directory contains a Makefile and may contain some auxiliary files (linker scripts, etc.) that are used to build the lisp kernel on a Index: /trunk/source/doc/src/external-process.xml =================================================================== --- /trunk/source/doc/src/external-process.xml (revision 16295) +++ /trunk/source/doc/src/external-process.xml (revision 16296) @@ -87,5 +87,5 @@ - program + program @@ -97,5 +97,5 @@ - args + args @@ -105,5 +105,5 @@ - wait + wait @@ -115,5 +115,5 @@ - pty + pty @@ -125,5 +125,5 @@ - sharing + sharing @@ -136,5 +136,5 @@ - input + input @@ -176,5 +176,5 @@ - if-input-does-not-exist + if-input-does-not-exist @@ -186,5 +186,5 @@ - output + output @@ -195,5 +195,5 @@ - if-output-exists + if-output-exists @@ -205,5 +205,5 @@ - error + error @@ -216,5 +216,5 @@ - if-error-exists + if-error-exists @@ -224,5 +224,5 @@ - status-hook + status-hook @@ -235,5 +235,5 @@ - external-format + external-format @@ -247,5 +247,5 @@ - env + env @@ -262,5 +262,5 @@ - >silently-ignore-catastrophic-failures + >silently-ignore-catastrophic-failures @@ -270,5 +270,5 @@ by setting the status and exit-code fields. Default is - *silently-ignore-catastrophic-failure-in-run-program*. + *silently-ignore-catastrophic-failure-in-run-program*. @@ -314,5 +314,5 @@ - proc + proc @@ -322,5 +322,5 @@ - signal + signal @@ -329,5 +329,5 @@ - error-if-exited + error-if-exited @@ -342,6 +342,6 @@ - Sends signal to the external process - proc. (Typically, it would only be + Sends signal to the external process + proc. (Typically, it would only be useful to call this function if the EXTERNAL-PROCESS was created with :WAIT NIL.) @@ -352,5 +352,5 @@ - However, if error-if-exited is nil, + However, if error-if-exited is nil, and the attempt to signal the external process fails because the external process has already exited, the @@ -382,5 +382,5 @@ - proc + proc @@ -422,5 +422,5 @@ - proc + proc @@ -461,5 +461,5 @@ - proc + proc @@ -501,5 +501,5 @@ - proc + proc @@ -541,5 +541,5 @@ - proc + proc Index: /trunk/source/doc/src/ffi.xml =================================================================== --- /trunk/source/doc/src/ffi.xml (revision 16295) +++ /trunk/source/doc/src/ffi.xml (revision 16296) @@ -87,5 +87,5 @@ corresponds to NS:NS-RECT, and you can use :NS-RECT as a type designator - in RLET forms to + in forms to specify a structure of type NS-RECT. @@ -256,5 +256,5 @@ - :UNSIGNED-BYTE + :UNSIGNED-BYTE @@ -264,5 +264,5 @@ - :SIGNED-BYTE + :SIGNED-BYTE @@ -272,5 +272,5 @@ - :UNSIGNED-HALFWORD + :UNSIGNED-HALFWORD @@ -280,5 +280,5 @@ - :SIGNED-HALFWORD + :SIGNED-HALFWORD @@ -288,5 +288,5 @@ - :UNSIGNED-FULLWORD + :UNSIGNED-FULLWORD @@ -296,5 +296,5 @@ - :SIGNED-FULLWORD + :SIGNED-FULLWORD @@ -304,5 +304,5 @@ - :UNSIGNED-DOUBLEWORD + :UNSIGNED-DOUBLEWORD @@ -312,5 +312,5 @@ - :SIGNED-DOUBLEWORD + :SIGNED-DOUBLEWORD @@ -320,5 +320,5 @@ - :SINGLE-FLOAT + :SINGLE-FLOAT @@ -328,5 +328,5 @@ - :DOUBLE-FLOAT + :DOUBLE-FLOAT @@ -336,5 +336,5 @@ - :ADDRESS + :ADDRESS @@ -345,5 +345,5 @@ - :VOID + :VOID @@ -662,5 +662,5 @@ - ptr + ptr @@ -670,5 +670,5 @@ - offset + offset @@ -716,5 +716,5 @@ - ptr + ptr @@ -724,5 +724,5 @@ - bit-offset + bit-offset @@ -767,5 +767,5 @@ - ptr + ptr @@ -774,5 +774,5 @@ - bit-offset + bit-offset @@ -782,5 +782,5 @@ - width + width @@ -822,5 +822,5 @@ - int + int @@ -865,5 +865,5 @@ - ptr + ptr @@ -873,5 +873,5 @@ - delta + delta @@ -914,5 +914,5 @@ - ptr + ptr @@ -977,5 +977,5 @@ - ptr + ptr @@ -1018,5 +1018,5 @@ - dest-ptr + dest-ptr @@ -1026,5 +1026,5 @@ - src-ptr + src-ptr @@ -1067,5 +1067,5 @@ - ptr + ptr @@ -1075,5 +1075,5 @@ - delta + delta @@ -1118,5 +1118,5 @@ - var + var @@ -1126,5 +1126,5 @@ - expr + expr @@ -1169,5 +1169,5 @@ - var + var @@ -1177,5 +1177,5 @@ - expr + expr @@ -1220,5 +1220,5 @@ - string + string @@ -1263,5 +1263,5 @@ - var + var @@ -1271,5 +1271,5 @@ - string + string @@ -1333,5 +1333,5 @@ - varI + varI @@ -1341,5 +1341,5 @@ - stringI + stringI @@ -1382,5 +1382,5 @@ - ptr + ptr @@ -1410,6 +1410,6 @@ - Returns a lisp string of length length, - whose contents are initialized from the bytes at ptr. + Returns a lisp string of length length, + whose contents are initialized from the bytes at ptr. @@ -1420,6 +1420,7 @@ - ptrA - MACPTRlengtha + ptrA + MACPTR + lengtha non-negative fixnum @@ -3075,5 +3076,5 @@ - library + library @@ -3084,5 +3085,5 @@ - completely + completely @@ -3096,9 +3097,9 @@ Description - If completely is T, sets the - reference count of library to 0. Otherwise, + If completely is T, sets the + reference count of library to 0. Otherwise, decrements it by 1. In either case, if the reference count becomes 0, close-shared-library - frees all memory resources consumed library + frees all memory resources consumed library and causes any EXTERNAL-ENTRY-POINTs known to be defined by it to @@ -3132,5 +3133,5 @@ - name + name @@ -3140,5 +3141,5 @@ - arg-type-specifer + arg-type-specifer @@ -3156,5 +3157,5 @@ - var + var @@ -3165,5 +3166,5 @@ - body + body @@ -3178,5 +3179,5 @@ Description - Proclaims name + Proclaims name to be a special variable; sets its value to a MACPTR which, when called by foreign code, calls a lisp function @@ -3186,5 +3187,5 @@ are bound to stack-allocated MACPTRs. - If name + If name is already a callback function pointer, its value is not changed; instead, it's arranged @@ -3196,5 +3197,5 @@ defcallback returns the callback pointer, e.g., the - value of name. + value of name. @@ -3223,5 +3224,5 @@ - name + name @@ -3232,5 +3233,5 @@ - foreign-type-spec + foreign-type-spec @@ -3258,6 +3259,6 @@ type names, one for the names of ordinary types and one for the names of structs and unions. Which one - name refers to depends on - foreign-type-spec in the obvious manner. + name refers to depends on + foreign-type-spec in the obvious manner. @@ -3288,5 +3289,5 @@ - name + name @@ -3297,10 +3298,10 @@ - entry + entry an object of type EXTERNAL-ENTRY-POINT which maintains the address of the foreign symbol named by - name. + name. @@ -3313,5 +3314,5 @@ If there is already an EXTERNAL-ENTRY-POINT for - the symbol named by name, finds it and + the symbol named by name, finds it and returns it. If not, creates one and returns it. @@ -3349,5 +3350,5 @@ - name + name @@ -3357,5 +3358,5 @@ - arg-type-specifer + arg-type-specifer @@ -3367,5 +3368,5 @@ - arg + arg @@ -3376,5 +3377,5 @@ - result-type-specifier + result-type-specifier @@ -3424,5 +3425,5 @@ - entrypoint + entrypoint @@ -3432,5 +3433,5 @@ - arg-type-keyword + arg-type-keyword @@ -3441,5 +3442,5 @@ - arg + arg @@ -3450,5 +3451,5 @@ - result-type-keyword + result-type-keyword @@ -3496,5 +3497,5 @@ - entrypoint + entrypoint @@ -3504,5 +3505,5 @@ - arg-type-specifer + arg-type-specifer @@ -3514,5 +3515,5 @@ - arg + arg @@ -3523,5 +3524,5 @@ - result-type-specifier + result-type-specifier @@ -3569,5 +3570,5 @@ - name + name @@ -3612,5 +3613,5 @@ - name + name @@ -3653,5 +3654,5 @@ - ptr + ptr @@ -3707,5 +3708,5 @@ - element-count + element-count @@ -3714,5 +3715,5 @@ - element-type + element-type @@ -3723,5 +3724,5 @@ - vector + vector @@ -3731,5 +3732,5 @@ - mactpr + mactpr @@ -3740,5 +3741,5 @@ - size + size @@ -3795,5 +3796,5 @@ - typespec + typespec @@ -3804,8 +3805,8 @@ - initforms - - - If the type denoted by typespec + initforms + + + If the type denoted by typespec is scalar, a single value appropriate for that type; otherwise, a list of alternating field names and @@ -3815,5 +3816,5 @@ - result + result @@ -3836,5 +3837,5 @@ Allocates a block of foreign memory suitable to hold the foreign type described by typespec, in the same manner - as MAKE-RECORD. In + as . In addition, MAKE-GCABLE-RECORD marks the returned object gcable; in other words, it informs the garbage @@ -3898,5 +3899,5 @@ - typespec + typespec @@ -3907,8 +3908,8 @@ - initforms - - - If the type denoted by typespec + initforms + + + If the type denoted by typespec is scalar, a single value appropriate for that type; otherwise, a list of alternating field names and @@ -3918,5 +3919,5 @@ - result + result @@ -3936,5 +3937,5 @@ Expands into code which allocates and initializes an instance of the type - denoted by typespec, on the foreign + denoted by typespec, on the foreign heap. The record is allocated using the C function malloc, and the user of @@ -3945,10 +3946,10 @@ - If initforms is provided, its value + If initforms is provided, its value or values are used in the initialization. When the type - is a scalar, initforms is either a single + is a scalar, initforms is either a single value which can be coerced to that type, or no value, in which - case binary 0 is used. When the type is a struct, - initforms is a list, giving field names + case binary 0 is used. When the type is a struct, + initforms is a list, giving field names and the values for each. Each field is treated in the same way as a scalar is: If a value for it is given, it must be @@ -3957,10 +3958,10 @@ - When the type is an array, initforms may + When the type is an array, initforms may not be provided, because make-record cannot initialize its values. make-record - is also unable to initialize fields of a struct + is also unable to initialize fields of a struct which are themselves - structs. The user of + structs. The user of make-record should set these values by another means. @@ -3980,5 +3981,5 @@ It is inconvenient that make-record is a - macro, because this means that typespec + macro, because this means that typespec cannot be a variable; it must be an immediate value. @@ -4019,5 +4020,5 @@ - name + name A SIMPLE-STRING which is presumed to be the so-name of @@ -4027,8 +4028,8 @@ - library + library An object of type SHLIB which describes the - library denoted by name. + library denoted by name. @@ -4039,5 +4040,5 @@ Description - If the library denoted by name can + If the library denoted by name can be loaded by the operating system, returns an object of type SHLIB that describes @@ -4119,5 +4120,5 @@ - ptr + ptr @@ -4127,5 +4128,5 @@ - accessor-form + accessor-form @@ -4177,5 +4178,5 @@ - eep + eep @@ -4225,5 +4226,5 @@ - var + var @@ -4233,5 +4234,5 @@ - typespec + typespec @@ -4241,5 +4242,5 @@ - initforms + initforms @@ -4254,5 +4255,5 @@ Description - Executes body + Executes body in an environment in which each var is bound to a MACPTR encapsulating the @@ -4260,5 +4261,5 @@ initialized from typespec and initforms as per . - Returns whatever value(s) body + Returns whatever value(s) body returns. @@ -4292,5 +4293,5 @@ - var + var @@ -4300,5 +4301,5 @@ - typespec + typespec @@ -4308,5 +4309,5 @@ - initforms + initforms @@ -4357,5 +4358,5 @@ - object + object @@ -4458,5 +4459,5 @@ - dir-id + dir-id @@ -4503,5 +4504,5 @@ - dir-id + dir-id Index: /trunk/source/doc/src/gc.xml =================================================================== --- /trunk/source/doc/src/gc.xml (revision 16295) +++ /trunk/source/doc/src/gc.xml (revision 16296) @@ -278,5 +278,5 @@ - type + type The type of population, one of :LIST (the default) or :ALIST @@ -285,5 +285,5 @@ - initial-contents + initial-contents A sequence of elements (or conses, for :alist) to be used to initialize the @@ -446,5 +446,5 @@ - new-threshold + new-threshold @@ -512,5 +512,5 @@ - arg + arg @@ -626,5 +626,5 @@ - generation-0-size + generation-0-size @@ -635,5 +635,5 @@ - generation-1-size + generation-1-size @@ -644,5 +644,5 @@ - generation-2-size + generation-2-size @@ -687,5 +687,5 @@ - arg + arg Index: /trunk/source/doc/src/hemlock.xml =================================================================== --- /trunk/source/doc/src/hemlock.xml (revision 16295) +++ /trunk/source/doc/src/hemlock.xml (revision 16296) @@ -2058,5 +2058,5 @@ Description -delete-buffer removes buffer from (all-buffers) and its name +delete-buffer removes buffer from () and its name from *buffer-names*. Before buffer is deleted, this invokes the functions on buffer returned by buffer-delete-hook and those found @@ -3701,5 +3701,5 @@ - string-name + string-name @@ -3709,5 +3709,5 @@ - documentation + documentation @@ -3717,5 +3717,5 @@ - :mode, :buffer + mode, buffer @@ -3725,5 +3725,5 @@ - :value + value @@ -3733,5 +3733,5 @@ - :hooks + hooks Index: /trunk/source/doc/src/ide.xml =================================================================== --- /trunk/source/doc/src/ide.xml (revision 16295) +++ /trunk/source/doc/src/ide.xml (revision 16296) @@ -248,7 +248,7 @@ the required subsystems, if necessary. - - - BUILD-APPLICATION &key; + build-application + BUILD-APPLICATIONFunction + BUILD-APPLICATION &key; (name "MyApplication") (type-string "APPL") @@ -261,7 +261,7 @@ (application-class 'GUI::COCOA-APPLICATION) (toplevel-function NIL) - [Function] - - + + + Description The build-application function constructs an @@ -280,5 +280,5 @@ - name + name Specifies the application name of the @@ -292,5 +292,5 @@ - type-string + type-string Specifies type of bundle to create. You should normally @@ -301,5 +301,5 @@ - creator-string + creator-string Specifies the creator @@ -314,5 +314,5 @@ - directory + directory The directory in which BUILD-APPLICATION @@ -328,5 +328,5 @@ - copy-ide-resources + copy-ide-resources Whether to copy the resource files from the IDE's @@ -349,5 +349,5 @@ - info-plist + info-plist A user-supplied NSDictionary object that defines the @@ -367,5 +367,5 @@ - nibfiles + nibfiles A list of pathnames, where each pathname identifies @@ -384,5 +384,5 @@ - main-nib-name + main-nib-name The name of @@ -397,5 +397,5 @@ - application-class + application-class The name of the application's CLOS class. The default @@ -407,5 +407,5 @@ - toplevel-function + toplevel-function The toplevel function that runs when the application @@ -462,4 +462,7 @@ example in "ccl/examples/cocoa/currency-converter/". + + + Index: /trunk/source/doc/src/implementation.xml =================================================================== --- /trunk/source/doc/src/implementation.xml (revision 16295) +++ /trunk/source/doc/src/implementation.xml (revision 16296) @@ -1175,11 +1175,9 @@ - To support a feature called GCTWA - - I believe that the acronym comes from MACLISP, + To support a feature called GCTWA + (an acronym that I believe comes from MACLISP, where it stood for "Garbage Collection of Truly - Worthless Atoms". - - , the vector that contains the internal + Worthless Atoms"), + the vector that contains the internal symbols of the current package is marked on entry to the mark phase, but the symbols themselves are not marked at @@ -1342,8 +1340,8 @@ generations looking for such intergenerational references, the runtime system must note all such intergenerational references - at the point where they're created (via Setf).This is + at the point where they're created (via Setf). (This is sometimes called "The Write Barrier": all assignments which might result in intergenerational references must be noted, as - if the other generations were write-protected. The + if the other generations were write-protected). The set of pointers that may contain intergenerational references is sometimes called the remembered set. @@ -1391,9 +1389,9 @@ that might introduce an intergenerational reference must be memoized. - Note that the implicit setfs that occur when + 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 the newly created object is always younger than the objects - used to initialize it. It's always safe to + used to initialize it. It's always safe to push any cons cell or gvector locative onto the memo stack; it's never safe to push anything else. Index: /trunk/source/doc/src/install.xml =================================================================== --- /trunk/source/doc/src/install.xml (revision 16295) +++ /trunk/source/doc/src/install.xml (revision 16296) @@ -180,5 +180,5 @@ in the ccl directory. If you use a shell, you can set the value of the - CCL_DEFAULT_DIRECTORY environment variable + CCL_DEFAULT_DIRECTORY environment variable to explicitly indicate the location of the ccl directory. If you choose to do @@ -194,5 +194,5 @@ Download and extract one on your local disk. Then edit the &CCL; shell script to set - the value of CCL_DEFAULT_DIRECTORY and start + the value of CCL_DEFAULT_DIRECTORY and start up the appropriate &CCL; kernel. See for more information about the @@ -526,5 +526,5 @@ information (see The Interface Database) and the Lisp build process (see - Building &CCL; from its Source + Building &CCL; from its Source Code). Specifically, it needs to set up logical pathname translations for the "ccl:" @@ -551,9 +551,9 @@ Copy the script to a directory that is on your - PATH. This is often + PATH. This is often /usr/local/bin or ~/bin. It is better to do this than to add ccl/scripts to your - PATH, because the script needs to be edited, + PATH, because the script needs to be edited, and editing it in-place means that Subversion sees the script as modified.. Index: /trunk/source/doc/src/modifying.xml =================================================================== --- /trunk/source/doc/src/modifying.xml (revision 16295) +++ /trunk/source/doc/src/modifying.xml (revision 16296) @@ -471,5 +471,5 @@ - reglist + reglist @@ -479,5 +479,5 @@ - body + body @@ -523,5 +523,5 @@ - base + base @@ -531,5 +531,5 @@ - n + n @@ -541,5 +541,5 @@ - body + body Index: /trunk/source/doc/src/platform-notes.xml =================================================================== --- /trunk/source/doc/src/platform-notes.xml (revision 16295) +++ /trunk/source/doc/src/platform-notes.xml (revision 16296) @@ -441,5 +441,5 @@ - name + name @@ -451,9 +451,9 @@ - value + value if there is an environment variable named - name, its value, as a string; if there + name, its value, as a string; if there is not, NIL @@ -467,5 +467,5 @@ Looks up the value of the environment variable named by - name, in the OS environment. + name, in the OS environment. @@ -492,5 +492,5 @@ - name + name @@ -502,15 +502,15 @@ - value + value a string, to be the new value of the environment variable - named by name - - - - - errno + named by name + + + + + errno @@ -528,5 +528,5 @@ Sets the value of the environment variable named by - name, in the OS environment. If there is + name, in the OS environment. If there is no such environment variable, creates it. @@ -556,5 +556,5 @@ - path + path @@ -597,5 +597,5 @@ - uid + uid @@ -636,5 +636,5 @@ - uid + uid @@ -645,5 +645,5 @@ - errno + errno @@ -688,5 +688,5 @@ - gid + gid @@ -697,5 +697,5 @@ - errno + errno @@ -740,5 +740,5 @@ - pid + pid @@ -779,5 +779,5 @@ - uid + uid @@ -787,5 +787,5 @@ - path + path @@ -802,8 +802,8 @@ Looks up and returns the defined home directory of the user - identified by uid. This value comes from the - OS user database, not from the $HOME + identified by uid. This value comes from the + OS user database, not from the $HOME environment variable. Returns NIL if there is no user with - the ID uid. + the ID uid. @@ -831,5 +831,5 @@ - command-line + command-line a string, obeying all the whitespace and @@ -841,5 +841,5 @@ - exit-code + exit-code a non-negative integer, returned as the exit @@ -856,10 +856,10 @@ invokes the user's default system shell (such as sh or tcsh) as a new process, and has that shell execute - command-line. + command-line. If the shell was able to find the command specified in - command-line, then exit-code + command-line, then exit-code is the exit code of that command. If not, it is the exit code of the shell itself. @@ -901,5 +901,5 @@ - class-name + class-name @@ -947,5 +947,5 @@ - string + string @@ -989,5 +989,5 @@ - name-and-result-type + name-and-result-type @@ -1001,5 +1001,5 @@ - receiver-arg-and-class + receiver-arg-and-class @@ -1017,5 +1017,5 @@ - other-args + other-args @@ -1065,5 +1065,5 @@ - selector + selector @@ -1078,5 +1078,5 @@ - class-name + class-name @@ -1215,5 +1215,5 @@ - :string + :string Index: /trunk/source/doc/src/profile.xml =================================================================== --- /trunk/source/doc/src/profile.xml (revision 16295) +++ /trunk/source/doc/src/profile.xml (revision 16296) @@ -356,8 +356,8 @@ Reference - - CHUD:*SHARK-CONFIG-FILE* - [Variable] + chud:*shark-config-file* + CHUD:*SHARK-CONFIG-FILE*Variable + CHUD:*SHARK-CONFIG-FILE* + Description When non-null, this should be the pathname of an alternate @@ -365,7 +365,10 @@ Shark.app. - CHUD:METER form &key; (reset nil) - (debug-output nil) [Macro] + + + chud:meter + CHUD:METERMacro + CHUD:METER form &key; (reset nil) (debug-output nil) + Description Executes FORM (an arbitrary lisp form) and returns whatever @@ -379,5 +382,5 @@ - debug-output + debug-output @@ -388,5 +391,5 @@ - reset + reset @@ -402,4 +405,6 @@ + + Index: /trunk/source/doc/src/sockets.xml =================================================================== --- /trunk/source/doc/src/sockets.xml (revision 16295) +++ /trunk/source/doc/src/sockets.xml (revision 16296) @@ -130,5 +130,5 @@ - address-family + address-family @@ -141,5 +141,5 @@ - type + type @@ -151,5 +151,5 @@ - connect + connect @@ -161,5 +161,5 @@ - eol + eol @@ -170,5 +170,5 @@ - format + format @@ -184,5 +184,5 @@ - remote + remote @@ -196,5 +196,5 @@ - remote-host + remote-host @@ -208,5 +208,5 @@ - remote-port + remote-port @@ -220,5 +220,5 @@ - remote-filename + remote-filename @@ -231,5 +231,5 @@ - local-address + local-address @@ -242,5 +242,5 @@ - local-host + local-host @@ -253,5 +253,5 @@ - local-port + local-port @@ -263,5 +263,5 @@ - local-filename + local-filename @@ -277,5 +277,5 @@ - keepalive + keepalive @@ -286,5 +286,5 @@ - reuse-address + reuse-address @@ -296,5 +296,5 @@ - nodelay + nodelay @@ -309,5 +309,5 @@ - broadcast + broadcast @@ -318,5 +318,5 @@ - linger + linger @@ -328,5 +328,5 @@ - backlog + backlog @@ -339,5 +339,5 @@ - input-timeout + input-timeout @@ -353,5 +353,5 @@ - output-timeout + output-timeout @@ -367,5 +367,5 @@ - connect-timeout + connect-timeout @@ -382,5 +382,5 @@ - auto-close + auto-close @@ -392,5 +392,5 @@ - deadline + deadline @@ -441,5 +441,5 @@ - socket + socket @@ -449,5 +449,5 @@ - wait + wait @@ -495,5 +495,5 @@ - host + host @@ -506,5 +506,5 @@ - port + port @@ -516,5 +516,5 @@ - socket-type + socket-type @@ -526,5 +526,5 @@ - connect + connect @@ -542,5 +542,5 @@ - address-family + address-family @@ -553,5 +553,5 @@ - numeric-host-p + numeric-host-p @@ -563,5 +563,5 @@ - numeric-port-p + numeric-port-p @@ -574,5 +574,5 @@ - singlep + singlep @@ -585,5 +585,5 @@ - errorp + errorp @@ -634,5 +634,5 @@ - dotted + dotted @@ -643,5 +643,5 @@ - errorp + errorp @@ -681,5 +681,5 @@ - ipaddr + ipaddr @@ -690,5 +690,5 @@ - values + values @@ -729,5 +729,5 @@ - ipaddr + ipaddr @@ -737,5 +737,5 @@ - ignore-cache + ignore-cache @@ -775,5 +775,5 @@ - host + host @@ -817,5 +817,5 @@ - port + port @@ -829,5 +829,5 @@ - protocol + protocol @@ -866,5 +866,5 @@ - socket + socket @@ -874,5 +874,5 @@ - size + size @@ -883,5 +883,5 @@ - buffer + buffer @@ -894,5 +894,5 @@ - extract + extract @@ -905,5 +905,5 @@ - offset + offset @@ -914,5 +914,5 @@ - want-socket-address-p + want-socket-address-p @@ -993,5 +993,5 @@ - socket + socket @@ -1001,5 +1001,5 @@ - buffer + buffer @@ -1010,5 +1010,5 @@ - size + size @@ -1018,5 +1018,5 @@ - remote + remote @@ -1029,5 +1029,5 @@ - remote-host + remote-host @@ -1039,5 +1039,5 @@ - remote-port + remote-port @@ -1049,5 +1049,5 @@ - offset + offset @@ -1085,5 +1085,5 @@ - socket + socket @@ -1093,5 +1093,5 @@ - direction + direction @@ -1132,5 +1132,5 @@ - socket + socket @@ -1174,5 +1174,5 @@ - socket + socket @@ -1211,5 +1211,5 @@ - socket + socket @@ -1248,5 +1248,5 @@ - socket + socket @@ -1285,5 +1285,5 @@ - socket + socket @@ -1321,5 +1321,5 @@ - thing + thing @@ -1358,5 +1358,5 @@ - socket-address + socket-address @@ -1398,5 +1398,5 @@ - socket-address + socket-address @@ -1437,5 +1437,5 @@ - socket + socket @@ -1474,5 +1474,5 @@ - socket + socket @@ -1511,5 +1511,5 @@ - socket + socket @@ -1593,5 +1593,5 @@ - socket-error + socket-error @@ -1629,5 +1629,5 @@ - socket-error + socket-error @@ -1671,5 +1671,5 @@ - socket-error + socket-error @@ -1709,5 +1709,5 @@ - socket + socket @@ -1717,5 +1717,5 @@ - abort + abort @@ -1760,5 +1760,5 @@ - var + var @@ -1768,5 +1768,5 @@ - make-socket-args + make-socket-args @@ -1776,5 +1776,5 @@ - body + body Index: /trunk/source/doc/src/streams.xml =================================================================== --- /trunk/source/doc/src/streams.xml (revision 16295) +++ /trunk/source/doc/src/streams.xml (revision 16296) @@ -230,5 +230,5 @@ - stream-list + stream-list A list of open file streams. This is a copy of @@ -279,5 +279,5 @@ - file-stream + file-stream A file stream. @@ -331,5 +331,5 @@ - file-stream + file-stream A file stream. @@ -618,5 +618,5 @@ - stream + stream @@ -626,5 +626,5 @@ - list + list @@ -636,5 +636,5 @@ - count + count @@ -677,5 +677,5 @@ - stream + stream @@ -685,5 +685,5 @@ - list + list @@ -695,5 +695,5 @@ - count + count @@ -735,5 +735,5 @@ - stream + stream @@ -743,5 +743,5 @@ - vector + vector @@ -753,5 +753,5 @@ - start + start @@ -764,5 +764,5 @@ - end + end @@ -808,5 +808,5 @@ - stream + stream @@ -816,5 +816,5 @@ - vector + vector @@ -826,5 +826,5 @@ - start + start @@ -837,5 +837,5 @@ - end + end @@ -878,6 +878,6 @@ Method Signatures - ccl::stream-device - (s stream) direction => fd + ccl::stream-device + (s stream) direction => fd @@ -887,5 +887,5 @@ - s + s a stream. @@ -893,5 +893,5 @@ - direction + direction either :INPUT or :OUTPUT. @@ -899,11 +899,11 @@ - fd + fd a file descriptor, which is a non-negative integer used by the OS to refer to an open file, socket, or similar I/O connection. NIL if there is no file descriptor associated - with s in the direction given by - direction. + with s in the direction given by + direction. @@ -915,7 +915,7 @@ Returns the file descriptor associated with - s in the direction given by - direction. It is necessary to specify - direction because the input and output + s in the direction given by + direction. It is necessary to specify + direction because the input and output file descriptors may be different; the most common case is when one of them has been redirected by the Unix shell. @@ -952,5 +952,5 @@ - stream + stream @@ -962,5 +962,5 @@ - ivector + ivector @@ -970,5 +970,5 @@ - start-octet + start-octet @@ -978,5 +978,5 @@ - max-octets + max-octets @@ -1017,5 +1017,5 @@ - stream + stream @@ -1027,5 +1027,5 @@ - ivector + ivector @@ -1035,5 +1035,5 @@ - start-octet + start-octet @@ -1043,5 +1043,5 @@ - max-octet + max-octet Index: /trunk/source/doc/src/threads.xml =================================================================== --- /trunk/source/doc/src/threads.xml (revision 16295) +++ /trunk/source/doc/src/threads.xml (revision 16296) @@ -617,5 +617,5 @@ - result + result a list of all lisp processes (threads) @@ -673,5 +673,5 @@ - name + name @@ -681,5 +681,5 @@ - persistent + persistent @@ -692,5 +692,5 @@ - priority + priority @@ -702,5 +702,5 @@ - class + class @@ -712,5 +712,5 @@ - initargs + initargs @@ -720,5 +720,5 @@ - stack-size + stack-size @@ -731,5 +731,5 @@ - vstack-size + vstack-size @@ -742,5 +742,5 @@ - tstack-size + tstack-size @@ -752,5 +752,5 @@ - use-standard-initial-bindings + use-standard-initial-bindings @@ -768,13 +768,13 @@ - initial-bindings + initial-bindings - an alist of (symbol . - valueform) pairs, which can be + an alist of (symbol . + valueform) pairs, which can be used to initialize special variable bindings in the new - thread. Each valueform is used to + thread. Each valueform is used to compute the value of a new binding of - symbol in the execution environment of + symbol in the execution environment of the newly-created thread. The default is nil. @@ -782,5 +782,5 @@ - process + process @@ -795,5 +795,5 @@ Creates and returns a new lisp process (thread) with the - specified attributes. process will not begin + specified attributes. process will not begin execution immediately; it will need to be preset (given @@ -804,10 +804,10 @@ before it's able to actually do anything. - If valueform is a function, it is + If valueform is a function, it is called, with no arguments, in the execution environment of the newly-created thread; the primary value it returns is used for - the binding of the corresponding symbol. - - Otherwise, valueform is evaluated in the + the binding of the corresponding symbol. + + Otherwise, valueform is evaluated in the execution environment of the newly-created thread, and the resulting value @@ -847,5 +847,5 @@ - process + process a lisp process (thread). @@ -853,9 +853,9 @@ - result - - T if process had been runnable + result + + T if process had been runnable and is now suspended; NIL otherwise. That is, T if - process's + process's transitioned from 0 to 1. @@ -868,5 +868,5 @@ Description - Suspends process, preventing it from + Suspends process, preventing it from running, and stopping it if it was already running. This is a fairly expensive operation, because it involves a few @@ -879,8 +879,8 @@ call to process-suspend must be reversed by a matching call to - before process is able to run. What + before process is able to run. What process-suspend actually does is increment the of - process. + process. @@ -902,8 +902,8 @@ Notes process-suspend was previously called - process-disable. + process-disable. now names a function for which there is no - obvious inverse, so process-disable + obvious inverse, so process-disable is no longer defined. @@ -933,5 +933,5 @@ - process + process a lisp process (thread). @@ -939,9 +939,9 @@ - result - - T if process had been suspended + result + + T if process had been suspended and is now runnable; NIL otherwise. That is, T if - process's + process's transitioned from to 0. @@ -961,5 +961,5 @@ process-resume actually does is decrement the of - process, to a minimum of 0. + process, to a minimum of 0. @@ -1008,5 +1008,5 @@ - process + process a lisp process (thread). @@ -1014,10 +1014,10 @@ - result + result The number of "outstanding" calls on - process, or NIL if - process has expired. + process, or NIL if + process has expired. @@ -1076,5 +1076,5 @@ - process + process a lisp process (thread). @@ -1082,5 +1082,5 @@ - function + function a function, designated by itself or by a symbol @@ -1090,12 +1090,12 @@ - args + args a list of values, appropriate as arguments to - function. - - - - result + function. + + + + result undefined. @@ -1109,9 +1109,9 @@ Typically used to initialize a newly-created or newly-reset - process, setting things up so that when process + process, setting things up so that when process becomes enabled, it will begin execution by - applying function to args. + applying function to args. process-preset does not enable - process, + process, although a process must be process-preset before it can be enabled. Processes are normally enabled by @@ -1154,5 +1154,5 @@ - process + process a lisp process (thread). @@ -1160,5 +1160,5 @@ - timeout + timeout a time interval in seconds. May be any @@ -1168,5 +1168,5 @@ - result + result undefined. @@ -1179,15 +1179,15 @@ Description - Tries to begin the execution of process. - An error is signaled if process has never + Tries to begin the execution of process. + An error is signaled if process has never been . Otherwise, - process invokes its initial function. + process invokes its initial function. process-enable attempts to - synchronize with process, which is presumed + synchronize with process, which is presumed to be reset or in the act of resetting itself. If this attempt is not successful within the time interval specified by - timeout, a continuable error is signaled, + timeout, a continuable error is signaled, which offers the opportunity to continue waiting. @@ -1237,21 +1237,21 @@ - process-specifier + process-specifier - name | - (&key; name - persistent - priority - class - initargs - stack-size - vstack-size - tstack-size) + name | + (&key; name + persistent + priority + class + initargs + stack-size + vstack-size + tstack-size) - name + name a string, used to identify the process. @@ -1260,14 +1260,14 @@ - function + function a function, designated by itself or by a symbol which names it. Passed to - preset-process. + process-preset. - persistent + persistent @@ -1278,5 +1278,5 @@ - priority + priority @@ -1286,5 +1286,5 @@ - class + class @@ -1295,5 +1295,5 @@ - initargs + initargs @@ -1304,5 +1304,5 @@ - stack-size + stack-size @@ -1313,5 +1313,5 @@ - vstack-size + vstack-size @@ -1322,5 +1322,5 @@ - tstack-size + tstack-size @@ -1331,5 +1331,5 @@ - process + process the newly-created process. @@ -1346,5 +1346,5 @@ presets it via , and enables it via . This means - that process will immediately begin to + that process will immediately begin to execute. process-run-function is @@ -1387,5 +1387,5 @@ - process + process a lisp process (thread). @@ -1393,5 +1393,5 @@ - function + function a function. @@ -1400,16 +1400,16 @@ - args + args a list of values, appropriate as arguments to - function. - - - - result - - the result of applying function - to args if process - is the current-process, otherwise + function. + + + + result + + the result of applying function + to args if process + is the *current-process*, otherwise NIL. @@ -1421,13 +1421,13 @@ Description - Arranges for process - to apply function to args at + Arranges for process + to apply function to args at some point in the near future (interrupting whatever - process - was doing.) If function returns normally, - process resumes + process + was doing.) If function returns normally, + process resumes execution at the point at which it was interrupted. - process must be in an enabled state in + process must be in an enabled state in order to respond to a process-interrupt request. It's @@ -1465,5 +1465,5 @@ Notes - It would probably be better for result + It would probably be better for result to always be NIL, since the present behavior is inconsistent. @@ -1544,5 +1544,5 @@ - process + process a lisp process (thread). @@ -1550,5 +1550,5 @@ - kill-option + kill-option an internal argument, must be nil. @@ -1556,5 +1556,5 @@ - result + result undefined. @@ -1567,5 +1567,5 @@ Description - Causes process to cleanly exit + Causes process to cleanly exit from any ongoing computation and enter a state where it can be . This @@ -1574,5 +1574,5 @@ attempting to handle conditions of this type. - The kill-option argument is for internal + The kill-option argument is for internal use only and should not be specified by user code @@ -1580,5 +1580,5 @@ There is in general no way to know precisely when - process + process has completed the act of resetting or killing itself; a process which has either entered the limbo of the reset state or exited @@ -1628,5 +1628,5 @@ - process + process a lisp process (thread), which @@ -1635,5 +1635,5 @@ - result + result undefined. @@ -1684,5 +1684,5 @@ - process + process a lisp process (thread). @@ -1690,5 +1690,5 @@ - result + result undefined. @@ -1702,5 +1702,5 @@ - Causes process to cleanly exit + Causes process to cleanly exit from any ongoing computation, and then exit. @@ -1741,5 +1741,5 @@ - process + process a lisp process (thread). @@ -1747,5 +1747,5 @@ - condition + condition a lisp condition. The default is NIL. @@ -1759,14 +1759,14 @@ Entirely equivalent to calling - ( process + ( process (lambda () - (abort condition))). - Causes process to transfer control to the + (abort condition))). + Causes process to transfer control to the applicable handler or restart for abort. - If condition is non-NIL, + If condition is non-NIL, process-abort does not consider any handlers which are explicitly bound to conditions other than - condition. + condition. @@ -1848,5 +1848,5 @@ - process + process a lisp process (thread). @@ -1854,8 +1854,8 @@ - whostate + whostate a string which describes the "state" of - process. + process. @@ -1863,6 +1863,6 @@ This information is primarily for the benefit of - debugging tools. whostate is a terse report - on what process is doing, or not doing, + debugging tools. whostate is a terse report + on what process is doing, or not doing, and why. @@ -1871,5 +1871,5 @@ , its process-whostate will be the value - which was passed to that function as whostate. + which was passed to that function as whostate. @@ -1964,5 +1964,5 @@ - whostate + whostate @@ -1973,5 +1973,5 @@ - function + function a function, designated by itself or by a symbol @@ -1981,12 +1981,12 @@ - args + args a list of values, appropriate as arguments to - function. - - - - result + function. + + + + result NIL. @@ -2000,6 +2000,6 @@ Causes the current lisp process (thread) to repeatedly - apply function to - args until the call returns a true result, then + apply function to + args until the call returns a true result, then returns NIL. After each failed call, yields the CPU as if by @@ -2053,5 +2053,5 @@ - whostate + whostate a string, which will be the value of @@ -2061,5 +2061,5 @@ - ticks + ticks either a positive integer expressing a duration @@ -2069,5 +2069,5 @@ - function + function a function, designated by itself or by a symbol @@ -2076,17 +2076,17 @@ - args + args a list of values, appropriate as arguments to - function. - - - - result + function. + + + + result T if process-wait-with-timeout - returned because its function returned + returned because its function returned true, or NIL if it returned because the duration - ticks has been exceeded. + ticks has been exceeded. @@ -2097,11 +2097,11 @@ Description - If ticks is NIL, behaves exactly like + If ticks is NIL, behaves exactly like , except for returning T. - Otherwise, function will be tested repeatedly, + Otherwise, function will be tested repeatedly, in the same kind of test/yield loop as in - until either function returns true, - or the duration ticks has been exceeded. + until either function returns true, + or the duration ticks has been exceeded. @@ -2152,5 +2152,5 @@ - body + body an implicit progn. @@ -2158,8 +2158,8 @@ - result + result the primary value returned by - body. + body. @@ -2170,5 +2170,5 @@ Description - Executes body + Executes body in an environment in which requests are @@ -2214,5 +2214,5 @@ - body + body an implicit progn. @@ -2220,8 +2220,8 @@ - result + result the primary value returned by - body. + body. @@ -2232,5 +2232,5 @@ Description - Executes body + Executes body in an environment in which requests have immediate effect. @@ -2261,15 +2261,15 @@ - name + name any lisp object; saved as part of - lock. Typically a string or symbol + lock. Typically a string or symbol which may appear in the s - of threads which are waiting for lock. + of threads which are waiting for lock. - lock + lock a newly-allocated object of type CCL:LOCK. @@ -2284,5 +2284,5 @@ Creates and returns a lock object, which can be used to synchronize access to some shared resource. - lock is + lock is initially in a "free" state; a lock can also be "owned" by a @@ -2329,5 +2329,5 @@ - lock + lock an object of type CCL:LOCK. @@ -2335,5 +2335,5 @@ - body + body an implicit progn. @@ -2341,8 +2341,8 @@ - result + result the primary value returned by - body. + body. @@ -2353,10 +2353,10 @@ Description - Waits until lock is either free or + Waits until lock is either free or owned by the calling - thread, then executes body with the - lock owned by the calling thread. If lock + thread, then executes body with the + lock owned by the calling thread. If lock was free when with-lock-grabbed was called, - it is restored to a free state after body + it is restored to a free state after body is executed. @@ -2400,5 +2400,5 @@ - lock + lock an object of type CCL:LOCK. @@ -2411,5 +2411,5 @@ Description - Blocks until lock is owned by the + Blocks until lock is owned by the calling thread. @@ -2458,5 +2458,5 @@ - lock + lock an object of type CCL:LOCK. @@ -2470,11 +2470,11 @@ Signals an error of type CCL:LOCK-NOT-OWNER if - lock + lock is not already owned by the calling thread; otherwise, undoes the effect of one previous . If this means that release-lock has now been called on - lock the same number of times as - has, lock + lock the same number of times as + has, lock becomes free. @@ -2518,5 +2518,5 @@ - lock + lock an object of type CCL:LOCK. @@ -2524,7 +2524,7 @@ - result - - T if lock has been obtained, + result + + T if lock has been obtained, or NIL if it has not. @@ -2536,7 +2536,7 @@ Description - Tests whether lock + Tests whether lock can be obtained without blocking - that is, either - lock is already free, or it is already owned + lock is already free, or it is already owned by . If it can, causes it to @@ -2586,5 +2586,5 @@ - read-write-lock + read-write-lock a newly-allocated object of type @@ -2603,5 +2603,5 @@ belong to at most one process which acts as a "writer". A read-write lock may never be held by a reader at the same time as - a writer. Initially, read-write-lock has + a writer. Initially, read-write-lock has no readers and no writers. @@ -2653,5 +2653,5 @@ - read-write-lock + read-write-lock an object of type @@ -2660,5 +2660,5 @@ - body + body an implicit progn. @@ -2666,8 +2666,8 @@ - result + result the primary value returned by - body. + body. @@ -2678,13 +2678,13 @@ Description - Waits until read-write-lock has no + Waits until read-write-lock has no writer, ensures that is a - reader of it, then executes body. + reader of it, then executes body. - After executing body, if + After executing body, if was not a reader of - read-write-lock before + read-write-lock before with-read-lock was called, the lock is released. If it was already a reader, it remains one. @@ -2728,5 +2728,5 @@ - read-write-lock + read-write-lock an object of type @@ -2735,5 +2735,5 @@ - body + body an implicit progn. @@ -2741,8 +2741,8 @@ - result + result the primary value returned by - body. + body. @@ -2753,13 +2753,13 @@ Description - Waits until read-write-lock has no + Waits until read-write-lock has no readers and no writer other than , then ensures that is the - writer of it. With the lock held, executes body. + writer of it. With the lock held, executes body. - After executing body, if + After executing body, if was not the writer of - read-write-lock before + read-write-lock before with-write-lock was called, the lock is released. If it was already the writer, it remains the @@ -2804,5 +2804,5 @@ - semaphore + semaphore a newly-allocated object of type CCL:SEMAPHORE. @@ -2819,5 +2819,5 @@ and decremented atomically; incrementing it represents sending a signal, and decrementing it represents handling that signal. - semaphore has an initial count of 0. + semaphore has an initial count of 0. @@ -2860,5 +2860,5 @@ - semaphore + semaphore an object of type CCL:SEMAPHORE. @@ -2866,5 +2866,5 @@ - result + result an integer representing an error identifier @@ -2878,5 +2878,5 @@ Description - Atomically increments semaphore's + Atomically increments semaphore's "count" by 1; this may enable a waiting thread to resume execution. @@ -2901,5 +2901,5 @@ Notes - result should probably be interpreted + result should probably be interpreted and acted on by signal-semaphore, because it is not likely to be meaningful to a lisp program, and the @@ -2930,5 +2930,5 @@ - semaphore + semaphore an object of type CCL:SEMAPHORE. @@ -2936,5 +2936,5 @@ - result + result an integer representing an error identifier @@ -2948,5 +2948,5 @@ Description - Waits until semaphore + Waits until semaphore has a positive count that can be atomically decremented; this will succeed exactly once for each @@ -2972,5 +2972,5 @@ Notes - result should probably be interpreted + result should probably be interpreted and acted on by wait-on-semaphore, because it is not likely to be meaningful to a lisp program, and the @@ -3002,5 +3002,5 @@ - semaphore + semaphore An object of type CCL:SEMAPHORE. @@ -3008,5 +3008,5 @@ - timeout + timeout a time interval in seconds. May be any @@ -3016,10 +3016,10 @@ - result + result T if timed-wait-on-semaphore returned because it was able to decrement the count of - semaphore; NIL if it returned because - the duration timeout has been + semaphore; NIL if it returned because + the duration timeout has been exceeded. @@ -3031,8 +3031,8 @@ Description - Waits until semaphore + Waits until semaphore has a positive count that can be atomically decremented, or until the duration - timeout has + timeout has elapsed. @@ -3075,5 +3075,5 @@ - fd + fd a file descriptor, which is a non-negative integer @@ -3083,5 +3083,5 @@ - timeout + timeout either NIL or a time interval in milliseconds. Must be a non-negative integer. The default is NIL. @@ -3094,5 +3094,5 @@ Description - Wait until input is available on fd. + Wait until input is available on fd. This uses the select() system call, and is generally a fairly @@ -3100,5 +3100,5 @@ accurately, process-input-wait waits until it's possible to read - from fd without blocking, or until timeout, if + from fd without blocking, or until timeout, if it is not NIL, has been exceeded. @@ -3155,5 +3155,5 @@ - fd + fd a file descriptor, which is a non-negative integer @@ -3163,5 +3163,5 @@ - timeout + timeout either NIL or a time interval in milliseconds. Must be a non-negative integer. The default is NIL. @@ -3174,5 +3174,5 @@ Description - Wait until output is possible on fd or until timeout, if + Wait until output is possible on fd or until timeout, if it is not NIL, has been exceeded. This uses the select() system call, and is @@ -3232,5 +3232,5 @@ - body + body an implicit progn. @@ -3238,8 +3238,8 @@ - result + result the primary value returned by - body. + body. @@ -3252,5 +3252,5 @@ Requests exclusive read access to the standard terminal stream, *terminal-io*. Executes - body in an environment with that access. + body in an environment with that access. @@ -3345,5 +3345,5 @@ - p + p a lisp process (thread), designated either by @@ -3365,5 +3365,5 @@ The command yields control of terminal input to the - process p, which must have used + process p, which must have used to request access to the terminal input stream. @@ -3409,5 +3409,5 @@ - process + process a process, typically created by - default + default A default value to be returned if the specified @@ -3424,5 +3424,5 @@ - values + values The values returned by the specified process's Index: /trunk/source/doc/src/using.xml =================================================================== --- /trunk/source/doc/src/using.xml (revision 16295) +++ /trunk/source/doc/src/using.xml (revision 16296) @@ -32,18 +32,19 @@ &CCL;'s tracing facility is invoked by an extended version of the Common Lisp - trace macro. Extensions allow tracing of methods, as well as finer control + trace macro. Extensions allow tracing of methods, as well as finer control over tracing actions. - - - TRACE {keyword - global-value}* {spec | - (spec {keyword - local-value}*)}* [Macro] - - - - The trace macro encapsulates the functions named by + trace + TRACEMacro + TRACE {keyword + global-value}* {spec | + (spec {keyword + local-value}*)}* + + Description + + + The trace macro encapsulates the functions named by specs, causing trace actions to take place on entry and exit from each function. The default actions print a message on function entry and @@ -53,14 +54,14 @@ - Invoking (trace) without arguments returns a list of functions being traced. + Invoking (trace) without arguments returns a list of functions being traced. A spec is either a symbol that is the name of a function, or an - expression of the form (setf symbol), or a - specific method of a generic function in the form (:method + expression of the form (setf symbol), or a + specific method of a generic function in the form (:method gf-name {qualifier}* - ({specializer}*)), where a - specializer can be the name of a class or an EQL + ({specializer}*)), where a + specializer can be the name of a class or an EQL specializer. @@ -68,5 +69,5 @@ A spec can also be a string naming a package, or equivalently a - list (:package package-name), in order to + list (:package package-name), in order to request that all functions in the package to be traced. @@ -85,5 +86,5 @@ - :methods {T | nil} + :methods {T | nil} If true, and if applied to a spec naming a generic @@ -95,6 +96,6 @@ - :inside outside-spec - | ({outside-spec}*) + :inside outside-spec + | ({outside-spec}*) Inhibits all trace actions unless the current @@ -109,12 +110,12 @@ - :if form - :condition form + :if form + :condition form Evaluates form whenever the function being traced is about to be entered, and inhibits all trace actions if form - returns nil. The form may reference the lexical variable ccl::args, - which is a list of the arguments in this call. :condition is just a - synonym for :if, though if both are specified, both must return non-nil. + returns nil. The form may reference the lexical variable ccl::args, + which is a list of the arguments in this call. :condition is just a + synonym for :if, though if both are specified, both must return non-nil. @@ -122,11 +123,11 @@ - :before-if form + :before-if form Evaluates form whenever the function being traced is about to be entered, and inhibits the entry trace actions if form returns nil. The form may reference the lexical variable - ccl::args, which is a list of the arguments in this call. If both - :if and :before-if are specified, both must return + ccl::args, which is a list of the arguments in this call. If both + :if and :before-if are specified, both must return non-nil in order for the before entry actions to happen. @@ -135,11 +136,11 @@ - :after-if form + :after-if form Evaluates form whenever the function being traced has just exited, and inhibits the exit trace actions if form - returns nil. The form may reference the lexical variable ccl::vals, - which is a list of values returned by this call. If both :if and - :after-if are specified, both must return non-nil in order for the + returns nil. The form may reference the lexical variable ccl::vals, + which is a list of values returned by this call. If both :if and + :after-if are specified, both must return non-nil in order for the after exit actions to happen. @@ -148,11 +149,11 @@ - :print-before form + :print-before form Evaluates form whenever the function being traced is about to be entered, and prints the result before printing the standard entry message. - The form may reference the lexical variable ccl::args, which is a list - of the arguments in this call. To see multiple forms, use values: - :print-before (values (one-thing) (another-thing)). + The form may reference the lexical variable ccl::args, which is a list + of the arguments in this call. To see multiple forms, use values: + :print-before (values (one-thing) (another-thing)). @@ -160,11 +161,11 @@ - :print-after form + :print-after form Evaluates form whenever the function being traced has just exited, and prints the result after printing the standard exit message. The form may - reference the lexical variable ccl::vals, which is a list of values - returned by this call. To see multiple forms, use values: - :print-after (values (one-thing) (another-thing)). + reference the lexical variable ccl::vals, which is a list of values + returned by this call. To see multiple forms, use values: + :print-after (values (one-thing) (another-thing)). @@ -172,7 +173,7 @@ - :print form + :print form - Equivalent to :print-before form :print-after form. + Equivalent to :print-before form :print-after form. @@ -180,9 +181,9 @@ - :eval-before form + :eval-before form Evaluates form whenever the function being traced is about to be entered. The form may reference the lexical variable - ccl::args, which is a list of the arguments in this call. + ccl::args, which is a list of the arguments in this call. @@ -190,8 +191,8 @@ - :eval-after form + :eval-after form Evaluates form whenever the function being has just - exited. The form may reference the lexical variable ccl::vals, which + exited. The form may reference the lexical variable ccl::vals, which is a list of values returned by this call. @@ -200,8 +201,8 @@ - :eval form + :eval form - Equivalent to :eval-before form - :eval-after form. + Equivalent to :eval-before form + :eval-after form. @@ -209,9 +210,9 @@ - :break-before form + :break-before form Evaluates form whenever the function being traced is about to be entered, and if the result is non-nil, enters a debugger break loop. The form - may reference the lexical variable ccl::args, which is a list of the + may reference the lexical variable ccl::args, which is a list of the arguments in this call. @@ -220,9 +221,9 @@ - :break-after form + :break-after form Evaluates form whenever the function being traced has just exited, and if the result is non-nil, enters a debugger break loop. The form may - reference the lexical variable ccl::vals, which is a list of values + reference the lexical variable ccl::vals, which is a list of values returned by this call. @@ -231,7 +232,7 @@ - :break form + :break form - Equivalent to :break-before form :break-after form. + Equivalent to :break-before form :break-after form. @@ -239,10 +240,10 @@ - :backtrace-before form - :backtrace form + :backtrace-before form + :backtrace form Evaluates form whenever the function being traced is about to be entered. The form may reference the lexical variable - ccl::args, which is a list of the arguments in this call. The value + ccl::args, which is a list of the arguments in this call. The value returned by form is intepreted as follows: @@ -251,10 +252,10 @@ - nil + nil does nothing - :detailed + :detailed prints a detailed backtrace to *trace-output*. @@ -262,5 +263,5 @@ - (:detailed integer) + (:detailed integer) prints the top integer frames of detailed backtrace to *trace-output*. @@ -282,6 +283,6 @@ - Note that unlike with the other options, :backtrace is equivalent to - :backtrace-before only, not both before and after, since it's usually + Note that unlike with the other options, :backtrace is equivalent to + :backtrace-before only, not both before and after, since it's usually not helpful to print the same backtrace both before and after the function call. @@ -290,8 +291,8 @@ - :backtrace-after form + :backtrace-after form Evaluates form whenever the function being traced has - just exited. The form may reference the lexical variable ccl::vals, + just exited. The form may reference the lexical variable ccl::vals, which is a list of values returned by this call. The value returned by form is intepreted as follows: @@ -301,10 +302,10 @@ - nil + nil does nothing - :detailed + :detailed prints a detailed backtrace to *trace-output*. @@ -312,5 +313,5 @@ - (:detailed integer) + (:detailed integer) prints the top integer frames of detailed backtrace to *trace-output*. @@ -335,5 +336,5 @@ - :before action + :before action specifies the action to be taken just before the traced function is entered. action is one of: @@ -341,5 +342,5 @@ - :print + :print The default, prints a short indented message showing the function name and the invocation arguments @@ -348,14 +349,14 @@ - :break + :break - Equivalent to :before :print :break-before t + Equivalent to :before :print :break-before t - :backtrace + :backtrace - Equivalent to :before :print :backtrace-before t + Equivalent to :before :print :backtrace-before t @@ -380,5 +381,5 @@ - :after action + :after action @@ -387,5 +388,5 @@ - :print + :print The default, prints a short indented message showing the function name and the @@ -395,14 +396,14 @@ - :break + :break - Equivalent to :after :print :break-after t + Equivalent to :after :print :break-after t - :backtrace + :backtrace - Equivalent to :after :print :backtrace-after t + Equivalent to :after :print :backtrace-after t @@ -426,58 +427,78 @@ - - - - - CCL:*TRACE-LEVEL* [Variable] - + + + + *trace-level* + *TRACE-LEVEL*Variable + CCL:*TRACE-LEVEL* + Description 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] - + + + + *trace-max-indent* + *TRACE-MAX-INDENT*Variable + CCL:*TRACE-MAX-INDENT* + Description 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] - - + + + + + trace-function + TRACE-FUNCTIONFunction + CCL:TRACE-FUNCTION spec &key; {keyword value}* + Description + This is a functional version of the TRACE macro. spec and keywords are as for TRACE, except that all arguments are evaluated. - - - - CCL:*TRACE-PRINT-LEVEL* [Variable] - + + + + + *trace-print-level* + *TRACE-PRINT-LEVEL*Variable + CCL:*TRACE-PRINT-LEVEL* + Description The default print actions bind CL:*PRINT-LEVEL* to this value while printing. Note that this rebinding is only in effect during the default entry and exit messages. - It does not apply to printing of :print-before/:print-after forms or any + It does not apply to printing of :print-before/:print-after forms or any explicit printing done by user code. - - - CCL:*TRACE-PRINT-LENGTH* [Variable] - + + + + + *trace-print-length* + *TRACE-PRINT-LENGTH*Variable + CCL:*TRACE-PRINT-LENGTH* + Description The default print actions bind CL:*PRINT-LENGTH* to this value while printing. Note that this rebinding is only in effect during the default entry and exit messages. - It does not apply to printing of :print-before/:print-after forms or any + It does not apply to printing of :print-before/:print-after forms or any explicit printing done by user code. - - - CCL:*TRACE-BAR-FREQUENCY* [Variable] - + + + + *trace-bar-frequency* + *TRACE-BAR-FREQUENCY*Variable + CCL:*TRACE-BAR-FREQUENCY* + Description By default, this is nil. If non-nil it should be a integer, and the default entry and exit messages will print a | instead of space every this many levels of indentation. + + + + @@ -513,6 +534,6 @@ Add a piece of advice to the function or method specified by - spec according to - form. + spec according to + form. Macro @@ -527,5 +548,5 @@ - spec + spec @@ -540,5 +561,5 @@ - form + form @@ -552,5 +573,5 @@ - name + name @@ -560,5 +581,5 @@ - when + when @@ -614,6 +635,6 @@ UNADVISE - Remove the piece or pieces of advice matching spec, - when, and name. + Remove the piece or pieces of advice matching spec, + when, and name. Macro @@ -655,6 +676,6 @@ ADVISEDP - Return a list of the pieces of advice matching spec, - when, and name. + Return a list of the pieces of advice matching spec, + when, and name. Macro @@ -688,9 +709,9 @@ Directory - &CCL;'s DIRECTORY function accepts the following + &CCL;'s DIRECTORY function accepts the following implementation-dependent keyword arguments: - :files boolean + :files boolean If true, includes regular (non-directory) files in DIRECTORY's output. Defaults to T. @@ -698,5 +719,5 @@ - :directories boolean + :directories boolean If true, includes directories in DIRECTORY's output. Defaults to NIL. @@ -704,5 +725,5 @@ - :all boolean + :all boolean If true, includes files and directories whose names start with a dot character in DIRECTORY's output. (Entries whose name is "." or ".." are never included.) Defaults to T. @@ -710,5 +731,5 @@ - :follow-links boolean + :follow-links boolean If true, includes the TRUENAMEs of symbolic or hard links in DIRECTORY's output; if false, includes the link filenames without attempting to resolve them. Defaults to T. @@ -889,5 +910,5 @@ - domain + domain This is used to indicate where the external @@ -905,5 +926,5 @@ - character-encoding + character-encoding A keyword that specifies the character encoding @@ -924,5 +945,5 @@ - line-termination + line-termination A keyword that indicates a line termination @@ -934,5 +955,5 @@ - external-format + external-format An external-format object as described above. @@ -1448,7 +1469,7 @@ Returns the number of characters that would be produced by - decoding vector (or the subsequence thereof - delimited by start and end) - according to external-format. + decoding vector (or the subsequence thereof + delimited by start and end) + according to external-format. @@ -1481,23 +1502,23 @@ Description - Decodes the octets in vector (or the subsequence - of it delimited by start and - end) into a string according - to external-format. + Decodes the octets in vector (or the subsequence + of it delimited by start and + end) into a string according + to external-format. - If string is supplied, output will be written into it. - It must be large enough to hold the decoded characters. If - string is not supplied, a new string will be allocated to + If string is supplied, output will be written into it. + It must be large enough to hold the decoded characters. If + string is not supplied, a new string will be allocated to hold the decoded characters. Returns, as multiple values, the decoded string and the position in - vector where the decoding ended. + vector where the decoding ended. - Sequences of octets in vector that cannot be + Sequences of octets in vector that cannot be decoded into characters according to - external-format will be decoded as + external-format will be decoded as #\Replacement_Character. @@ -1533,16 +1554,16 @@ Description - Encodes string (or the substring delimited by - start and end) - into external-format and returns, as multiple + Encodes string (or the substring delimited by + start and end) + into external-format and returns, as multiple values, a vector of octets containing the encoded data and an integer that specifies the offset into the vector where the encoded data ends. - When use-byte-order-mark is true, a byte-order mark + When use-byte-order-mark is true, a byte-order mark will be included in the encoded data. - If vector is supplied, output will be written + If vector is supplied, output will be written to it. It must be of type (simple-array (unsigned-byte 8)) and be large enough to hold the encoded data. If it is not supplied, the function @@ -1550,10 +1571,10 @@ - If vector-offset is supplied, data will be written + If vector-offset is supplied, data will be written into the output vector starting at that offset. - Characters in string that cannot be encoded - into external-format will be replaced with an + Characters in string that cannot be encoded + into external-format will be replaced with an encoding-dependent replacement character (#\Replacement_Character or #\Sub) before being encoded and written @@ -1590,10 +1611,10 @@ Returns the number of octets required to encode - string (or the substring delimited by - start and end) into - external-format. + string (or the substring delimited by + start and end) into + external-format. - When use-byte-order-mark is true, the returned + When use-byte-order-mark is true, the returned size will include space for a byte-order marker. @@ -1626,14 +1647,13 @@ &CCL; sets up logical pathname translations for logical hosts: ccl and home - CCL Logical Host - The CCL logical host should point to the - ccl directory. It is used for a variety of + The CCL logical host should point to the + ccl directory. It is used for a variety of purposes by &CCL; including: locating &CCL; source code, require and provide, accessing foreign function information, and the &CCL; build process. It is set to the value of the environment variable - CCL_DEFAULT_DIRECTORY, which is set by the + CCL_DEFAULT_DIRECTORY, which is set by the openmcl shell script . If - CCL_DEFAULT_DIRECTORY is not set, then it is set + CCL_DEFAULT_DIRECTORY is not set, then it is set to the directory containing the current heap image. @@ -1703,5 +1723,5 @@ - For example, suppose that p is a pathname made + For example, suppose that p is a pathname made by (make-pathname :name "a.b" :type "c"). Then, (native-translated-namestring p) evaluates @@ -1731,6 +1751,6 @@ Description - Executes forms in an environemt in which each - var is bound to a stack-allocated foreign + Executes forms in an environemt in which each + var is bound to a stack-allocated foreign pointer which refers to a C-style string suitable for passing to foreign code which expects a filename argument. @@ -1766,6 +1786,6 @@ Pathname strings are treated as null-terminated strings coded in the encoding named by the value returned by the function - CCL:PATHNAME-ENCODING-NAME. This value may be changed - with SETF. + CCL:PATHNAME-ENCODING-NAME. This value may be changed + with SETF. @@ -1794,6 +1814,6 @@ &CCL; provides the - functions CCL:MAP-FILE-TO-IVECTOR - and CCL:MAP-FILE-TO-OCTET-VECTOR to support + functions CCL:MAP-FILE-TO-IVECTOR + and CCL:MAP-FILE-TO-OCTET-VECTOR to support memory-mapping. These functions return vectors whose contents are the contents of memory-mapped files. Reading an element of such a @@ -1819,31 +1839,29 @@ directly, without copying them into memory first. - The vectors returned by CCL:MAP-FILE-TO-IVECTOR - and CCL:MAP-FILE-TO-OCTET-VECTOR are read-only; any + The vectors returned by CCL:MAP-FILE-TO-IVECTOR + and CCL:MAP-FILE-TO-OCTET-VECTOR are read-only; any attempt to change an element of a vector returned by these functions results in a memory-access error. &CCL; does not currently support writing data to memory-mapped files. - Vectors created by CCL:MAP-FILE-TO-IVECTOR - and CCL:MAP-FILE-TO-OCTET-VECTOR are required to + Vectors created by CCL:MAP-FILE-TO-IVECTOR + and CCL:MAP-FILE-TO-OCTET-VECTOR are required to respect &CCL;'s limit on the total size of an array. That means that you cannot use these functions to create a vector longer than ARRAY-TOTAL-SIZE-LIMIT, even if the filesystem supports file sizes that are larger. The value - of ARRAY-TOTAL-SIZE-LIMIT is (EXPT 2 24) - on 32-but platforms; and (EXPT 2 56) on 64-bit + of ARRAY-TOTAL-SIZE-LIMIT is (EXPT 2 24) + on 32-but platforms; and (EXPT 2 56) on 64-bit platforms. - - - CCL:MAP-FILE-TO-IVECTOR - pathname - element-type - [Function] - + + map-file-to-ivector + MAP-FILE-TO-IVECTORFunction + CCL:MAP-FILE-TO-IVECTOR pathname element-type + Description - pathname + pathname The pathname of the file to be memory-mapped. @@ -1852,11 +1870,11 @@ - element-type + element-type The element-type of the vector to be created. Specified as a type-specifier - that names a subtype of either SIGNED-BYTE - or UNSIGNED-BYTE. + that names a subtype of either SIGNED-BYTE + or UNSIGNED-BYTE. @@ -1865,5 +1883,5 @@ - The map-file-to-ivector function tries to + The map-file-to-ivector function tries to open the file at pathname for reading. If successful, the function maps the file's contents to a range of @@ -1876,7 +1894,7 @@ The returned vector is a displaced-array - whose element-type is (UPGRADED-ARRAY-ELEMENT-TYPE - element-type). The target of the displaced array is a - vector of type (SIMPLE-ARRAY element-type (*)) whose + whose element-type is (UPGRADED-ARRAY-ELEMENT-TYPE + element-type). The target of the displaced array is a + vector of type (SIMPLE-ARRAY element-type (*)) whose elements are the contents of the memory-mapped file. @@ -1884,9 +1902,9 @@ start a few bytes (4 bytes on 32-bit platforms, 8 bytes on 64-bit platforms) into the vector. The displaced array returned - by CCL:MAP-FILE-TO-IVECTOR hides this overhead, but + by CCL:MAP-FILE-TO-IVECTOR hides this overhead, but it's usually more efficient to operate on the underlying simple 1-dimensional array. Given a displaced array (like the value - returned by CCL:MAP-FILE-TO-IVECTOR), the function - ARRAY-DISPLACEMENT returns the underlying array and + returned by CCL:MAP-FILE-TO-IVECTOR), the function + ARRAY-DISPLACEMENT returns the underlying array and the displacement index in elements. @@ -1894,42 +1912,51 @@ Currently, &CCL; supports only read operations on memory-mapped files. If you try to change the contents of an array - returned by map-file-to-ivector, &CCL; signals + returned by map-file-to-ivector, &CCL; signals a memory error. - - - CCL:UNMAP-IVECTOR - displaced-array - [Function] - + + + + unmap-ivector + UNMAP-IVECTORFunction + CCL:UNMAP-IVECTOR displaced-array + + Description If the argument is a displaced-array returned - by map-file-to-ivector, and if it has not yet + by map-file-to-ivector, and if it has not yet been unmapped by this function, - then unmap-ivector undoes the memory mapping, + then unmap-ivector undoes the memory mapping, closes the mapped file, and changes the displaced-array so that its target is an empty vector (of length zero). - - - CCL:MAP-FILE-TO-OCTET-VECTOR - pathname - [Function] - - - This function is a synonym for (CCL:MAP-FILE-TO-IVECTOR - pathname '(UNSIGNED-BYTE 8)) It is provided as a convenience + + + + map-file-to-octet-vector + MAP-FILE-TO-OCTET-VECTORFunction + CCL:MAP-FILE-TO-OCTET-VECTOR displaced-array + + Description + + This function is a synonym for (CCL:MAP-FILE-TO-IVECTOR + pathname '(UNSIGNED-BYTE 8)) It is provided as a convenience for the common case of memory-mapping a file as a vector of bytes. - - - CCL:UNMAP-OCTET-VECTOR - displaced-array - [Function] - + + + + unmap-octet-vector + UNMAP-OCTET-VECTORFunction + CCL:UNMAP-OCTET-VECTOR displaced-array + + Description This function is a synonym - for (CCL:UNMAP-IVECTOR) + for CCL:UNMAP-IVECTOR + + + @@ -1946,6 +1973,6 @@ Attempting to dynamically rebind a static variable (for - instance, by using LET, or using the variable name as - a parameter in a LAMBDA form) signals an + instance, by using LET, or using the variable name as + a parameter in a LAMBDA form) signals an error. Static variables are shared global resources; a dynamic binding is private to a single thread. @@ -1964,17 +1991,17 @@ static. - - - DEFSTATIC - var + + defstatic + DEFSTATICMacro + DEFSTATIC var value &key; doc-string - [Macro] - - + + Description + - var + var The name of the new static variable. @@ -1983,5 +2010,5 @@ - value + value The initial value of the new static variable. @@ -1990,5 +2017,5 @@ - doc-string + doc-string A documentation string that is assigned to the new @@ -2001,9 +2028,13 @@ variable special, assigns the variable the supplied value, and assigns - the doc-string to the - variable's VARIABLE documentation. Marks the + the doc-string to the + variable's VARIABLE documentation. Marks the variable static, preventing any attempt to dynamically rebind - it. Any attempt to dynamically rebind var + it. Any attempt to dynamically rebind var signals an error. + + + + @@ -2120,8 +2151,11 @@ or ccl64 script. - - - SAVE-APPLICATION - filename + + + + + save-application + SAVE-APPLICATIONFunction + SAVE-APPLICATION filename &key; toplevel-function @@ -2135,10 +2169,10 @@ prepend-kernel native - [Function] - + + Description - filename + filename The pathname of the file to be created when &CCL; @@ -2148,5 +2182,5 @@ - toplevel-function + toplevel-function The function to be executed after startup is @@ -2162,5 +2196,5 @@ - init-file + init-file The pathname of a Lisp file to be loaded when the @@ -2172,5 +2206,5 @@ - error-handler + error-handler The error-handling mode for the saved image. The @@ -2188,5 +2222,5 @@ - application-class + application-class The CLOS class that represents the saved Lisp @@ -2201,5 +2235,5 @@ - clear-clos-caches + clear-clos-caches If true, ensures that CLOS caches are emptied before @@ -2211,5 +2245,5 @@ - purify + purify @@ -2224,5 +2258,5 @@ - impurify + impurify @@ -2241,5 +2275,5 @@ - mode + mode @@ -2250,5 +2284,5 @@ - prepend-kernel + prepend-kernel Specifies the file to prepend to the saved heap @@ -2271,5 +2305,5 @@ - native + native If true, saves the image as a native (ELF, Mach-O, PE) @@ -2282,4 +2316,7 @@ + + + @@ -2312,5 +2349,5 @@ - out-file + out-file @@ -2320,5 +2357,5 @@ - fasl-files + fasl-files @@ -2328,5 +2365,5 @@ - :if-exists + if-exists @@ -2375,6 +2412,6 @@ default, threads start up with overflow, division-by-zero, and invalid enabled, and the rounding mode is set to nearest. The - functions SET-FPU-MODE and - GET-FPU-MODE provide user control over + functions SET-FPU-MODE and + GET-FPU-MODE provide user control over floating-point behavior. @@ -2402,5 +2439,5 @@ - mode + mode @@ -2416,5 +2453,5 @@ Description - If mode is supplied, returns the value of + If mode is supplied, returns the value of the corresponding control flag for the current thread. @@ -2471,5 +2508,5 @@ - rounding-mode + rounding-mode @@ -2480,5 +2517,5 @@ - overflow, underflow, division-by-zero, invalid, inexact + overflow, underflow, division-by-zero, invalid, inexact NIL to mask the exception, T to signal it. @@ -2530,5 +2567,5 @@ - object + object @@ -3022,5 +3059,5 @@ - output-file + output-file @@ -3031,9 +3068,9 @@ - html + html If non-nil (the default), this will generate an HTML report, consisting of - an index file in output-file and, in the same directory, + an index file in output-file and, in the same directory, one html file for each instrumented source file that has been loaded in the current session. @@ -3042,5 +3079,5 @@ - tags + tags @@ -3052,5 +3089,5 @@ - external-format + external-format @@ -3060,5 +3097,5 @@ - statistics + statistics @@ -3066,5 +3103,5 @@ generated with the summary of statistics. You can specify a filename for the statistics argument, otherwise - "statistics.csv" is created in the directory of output-file. + "statistics.csv" is created in the directory of output-file. See documentation of coverage-statistics below for a description of the values in the statistics file. @@ -3352,5 +3389,5 @@ Returns a sequence of ccl:coverage-statistics objects, one for each source file, containing the same information as that written to - the statistics file by ccl:report-coverage. The following + the statistics file by ccl:report-coverage. The following accessors are defined for ccl:coverage-statistics objects: @@ -3510,5 +3547,5 @@ coverage uses an abbreviated format and is missing some of the information in a full snapshot, and therefore cannot be passed to - functions documented to accept a snapshot, only to functions + functions documented to accept a snapshot, only to functions specifically documented to accept incremental coverage deltas. @@ -3537,5 +3574,5 @@ - collection + collection @@ -3546,5 +3583,5 @@ - sources + sources @@ -3595,5 +3632,5 @@ - collection + collection @@ -3604,5 +3641,5 @@ - directory + directory @@ -3612,5 +3649,5 @@ - revision + revision