changeset 51916:f7b97d07a39c

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

--- a/lispref/variables.texi	Mon Jul 14 15:56:05 2003 +0000
+++ b/lispref/variables.texi	Mon Jul 14 15:56:49 2003 +0000
@@ -1318,6 +1318,12 @@
 @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 @@
 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