From 56d318ce89dd0c1cff3fd210691ac0367b1382e3 Mon Sep 17 00:00:00 2001
From: Richard M Kreuter <kreuter@users.sourceforge.net>
Date: Sun, 27 Jul 2008 14:44:32 +0000
Subject: [PATCH] 1.0.18.28: Add NEWS entry and manual entry for
 SB-EXT:*MUFFLED-WARNINGS*.

---
 NEWS                           |    3 +++
 doc/manual/beyond-ansi.texinfo |    8 ++++++++
 doc/manual/compiler.texinfo    |    3 +++
 src/code/condition.lisp        |    5 +++--
 version.lisp-expr              |    2 +-
 5 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/NEWS b/NEWS
index 96e4136..f2b13fe 100644
--- a/NEWS
+++ b/NEWS
@@ -1,5 +1,8 @@
 ;;;; -*- coding: utf-8; -*-
 changes in sbcl-1.0.19 relative to 1.0.18:
+  * new feature: user-customizable variable SB-EXT:*MUFFLED-WARNINGS*;
+    warnings that go otherwise unhandled will be muffled if they are
+    of the type that's the value of this variable.  
   * optimization: stack allocation is slightly more efficient on x86
     and x86-64.
   * bug fix: DEFSTRUCT forms with user-specified :CONSTRUCTOR options,
diff --git a/doc/manual/beyond-ansi.texinfo b/doc/manual/beyond-ansi.texinfo
index 6626f28..78aa623 100644
--- a/doc/manual/beyond-ansi.texinfo
+++ b/doc/manual/beyond-ansi.texinfo
@@ -337,6 +337,14 @@ mechanisms as follows:
 @include fun-common-lisp-ed.texinfo
 @include var-sb-ext-star-ed-functions-star.texinfo
 
+Conditions of type @code{warning} and @code{style-warning} are
+sometimes signaled at runtime, especially during execution of Common
+Lisp defining forms such as @code{defun}, @code{defmethod}, etc.  To
+muffle these warnings at runtime, SBCL provides a variable
+@code{sb-ext:*muffled-warnings*}:
+
+@include var-sb-ext-star-muffled-warnings-star.texinfo
+
 @node Tools To Help Developers
 @comment  node-name,  next,  previous,  up
 @section Tools To Help Developers
diff --git a/doc/manual/compiler.texinfo b/doc/manual/compiler.texinfo
index d2d9746..35284f3 100644
--- a/doc/manual/compiler.texinfo
+++ b/doc/manual/compiler.texinfo
@@ -84,6 +84,9 @@ controlled via the alist
 
 @include var-sb-ext-star-compiler-print-variable-alist-star.texinfo
 
+For information about muffling warnings signaled outside of the
+compiler, see @ref{Customization Hooks for Users}.
+
 @c <!-- FIXME: How much control over error messages is in SBCL?
 @c      _     How much should be? How much of this documentation should
 @c      _     we save or adapt? 
diff --git a/src/code/condition.lisp b/src/code/condition.lisp
index 07dca98..830721d 100644
--- a/src/code/condition.lisp
+++ b/src/code/condition.lisp
@@ -1276,8 +1276,9 @@ the values returned by the form as a list. No associated restarts."))
 
 ;;; A knob for muffling warnings, mostly for use while loading files.
 (defvar *muffled-warnings* 'uninteresting-redefinition
-  "A type that ought to specify a subtype of WARNING.  Whenever a warning
-is signaled, if the warning if of this type, it will be muffled.")
+  "A type that ought to specify a subtype of WARNING.  Whenever a
+warning is signaled, if the warning if of this type and is not
+handled by any other handler, it will be muffled.")
 
 ;;; Various STYLE-WARNING signaled in the system.
 ;; For the moment, we're only getting into the details for function
diff --git a/version.lisp-expr b/version.lisp-expr
index 33ffdb7..3560cdf 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".)
-"1.0.18.27"
+"1.0.18.28"
-- 
1.7.10.4