- + 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]
- + CCL:*TRACE-PRINT-LEVEL* [Variable]
@@ -3281,5 +3310,5 @@ explicit printing done by user code.- + CCL:*TRACE-PRINT-LENGTH* [Variable]
@@ -3289,5 +3318,5 @@ explicit printing done by user code.- + CCL:*TRACE-BAR-FREQUENCY* [Variable]
@@ -3413,5 +3442,5 @@domain---This is used to indicate where the external @@ -3447,5 +3476,5 @@
Despite the function's name, it doesn't necessarily create a @@ -3615,5 +3644,5 @@
@@ -3631,5 +3660,5 @@ @@ -3659,5 +3688,5 @@ @@ -3681,5 +3710,5 @@@@ -4177,5 +4206,5 @@
@@ -4220,5 +4249,5 @@
@@ -4266,5 +4295,5 @@
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
@@ -4420,5 +4449,5 @@
platforms.
-
+
CCL:MAP-FILE-TO-IVECTOR
pathname
@@ -4480,5 +4509,5 @@
a memory error.
-
+
CCL:UNMAP-IVECTOR
displaced-array
@@ -4492,5 +4521,5 @@
target is an empty vector (of length zero).
-
+
CCL:MAP-FILE-TO-OCTET-VECTOR
pathname
@@ -4502,5 +4531,5 @@
bytes.
-
+
CCL:UNMAP-OCTET-VECTOR
displaced-array
@@ -4541,5 +4570,5 @@
static.
Clozure CL provides the
function CCL:SAVE-APPLICATION, which creates a file
@@ -4675,5 +4704,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.
opencml64 script.
-
+
SAVE-APPLICATION
@@ -4870,5 +4899,5 @@
@@ -4928,5 +4957,5 @@
@@ -5102,5 +5131,5 @@
+ In Clozure CL 1.4 and later, code coverage provides information
+ about which paths through generated code have been executed and
+ which haven't. For each source form, it can report one of three
+ possible outcomes:
+
+ Not covered: this form was never entered.
+
+ Partly covered: This form was entered, and some parts were
+ executed and some weren't.
+
+ Fully covered: Every bit of code generated from this form was
+ executed.
+
+ While the information gathered for coverage of generated code is
+ complete and precise, the mapping back to source forms is of
+ necessity heuristic, and depends a great deal on the behavior of
+ macros and the path of the source forms through compiler
+ transforms. Source information is not recorded for variables, which
+ further limits the source mapping. In practice, there is often
+ enough information scattered about a partially covered function to
+ figure out which logical path through the code was taken and which
+ wasn't. If that doesn't work, you can try disassembling to see which
+ parts of the compiled code were not executed: in the disassembled
+ code there will be references to #<CODE-NOTE [xxx] ...> where xxx
+ is NIL if the code that follows was never executed and non-NIL if it
+ was.
+
+ Sometimes the situation can be improved by modifying macros to try
+ to preserve more of the input forms, rather than destructuring and
+ rebuilding them.
+
+ Because the code coverage information is associated with compiled
+ functions, load-time toplevel expressions do not get reported
+ on. You can work around this by creating a function and calling
+ it. I.e. instead of
+
+ do:
+
+Then you can see the coverage information in the definition of
+init-this-and-that.
+
+ In order to gather code coverage information, you first have to
+ recompile all your code to include code coverage
+ instrumentation. Compiling files will generate code coverage
+ instrumentation if
+
+ The compilation process will be many times slower than normal, and
+ the fasl files will be many times bigger.
+
+ When you execute function loaded from instrumented fasl files, they
+ will record coverage information every time they are executed. The
+ system keeps track of which instrumented files have been loaded.
+
+ The following functions can be used to manage the coverage data:
+
+
+ html---
+ If non-nil, this will generate an HTML report, consisting of
+ an index file and one html file for each instrumented source
+ file that has been loaded in the current session. The
+ individual source file reports are stored in the same
+ directory as the index file.
+ external-format---
+ Controls the external format of the html files.
+ statistics---
+ If :statistics is non-nil, a comma-separated file is also
+ generated with the summary of statistics. You can specify a
+ filename for the statistics argument, otherwise
+ "statistics.csv" is created in the output directory. See
+ documentation of ccl:coverage-statistics below for a
+ description of the values in the statistics file.
+
+
+
+
+
+
+
+
+
+ Restores the coverage data previously saved with
+ CCL:SAVE-COVERAGE-IN-FILE, for the set of instrumented fasls
+ that were loaded both at save and restore time. I.e. coverage
+ info is only restored for files that have been loaded in this
+ session. For example if in a previous session you had loaded
+ "foo.lx86fsl" and then saved the coverage info, in this session
+ you must load the same "foo.lx86fsl" before calling
+ ccl:restore-coverage-from-file in order to retrieve the stored
+ coverage info for "foo". Equivalent to (ccl:restore-coverage
+ (ccl:read-coverage-from-file pathname)).
+
+
+
+ Returns a snapshot of the current coverage data. A snapshot is a
+ copy of the current coverage state. It can be saved in a file
+ with ccl:write-coverage-to-file, reinstated back as the current
+ state with ccl:restore-coverage, or combined with other
+ snapshots with ccl:combine-coverage.
+
+
+
+
+
+
+
+
+
+ Returns a sequence 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
+ accessors are defined for ccl:coverage-statistics objects:
+
+ the name of the source file corresponding to this information
+
+ the total number of expressions
+
+ the number of source expressions that have been entered
+ (i.e. at least partially covered)
+
+ the number of source expressions that were fully covered
+
+ the number of conditionals with one branch taken and one not taken
+
+ the total number of code forms. A code form is an
+ expression in the final stage of compilation, after all
+ macroexpansion and compiler transforms and simplification
+
+ the number of code forms that have been entered
+
+ the total number of functions
+
+ the number of functions that were fully covered
+
+ the number of functions that were partly covered
+
+ the number of functions never entered
+
+
+
+
+
+
-
+
BUILD-APPLICATION &key
( process-suspend was previously called
@@ -6863,5 +7506,5 @@
@@ -6916,5 +7559,5 @@
It would be nice to have more discussion of what it means
@@ -7060,5 +7703,5 @@
It would probably be better for result
@@ -7199,10 +7842,10 @@
This should arguably be SETFable, but doesn't seem to
@@ -7455,5 +8098,5 @@
Advises the OS scheduler that the current thread has nothing
@@ -7464,10 +8107,10 @@
This is a holdover from the days of cooperative
@@ -7492,5 +8135,5 @@
Creates and returns an object of type CCL::READ-WRITE-LOCK.
@@ -7849,10 +8492,10 @@
There probably should be some way to
@@ -7877,5 +8520,5 @@
result should probably be interpreted
@@ -8040,5 +8683,5 @@
result should probably be interpreted
@@ -8084,5 +8727,5 @@
fd---a file descriptor, which is a non-negative integer
@@ -8134,5 +8777,5 @@
@@ -8180,5 +8823,5 @@
fd---a file descriptor, which is a non-negative integer
@@ -8188,5 +8831,5 @@
@@ -8231,5 +8874,5 @@
process---a process, typically created by process-run-function or by make-process Waits for the specified process to terminate. If the
@@ -8498,5 +9141,5 @@
address-family---The address/protocol family of this socket. Currently
@@ -8597,5 +9240,5 @@
Creates and returns a new socket Extracts the first connection on the queue of pending
@@ -8650,5 +9293,5 @@
Converts a dotted-string representation of a host address to
@@ -8678,5 +9321,5 @@
ipaddr---A 32-bit integer representing an internet host address Converts a 32-bit unsigned IP address into octets. ipaddr---a 32-bit integer representing an internet host address Converts a 32-bit unsigned IP address into a host name
@@ -8733,5 +9376,5 @@
host---Specifies the host. It can be either a host name
@@ -8741,5 +9384,5 @@
Converts a host spec in any of the acceptable formats into a
@@ -8761,5 +9404,5 @@
port---Specifies the port. It can be either a string, such as
@@ -8770,5 +9413,5 @@
Finds the port number for the specified port and protocol Reads a UDP packet from a socket. If no packets are
@@ -8844,5 +9487,5 @@
Send a UDP packet over a socket. socket---The socket to shut down (typically a tcp-stream) Shuts down part of a bidirectional connection. This is
@@ -8907,10 +9550,10 @@
Returns the native OS's representation of the socket, or
@@ -8937,10 +9580,10 @@
Returns the 32-bit unsigned IP address of the remote host,
@@ -8962,10 +9605,10 @@
Returns the remote port number, or NIL if the socket is not
@@ -8987,10 +9630,10 @@
Returns 32-bit unsigned IP address of the local host. Returns the local port number Returns :internet or :file, as appropriate. Returns :active for tcp-stream, :passive for
@@ -9084,10 +9727,10 @@
Returns the socket format as specified by the :format
@@ -9109,10 +9752,10 @@
returns :stream for tcp-stream and listener-socket, and
@@ -9133,10 +9776,10 @@
simple-error The OS error code of the error A symbol representing the error code in a more
@@ -9210,10 +9853,10 @@
A string describing the context where the error happened. On
@@ -9236,5 +9879,5 @@
The close generic function can be applied to sockets. It
@@ -9268,5 +9911,5 @@
executes body with var bound to the result of applying
@@ -9406,5 +10049,5 @@
program---A string or pathname which denotes an executable file.
@@ -9452,5 +10095,5 @@
Runs the specified program in an external (Unix) process,
@@ -9472,5 +10115,5 @@
proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM. Sends the specified "signal" to the specified
@@ -9501,10 +10144,10 @@
Returns the process id assigned to
@@ -9528,10 +10171,10 @@
Returns the stream created when the input argument to
@@ -9554,10 +10197,10 @@
Returns the stream created when the output argument to
@@ -9581,10 +10224,10 @@
Returns the stream created when the error argument to
@@ -9608,10 +10251,10 @@
Returns, as multiple values, a keyword denoting the status
@@ -9643,5 +10286,5 @@
A stream that is associated with a file descriptor has
attributes and accessors:
@@ -9930,5 +10573,5 @@
stream---a stream, presumably a fundamental-input-stream. Should try to read up to count elements from stream into the
@@ -10481,5 +11124,5 @@
stream---a stream, presumably a fundamental-output-stream. should try to write the first count elements of list to
@@ -10512,5 +11155,5 @@
stream---a stream, presumably a fundamental-input-stream should try to read successive elements from stream into
@@ -10551,5 +11194,5 @@
stream---a stream, presumably a fundamental-output-stream should try to write successive elements of vector to stream,
@@ -10589,5 +11232,5 @@
Returns the file descriptor associated with
@@ -10630,5 +11273,5 @@
stream---An input stream. The method defined on
@@ -10662,5 +11305,5 @@
Writes max-octets octets to stream from ivector, starting at
@@ -10668,5 +11311,5 @@
-
+
CHUD:*SHARK-CONFIG-FILE* [Variable]
-
+
CHUD:METER form &key (reset nil) (debug-output nil) [Macro]
Reads a symbol from the current input stream, with *PACKAGE*
@@ -15034,5 +15677,5 @@
In In In In If completely is T, sets the
@@ -15308,5 +15951,5 @@
Proclaims name
@@ -15361,5 +16004,5 @@
If name is non-NIL, defines name to be an alias for the
@@ -15403,5 +16046,5 @@
If there is already an EXTERNAL-ENTRY-POINT for
@@ -15444,5 +16087,5 @@
Calls the foreign function at the address obtained by
@@ -15484,5 +16127,5 @@
Calls the foreign function at address entrypoint passing the
@@ -15521,5 +16164,5 @@
Calls the foreign function at address entrypoint passing the
@@ -15559,10 +16202,10 @@
Tries to resolve the address of the foreign symbol
@@ -15587,10 +16230,10 @@
Tries to resolve the address of the foreign symbol name. If
@@ -15614,5 +16257,5 @@
In
@@ -15702,5 +16345,5 @@
@@ -15768,5 +16411,5 @@
@@ -15856,5 +16499,5 @@
It would be helpful to describe what an soname is and give
@@ -15933,5 +16576,5 @@
References an instance of a foreign type (or a component of
@@ -15967,5 +16610,5 @@
Tries to resolve the address of the EXTERNAL-ENTRY-POINT
@@ -15996,5 +16639,5 @@
Executes body
@@ -16034,5 +16677,5 @@
Executes body in an environment in which each var is
@@ -16068,5 +16711,5 @@
Tells One typically wants interface information to be
@@ -16312,10 +16955,10 @@
@@ -17895,5 +18538,5 @@
name---a string which is the name of a new or existing
@@ -17908,5 +18551,5 @@
filename
@@ -4823,5 +4852,5 @@
+
+
+(progn
+ (do-this)
+ (setq that ...) ...))
+
+
+(defun init-this-and-that ()
+ (do-this)
+ (setq that ...) ...)
+(init-this-and-that)
+
+ CCL:*COMPILE-CODE-COVERAGE*
+ is true:
+
+(setq ccl:*compile-code-coverage* t)
+(recompile-all-your-files)
+
+
+
+ name "MyApplication")
@@ -5972,5 +6615,5 @@
CCL 1.2 and later, the #& reader macro can be used to
@@ -15093,5 +15736,5 @@
CCL 0.14.2 and later, the #? reader macro can be used
@@ -15140,5 +15783,5 @@
CCL 1.2 and later, the #/ reader macro can be used to
@@ -15243,5 +15886,5 @@
CCL 1.2 and later, the #> reader macro reads
@@ -15272,5 +15915,5 @@
CCL 1.2 and later, the CCL:FREE
@@ -15652,5 +16295,5 @@
CCL to remove the interface directory denoted by
@@ -16180,5 +16823,5 @@
define-objc-method
+ 13.6.1. Using define-objc-method
objc:defmethod
+ 13.6.2. Using objc:defmethod