[Emacs-diffs] trunk r116284: Doc changes for cache-long-scans

[Glenn Morris]

------------------------------------------------------------
revno: 116284
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Wed 2014-02-05 20:27:26 -0800
message:
  Doc changes for cache-long-scans
  
  Ref: http://debbugs.gnu.org/15797#65
  
  * doc/lispref/display.texi (Truncation):
  * doc/lispref/positions.texi (Screen Lines): Do not mention cache-long-scans.
  
  * src/buffer.c (cache-long-scans): Doc fix.
  
  * etc/NEWS: Related edit.
modified:
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/display.texi       
display.texi-20091113204419-o5vbwnq5f7feedwu-6172
  doc/lispref/positions.texi     
positions.texi-20091113204419-o5vbwnq5f7feedwu-6206
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1
  src/ChangeLog                  changelog-20091113204419-o5vbwnq5f7feedwu-1438
  src/buffer.c                   buffer.c-20091113204419-o5vbwnq5f7feedwu-264

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2014-01-31 09:41:54 +0000
+++ b/doc/lispref/ChangeLog     2014-02-06 04:27:26 +0000
@@ -1,3 +1,8 @@
+2014-02-06  Glenn Morris  <address@hidden>
+
+       * display.texi (Truncation):
+       * positions.texi (Screen Lines): Do not mention cache-long-scans.
+
 2014-01-31  Juri Linkov  <address@hidden>
 
        * searching.texi (String Search): Incremental word search fixes.

=== modified file 'doc/lispref/display.texi'
--- a/doc/lispref/display.texi  2014-01-22 08:30:00 +0000
+++ b/doc/lispref/display.texi  2014-02-06 04:27:26 +0000
@@ -214,6 +214,7 @@
 over the @code{line-prefix} variable.  @xref{Special Properties}.
 @end defvar
 
address@hidden
   If your buffer contains only very short lines, you might find it
 advisable to set @code{cache-long-scans} to @code{nil}.
 
@@ -227,6 +228,7 @@
 
 This variable is automatically buffer-local in every buffer.
 @end defvar
address@hidden ignore
 
 @node The Echo Area
 @section The Echo Area

=== modified file 'doc/lispref/positions.texi'
--- a/doc/lispref/positions.texi        2014-01-01 07:43:34 +0000
+++ b/doc/lispref/positions.texi        2014-02-06 04:27:26 +0000
@@ -486,9 +486,11 @@
 Display}.
 
   These functions scan text to determine where screen lines break, and
-thus take time proportional to the distance scanned.  If you intend to
-use them heavily, Emacs provides caches which may improve the
-performance of your code.  @xref{Truncation, cache-long-scans}.
+thus take time proportional to the distance scanned.
address@hidden
+If you intend to use them heavily, Emacs provides caches which may
+improve the performance of your code.  @xref{Truncation, cache-long-scans}.
address@hidden ignore
 
 @defun vertical-motion count &optional window
 This function moves point to the start of the screen line @var{count}

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2014-02-06 04:05:43 +0000
+++ b/etc/NEWS  2014-02-06 04:27:26 +0000
@@ -240,9 +240,9 @@
 ** `write-region-inhibit-fsync' now defaults to t in batch mode.
 
 +++
-** `cache-long-line-scans' has been renamed to `cache-long-scans'
+** `cache-long-line-scans' is now non-nil, and renamed to `cache-long-scans',
 because it affects caching of paragraph scanning results as well.
-Also, it is now enabled by default.
+There is no reason to set this to nil except for debugging purposes.
 
 ---
 ** The option `set-mark-default-inactive' has been deleted.

=== modified file 'src/ChangeLog'
--- a/src/ChangeLog     2014-02-05 16:50:53 +0000
+++ b/src/ChangeLog     2014-02-06 04:27:26 +0000
@@ -1,3 +1,7 @@
+2014-02-06  Glenn Morris  <address@hidden>
+
+       * buffer.c (cache-long-scans): Doc fix.
+
 2014-02-05  Eli Zaretskii  <address@hidden>
 
        * w32fns.c (Fw32_shell_execute): Doc fix.

=== modified file 'src/buffer.c'
--- a/src/buffer.c      2014-01-21 02:28:57 +0000
+++ b/src/buffer.c      2014-02-06 04:27:26 +0000
@@ -6130,6 +6130,8 @@
   DEFVAR_PER_BUFFER ("cache-long-scans", &BVAR (current_buffer, 
cache_long_scans), Qnil,
                     doc: /* Non-nil means that Emacs should use caches in 
attempt to speedup buffer scans.
 
+There is no reason to set this to nil except for debugging purposes.
+
 Normally, the line-motion functions work by scanning the buffer for
 newlines.  Columnar operations (like `move-to-column' and
 `compute-motion') also work by scanning the buffer, summing character