Add usage note of buffer-invisibility-spec.

* src/buffer.c (syms_of_buffer) <buffer-invisibility-spec>: Add usage
note from the lispref.

diff --git a/src/ChangeLog b/src/ChangeLog
index 9f57429aa00f1949844274d57c0b273aeb5c702f..025ddfa342515cae2158de55c2736e6619a7783b 100644 (file)
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,3 +1,8 @@
+2013-10-15  Xue Fuqiao  <xfq.free@gmail.com>
+
+       * buffer.c (syms_of_buffer) <buffer-invisibility-spec>: Add usage
+       note from the lispref.
+
 2013-10-15  Dmitry Antipov  <dmantipov@yandex.ru>
 
        * nsterm.h (struct ns_display_info): Remove set-but-unused

diff --git a/src/buffer.c b/src/buffer.c
index 1570f3831ac63aa968bbc8a86c98813ccf50e493..ef04ca7018dab39a86a36f6720fb40ddcfc0ada1 100644 (file)
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -6190,7 +6190,9 @@ If the value is a list, a text character is invisible if its `invisible'
 property is an element in that list (or is a list with members in common).
 If an element is a cons cell of the form (PROP . ELLIPSIS),
 then characters with property value PROP are invisible,
-and they have an ellipsis as well if ELLIPSIS is non-nil.  */);
+and they have an ellipsis as well if ELLIPSIS is non-nil.
+Setting this variable is very fast, much faster than scanning all the
+text in the buffer looking for properties to change.  */);
 
   DEFVAR_PER_BUFFER ("buffer-display-count",
                     &BVAR (current_buffer, display_count), Qintegerp,