From: Nikodemus S. <de...@us...> - 2010-03-11 17:09:55
|
Update of /cvsroot/sbcl/sbcl/src/compiler In directory sfp-cvsdas-3.v30.ch3.sourceforge.com:/tmp/cvs-serv19698/src/compiler Modified Files: main.lisp Log Message: 1.0.36.20: prettier WITH-COMPILATION-UNIT documentation * Adjust the docstring for the benefit of the manual, and teach docstrings.lisp more about parsing embedded examples. Index: main.lisp =================================================================== RCS file: /cvsroot/sbcl/sbcl/src/compiler/main.lisp,v retrieving revision 1.149 retrieving revision 1.150 diff -u -d -r1.149 -r1.150 --- main.lisp 11 Mar 2010 13:53:49 -0000 1.149 +++ main.lisp 11 Mar 2010 17:09:46 -0000 1.150 @@ -161,38 +161,43 @@ Supplying POLICY NIL is equivalent to the option not being supplied at all, ie. dynamic scoping of policy does not take place. - This option is an SBCL specific EXPERIMENTAL extension: Interface + This option is an SBCL-specific experimental extension: Interface subject to change. - Examples: + :SOURCE-PLIST Plist-Form + Attaches the value returned by the Plist-Form to internal debug-source + information of functions compiled in within the dynamic extent of BODY. - ;; Prevent OPTIMIZE proclamations from file leaking, and - ;; restrict SAFETY to 3 for the LOAD -- otherwise uses the - ;; current global policy. - (with-compilation-unit (:policy '(optimize)) - (restrict-compiler-policy 'safety 3) - (load \"foo.lisp\")) + Primarily for use by development environments, in order to eg. associate + function definitions with editor-buffers. Can be accessed using + SB-INTROSPECT:DEFINITION-SOURCE-PLIST. - ;; Load using default policy instead of the current global one, except - ;; for DEBUG 3. - (with-compilation-unit (:policy '(optimize debug) :override t) - (load \"foo.lisp\")) + If an outer WITH-COMPILATION-UNIT form also provide a SOURCE-PLIST, it + is appended to the end of the provided SOURCE-PLIST. Unaffected + by :OVERRIDE. - ;; Same as if :POLICY had not been specified at all: SAFETY 3 - ;; leaks outside WITH-COMPILATION-UNIT. - (with-compilation-unit (:policy nil) - (declaim (optimize safety))) + This is an SBCL-specific extension. - :SOURCE-PLIST Plist-Form - Attaches the value returned by the Plist-Form to internal debug-source - information of functions compiled in within the dynamic contour. - Primarily for use by development environments, in order to eg. associate - function definitions with editor-buffers. Can be accessed as - SB-INTROSPECT:DEFINITION-SOURCE-PLIST. If multiple, nested - WITH-COMPILATION-UNITs provide :SOURCE-PLISTs, they are appended - togather, innermost left. Unaffected by :OVERRIDE. +Examples: - This SBCL is and specific extension." + ;; Prevent proclamations from the file leaking, and restrict + ;; SAFETY to 3 -- otherwise uses the current global policy. + (with-compilation-unit (:policy '(optimize)) + (restrict-compiler-policy 'safety 3) + (load \"foo.lisp\")) + + ;; Using default policy instead of the current global one, + ;; except for DEBUG 3. + (with-compilation-unit (:policy '(optimize debug) + :override t) + (load \"foo.lisp\")) + + ;; Same as if :POLICY had not been specified at all: SAFETY 3 + ;; proclamation leaks out from WITH-COMPILATION-UNIT. + (with-compilation-unit (:policy nil) + (declaim (optimize safety)) + (load \"foo.lisp\")) +" `(%with-compilation-unit (lambda () ,@body) ,@options)) (defvar *source-plist* nil) |