# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 813267585 0
# Node ID c61ffdb6d9dfede5d3f688a4d204498df0b07766
# Parent  e5431229a09f1c0deafb4bb89545042cec6b0997
Explain when to use make-variable-buffer-local.

diff -r e5431229a09f -r c61ffdb6d9df lispref/variables.texi
--- a/lispref/variables.texi	Mon Oct 09 18:00:54 1995 +0000
+++ b/lispref/variables.texi	Mon Oct 09 19:39:45 1995 +0000
@@ -1213,6 +1213,15 @@
 local to the current buffer at the time.
 
 The value returned is @var{variable}.
+
+@strong{Note:} It is a mistake to use @code{make-variable-buffer-local}
+for user-option variables, simply because users @emph{might} want to
+customize them differently in different buffers.  Users can make any
+variable local, when they wish to.
+
+The main use of @code{make-variable-buffer-local} is when a variable is
+used for internal purposes, and the Lisp program depends on having
+separate values in separate buffers.
 @end deffn
 
 @defun local-variable-p variable &optional buffer