From: Richard M. Stallman <rms@gnu.org>
Date: Mon, 14 Jul 2003 15:56:49 +0000 (+0000)
Subject: (Creating Buffer-Local): Add buffer-local-value.
X-Git-Tag: ttn-vms-21-2-B4~9343
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a1c0746110fd41e3edbe9f743147bc27727f3616;p=emacs.git

(Creating Buffer-Local): Add buffer-local-value.
(Variable Aliases): Clarify defvralias.
---

diff --git a/lispref/variables.texi b/lispref/variables.texi
index 268b8788500..bbed104a42b 100644
--- a/lispref/variables.texi
+++ b/lispref/variables.texi
@@ -1318,6 +1318,12 @@ This returns @code{t} if @var{variable} is buffer-local in buffer
 @code{nil}.
 @end defun
 
+@defun buffer-local-value variable buffer
+This returns the value of @var{variable} that is currently in
+effect in @var{buffer}.  If it has no buffer-local binding in
+@var{buffer}, this function returns the default value.
+@end defun
+
 @defun buffer-local-variables &optional buffer
 This function returns a list describing the buffer-local variables in
 buffer @var{buffer}.  (If @var{buffer} is omitted, the current buffer is
@@ -1666,15 +1672,15 @@ chosen, or because its meaning has partly changed---it can be useful
 to keep the old name as an @emph{alias} of the new one for
 compatibility.  You can do this with @code{defvaralias}.
 
-@defun defvaralias alias-var base-var [docstring]
+@defun defvaralias alias-var base-var &optional docstring
 This function defines the symbol @var{alias-var} as a variable alias
 for symbol @var{base-var}. This means that retrieving the value of
 @var{alias-var} returns the value of @var{base-var}, and changing the
 value of @var{alias-var} changes the value of @var{base-var}.
 
-If the @var{docstring} argument is present, it specifies the documentation for
-@var{alias-var}; otherwise, it has the same documentation as @var{base-var},
-if any.
+If the @var{docstring} argument is non-@code{nil}, it specifies the
+documentation for @var{alias-var}; otherwise, the alias gets the same
+documentation as @var{base-var} has, if any.
 @end defun
 
 @defun indirect-variable variable