[Emacs-diffs] Changes to emacs/doc/lispref/compile.texi,v

[Richard M. Stallman]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Richard M. Stallman <rms>       07/11/24 16:00:21

Index: compile.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/compile.texi,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -b -r1.3 -r1.4
--- compile.texi        24 Nov 2007 03:06:33 -0000      1.3
+++ compile.texi        24 Nov 2007 16:00:21 -0000      1.4
@@ -505,12 +505,14 @@
 @code{if}, and @var{func} must appear quoted in the call to
 @code{fboundp}.  (This feature operates for @code{cond} as well.)
 
-  You can tell the compiler that a function is defined using a
address@hidden statement (@pxref{Declaring Functions}).
-
-  Likewise, you can suppress a compiler warning for an unbound variable
address@hidden by conditionalizing its use on a @code{boundp} test,
-like this:
+  You can tell the compiler that a function is defined using
address@hidden (@pxref{Declaring Functions}).  Likewise, you
+can tell the compiler that a variable is defined using @code{defvar}
+with no initial value.
+
+  You can suppress the compiler warning for a specific use of an
+undefined variable @var{variable} by conditionalizing its use on a
address@hidden test, like this:
 
 @example
 (if (boundp '@var{variable}) address@hidden)
@@ -521,11 +523,8 @@
 @code{if}, and @var{variable} must appear quoted in the call to
 @code{boundp}.
 
-  You can tell the compiler that a variable is defined using a
address@hidden statement with no initial value.
-
-  You can suppress any compiler warnings using the construct
address@hidden:
+  You can suppress any and all compiler warnings within a certain
+expression using the construct @code{with-no-warnings}:
 
 @c This is implemented with a defun, but conceptually it is
 @c a special form.
@@ -536,10 +535,11 @@
 inside @var{body}.
 
 We recommend that you use this construct around the smallest
-possible piece of code.
+possible piece of code, to avoid missing possible warnings other than one
+one you intend to suppress.
 @end defspec
 
-More precise control of warnings is possible by setting the variable
+  More precise control of warnings is possible by setting the variable
 @code{byte-compile-warnings}.
 
 @node Byte-Code Objects