From d3f80ab16fd7058fedefaf2a84e3f072559eaa3d Mon Sep 17 00:00:00 2001 From: Nikodemus Siivola Date: Thu, 26 Aug 2004 16:17:06 +0000 Subject: [PATCH] 0.8.13.80: Last minute manual twiddling * Fix a bunch of tyepos, including the all-important distinction between < and >. * Correct cross-references pertaining to *INVOKE-DEBUGGER-HOOK*. * Remove cartouches from docs, as they seem to mess up the HTML output. * Remove a duplicated text about muffle-conditions, left in after a cut & paste fest. --- doc/manual/compiler.texinfo | 32 +++-------------------- doc/manual/intro.texinfo | 2 +- doc/manual/start-stop.texinfo | 58 ++++++++++++++++++----------------------- version.lisp-expr | 2 +- 4 files changed, 31 insertions(+), 63 deletions(-) diff --git a/doc/manual/compiler.texinfo b/doc/manual/compiler.texinfo index ee242f4..a4e287b 100644 --- a/doc/manual/compiler.texinfo +++ b/doc/manual/compiler.texinfo @@ -525,7 +525,7 @@ default compilation policy provides full type checks. Any or all type declarations may be believed without runtime assertions, and assertions that are done may be imprecise. -Used when @code{(> 0 safety (max speed space compilation-speed)}. +Used when @code{(< 0 safety (max speed space compilation-speed)}. @item No Type Checks All declarations are believed without assertions. Also disables @@ -768,34 +768,8 @@ Policy Control}. Ordinarily, when the @code{speed} quality is high, the compiler emits notes to notify the programmer about its inability to apply various -optimizations. - -Compiler diagnostics (of any severity other than @code{error}: -@pxref{Diagnostic Severity}) can be silenced by using the -@code{sb-ext:muffle-conditions} declaration, specifying the type of -condition that is to be muffled (using an associated -@code{muffle-warning} restart). - -To muffle all compiler notes: - -@lisp -(declaim (sb-ext:muffle-conditions sb-ext:compiler-note)) -@end lisp - -Compiler diagnostics can also be muffled in the lexical scope of a -declaration, and also lexically unmuffled by the use of the -sb-ext:unmuffle-conditions, for instance: - -@lisp -(defun foo (x) - (declare (optimize speed) (fixnum x)) - (declare (sb-ext:muffle-conditions sb-ext:compiler-note)) - (values (* x 5) ; no compiler note from this - (locally - (declare (sb-ext:unmuffle-conditions sb-ext:compiler-note)) - ;; this one gives a compiler note - (* x -5)))) -@end lisp +optimizations. For selective muffling of these notes @xref{Controlling +Verbosity} The value of @code{space} mostly influences the compiler's decision whether to inline operations, which tend to increase the size of diff --git a/doc/manual/intro.texinfo b/doc/manual/intro.texinfo index 898c160..de53117 100644 --- a/doc/manual/intro.texinfo +++ b/doc/manual/intro.texinfo @@ -281,7 +281,7 @@ automated documentation lookup. Currently @dfn{SLIME}@footnote{Historically, the ILISP package at @uref{http://ilisp.cons.org/} provided similar functionality, but it does not support modern SBCL versions.} (Superior Lisp Interaction -Mode for Emacs) togather with Emacs is recommended for use with +Mode for Emacs) together with Emacs is recommended for use with SBCL, though other options exist as well. SLIME can be downloaded from diff --git a/doc/manual/start-stop.texinfo b/doc/manual/start-stop.texinfo index 53f34d1..aca62d8 100644 --- a/doc/manual/start-stop.texinfo +++ b/doc/manual/start-stop.texinfo @@ -1,6 +1,6 @@ @node Starting and Stopping @comment node-name, next, previous, up -@chapter Starting and Stoppping +@chapter Starting and Stopping @menu * Starting SBCL:: @@ -29,7 +29,6 @@ You should end up in the toplevel @dfn{REPL} (read, eval, print -loop), where you can interact with SBCL by typing expressions. @smallexample -@cartouche $ sbcl This is SBCL 0.8.13.60, an implementation of ANSI Common Lisp. More information about SBCL is available at . @@ -43,7 +42,6 @@ distribution for more information. 4 * (quit) $ -@end cartouche @end smallexample See also @ref{Command Line Options} and @ref{Stopping SBCL}. @@ -111,8 +109,8 @@ using SBCL as part of a shell pipeline. SBCL can also be configured to exit if an unhandled error occurs, which is mainly useful for acting as part of a shell pipeline; doing so under most other circumstances would mean giving up large parts of -the flexibility and robustness of Common Lisp. See @ref{Customization -Hooks for Users}. +the flexibility and robustness of Common Lisp. See @ref{Starting the +Debugger}. @node Command Line Options @@ -181,7 +179,7 @@ Print SBCL's version information, then exit. @end table -In the future, runtime options may be added to control behavior such +In the future, runtime options may be added to control behaviour such as lazy allocation of memory. Runtime options, including any --end-runtime-options option, are @@ -228,7 +226,7 @@ cleanly in Unix pipelines. @item --disable-debugger This is equivalent to @code{--eval '(sb-ext:disable-debugger)'}. -@xref{Customization Hooks for Users}. +@xref{Starting the Debugger}. @end table @@ -293,7 +291,7 @@ files follow. @comment node-name, next, previous, up @subsubsection Unix-style Command Line Protocol -Standard Unix tools that are interpeters follow a common command line +Standard Unix tools that are interpreters follow a common command line protocol that is necessary to work with ``shebang scripts''. SBCL doesn't do this by default, but adding the following snippet to an initialization file does the trick: @@ -302,21 +300,21 @@ initialization file does the trick: ;;; If the first user-processable command-line argument is a filename, ;;; disable the debugger, load the file handling shebang-line and quit. (let ((script (and (second *posix-argv*) (probe-file (second *posix-argv*))))) - (when script - ;; Handle shebang-line - (set-dispatch-macro-character #\# #\! - (lambda (stream char arg) - (declare (ignore char arg)) - (read-line stream))) - ;; Disable debugger - (setf *invoke-debugger-hook* (lambda (condition hook) - (declare (ignore hook)) - ;; Uncomment to get backtraces on errors - ;; (sb-debug:backtrace 20) - (format *error-output* "Error: ~A~%" condition) - (quit))) - (load script) - (quit))) + (when script + ;; Handle shebang-line + (set-dispatch-macro-character #\# #\! + (lambda (stream char arg) + (declare (ignore char arg)) + (read-line stream))) + ;; Disable debugger + (setf *invoke-debugger-hook* (lambda (condition hook) + (declare (ignore hook)) + ;; Uncomment to get backtraces on errors + ;; (sb-debug:backtrace 20) + (format *error-output* "Error: ~A~%" condition) + (quit))) + (load script) + (quit))) @end lisp Example file (@file{hello.lisp}): @@ -329,14 +327,11 @@ Example file (@file{hello.lisp}): Usage examples: @smallexample -@cartouche $ ./hello.lisp Hello, World! -@end cartouche @end smallexample @smallexample -@cartouche $ sbcl hello.lisp This is SBCL 0.8.13.70, an implementation of ANSI Common Lisp. More information about SBCL is available at . @@ -346,7 +341,6 @@ It is mostly in the public domain; some portions are provided under BSD-style licenses. See the CREDITS and COPYING files in the distribution for more information. Hello, World! -@end cartouche @end smallexample @@ -363,9 +357,9 @@ handles recompilation automatically for ASDF-based systems. ;;; If a fasl was stale, try to recompile and load (once). (defmethod asdf:perform :around ((o asdf:load-op) (c asdf:cl-source-file)) - (handler-case (call-next-method o c) - ;; If a fasl was stale, try to recompile and load (once). - (sb-ext:invalid-fasl () - (asdf:perform (make-instance 'asdf:compile-op) c) - (call-next-method)))) + (handler-case (call-next-method o c) + ;; If a fasl was stale, try to recompile and load (once). + (sb-ext:invalid-fasl () + (asdf:perform (make-instance 'asdf:compile-op) c) + (call-next-method)))) @end lisp diff --git a/version.lisp-expr b/version.lisp-expr index a8ed365..36d5f8f 100644 --- a/version.lisp-expr +++ b/version.lisp-expr @@ -17,4 +17,4 @@ ;;; checkins which aren't released. (And occasionally for internal ;;; versions, especially for internal versions off the main CVS ;;; branch, it gets hairier, e.g. "0.pre7.14.flaky4.13".) -"0.8.13.79" +"0.8.13.80" -- 1.7.10.4