[Emacs-diffs] emacs-24 r117119: Fix bug #17511 with unclear documentation of line-move-ignore-invisible.

[Eli Zaretskii]

------------------------------------------------------------
revno: 117119
revision-id: address@hidden
parent: address@hidden
fixes bug: http://debbugs.gnu.org/17511
committer: Eli Zaretskii <address@hidden>
branch nick: emacs-24
timestamp: Sat 2014-05-17 11:58:17 +0300
message:
  Fix bug #17511 with unclear documentation of line-move-ignore-invisible.
  
   lisp/simple.el (line-move-ignore-invisible): Doc fix.
  
   doc/lispref/display.texi (Invisible Text): Clarify the description of
   line-move-ignore-invisible.
modified:
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/display.texi       
display.texi-20091113204419-o5vbwnq5f7feedwu-6172
  lisp/ChangeLog                 changelog-20091113204419-o5vbwnq5f7feedwu-1432
  lisp/simple.el                 simple.el-20091113204419-o5vbwnq5f7feedwu-403

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2014-05-07 20:51:35 +0000
+++ b/doc/lispref/ChangeLog     2014-05-17 08:58:17 +0000
@@ -1,3 +1,8 @@
+2014-05-17  Eli Zaretskii  <address@hidden>
+
+       * display.texi (Invisible Text): Clarify the description of
+       line-move-ignore-invisible.  (Bug#17511)
+
 2014-05-07  Paul Eggert  <address@hidden>
 
        * internals.texi (C Dialect): New section.

=== modified file 'doc/lispref/display.texi'
--- a/doc/lispref/display.texi  2014-04-15 13:21:18 +0000
+++ b/doc/lispref/display.texi  2014-05-17 08:58:17 +0000
@@ -930,12 +930,14 @@
 
 @vindex line-move-ignore-invisible
   Ordinarily, functions that operate on text or move point do not care
-whether the text is invisible.  The user-level line motion commands
-ignore invisible newlines if @code{line-move-ignore-invisible} is
address@hidden (the default), but only because they are explicitly
-programmed to do so.
+whether the text is invisible, they process invisible characters and
+visible characters alike.  The user-level line motion commands,
+such as @code{next-line}, @code{previous-line}, ignore invisible
+newlines if @code{line-move-ignore-invisible} is address@hidden (the
+default), i.e., behave like these invisible newlines didn't exist in
+the buffer, but only because they are explicitly programmed to do so.
 
-  However, if a command ends with point inside or at the boundary of
+  If a command ends with point inside or at the boundary of
 invisible text, the main editing loop relocates point to one of the
 two ends of the invisible text.  Emacs chooses the direction of
 relocation so that it is the same as the overall movement direction of
@@ -952,6 +954,10 @@
 to the first visible character that follows the invisible text and then forward
 one more character.
 
+  These @dfn{adjustments} of point that ended up in the middle of
+invisible text can be disabled by setting @code{disable-point-adjustment}
+to a address@hidden value.  @xref{Adjusting Point}.
+
   Incremental search can make invisible overlays visible temporarily
 and/or permanently when a match includes invisible text.  To enable
 this, the overlay should have a address@hidden

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2014-05-16 13:11:09 +0000
+++ b/lisp/ChangeLog    2014-05-17 08:58:17 +0000
@@ -1,3 +1,7 @@
+2014-05-17  Eli Zaretskii  <address@hidden>
+
+       * simple.el (line-move-ignore-invisible): Doc fix.  (Bug#17511)
+
 2014-05-16  Michael Albinus  <address@hidden>
 
        * net/dbus.el (dbus-init-bus, dbus-call-method)

=== modified file 'lisp/simple.el'
--- a/lisp/simple.el    2014-04-23 12:52:22 +0000
+++ b/lisp/simple.el    2014-05-17 08:58:17 +0000
@@ -4978,7 +4978,16 @@
 `most-positive-fixnum'.")
 
 (defcustom line-move-ignore-invisible t
-  "Non-nil means \\[next-line] and \\[previous-line] ignore invisible lines.
+  "Non-nil means commands that move by lines ignore invisible newlines.
+
+When this option is non-nil, \\[next-line], \\[previous-line], 
\\[move-end-of-line], and \\[move-beginning-of-line] behave
+as if newlines that are invisible didn't exist, and count
+only visible newlines.  Thus, moving across across 2 newlines
+one of which is invisible will be counted as a one-line move.
+Also, a non-nil value causes invisible text to be ignored when
+counting columns for the purposes of keeping point in the same
+column by \\[next-line] and \\[previous-line].
+
 Outline mode sets this."
   :type 'boolean
   :group 'editing-basics)