[Emacs-diffs] trunk r113906: Remove documentation of undefined behavior.

[Xue Fuqiao]

------------------------------------------------------------
revno: 113906
revision-id: address@hidden
parent: address@hidden
committer: Xue Fuqiao <address@hidden>
branch nick: trunk
timestamp: Fri 2013-08-16 08:20:56 +0800
message:
  Remove documentation of undefined behavior.
  
  * doc/lispref/positions.texi (Character Motion):
  * doc/lispref/markers.texi (Moving Markers):
  (Creating Markers): Comment out undefined behavior.
  
  * src/marker.c (set_marker): Remove documentation of undefined behavior.
modified:
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/markers.texi       
markers.texi-20091113204419-o5vbwnq5f7feedwu-6198
  doc/lispref/positions.texi     
positions.texi-20091113204419-o5vbwnq5f7feedwu-6206
  doc/lispref/text.texi          text.texi-20091113204419-o5vbwnq5f7feedwu-6215
  lisp/follow.el                 follow.el-20091113204419-o5vbwnq5f7feedwu-966
  src/ChangeLog                  changelog-20091113204419-o5vbwnq5f7feedwu-1438
  src/marker.c                   marker.c-20091113204419-o5vbwnq5f7feedwu-156

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2013-08-15 08:27:22 +0000
+++ b/doc/lispref/ChangeLog     2013-08-16 00:20:56 +0000
@@ -1,3 +1,9 @@
+2013-08-16  Xue Fuqiao  <address@hidden>
+
+       * positions.texi (Character Motion):
+       * markers.texi (Moving Markers):
+       (Creating Markers): Comment out undefined behavior.
+
 2013-08-15  Xue Fuqiao  <address@hidden>
 
        * markers.texi (The Region): Add/move indexes.

=== modified file 'doc/lispref/markers.texi'
--- a/doc/lispref/markers.texi  2013-08-15 08:27:22 +0000
+++ b/doc/lispref/markers.texi  2013-08-16 00:20:56 +0000
@@ -216,11 +216,14 @@
 The new marker's insertion type is specified by the argument
 @var{insertion-type}.  @xref{Marker Insertion Types}.
 
address@hidden This behavior used to be documented until 2013/08.
address@hidden
 If passed an integer argument less than 1, @code{copy-marker} returns a
 new marker that points to the beginning of the current buffer.  If
 passed an integer argument greater than the length of the buffer,
 @code{copy-marker} returns a new marker that points to the end of the
 buffer.
address@hidden ignore
 
 @example
 @group
@@ -351,11 +354,15 @@
 in @var{buffer}.  If @var{buffer} is not provided, it defaults to
 the current buffer.
 
address@hidden This behavior used to be documented until 2013/08.
address@hidden
 If @var{position} is less than 1, @code{set-marker} moves @var{marker}
 to the beginning of the buffer.  If @var{position} is greater than the
 size of the buffer (@pxref{Point}), @code{set-marker} moves marker to
-the end of the buffer.  If @var{position} is @code{nil} or a marker
-that points nowhere, then @var{marker} is set to point nowhere.
+the end of the buffer.
address@hidden ignore
+If @var{position} is @code{nil} or a marker that points nowhere, then
address@hidden is set to point nowhere.
 
 The value returned is @var{marker}.
 

=== modified file 'doc/lispref/positions.texi'
--- a/doc/lispref/positions.texi        2013-08-14 13:58:25 +0000
+++ b/doc/lispref/positions.texi        2013-08-16 00:20:56 +0000
@@ -146,9 +146,13 @@
 
 @deffn Command goto-char position
 This function sets point in the current buffer to the value
address@hidden  If @var{position} is less than 1, it moves point to the
-beginning of the buffer.  If @var{position} is greater than the length
-of the buffer, it moves point to the end.
address@hidden
address@hidden This behavior used to be documented until 2013/08.
address@hidden
+If @var{position} is less than 1, it moves point to the beginning of
+the buffer.  If @var{position} is greater than the length of the
+buffer, it moves point to the end.
address@hidden ignore
 
 If narrowing is in effect, @var{position} still counts from the
 beginning of the buffer, but point cannot go outside the accessible

=== modified file 'doc/lispref/text.texi'
--- a/doc/lispref/text.texi     2013-07-10 06:26:23 +0000
+++ b/doc/lispref/text.texi     2013-08-16 00:20:56 +0000
@@ -240,6 +240,7 @@
 copied out of the buffer.
 @end defun
 
address@hidden FIXME: `filter-buffer-substring-function' should be documented.
 @defvar filter-buffer-substring-functions
 This variable is a wrapper hook (@pxref{Running Hooks}), whose members
 should be functions that accept four arguments: @var{fun},

=== modified file 'lisp/follow.el'
--- a/lisp/follow.el    2013-08-10 15:17:29 +0000
+++ b/lisp/follow.el    2013-08-16 00:20:56 +0000
@@ -1259,6 +1259,8 @@
 
        ;; If the region is visible, make it look good when spanning
        ;; multiple windows.
+
+       ;; FIXME: Why not use `use-region-p' here?
        (when (region-active-p)
          (follow-maximize-region
           (selected-window) windows win-start-end)))

=== modified file 'src/ChangeLog'
--- a/src/ChangeLog     2013-08-15 19:46:02 +0000
+++ b/src/ChangeLog     2013-08-16 00:20:56 +0000
@@ -1,3 +1,7 @@
+2013-08-16  Xue Fuqiao  <address@hidden>
+
+       * marker.c (set_marker): Remove documentation of undefined behavior.
+
 2013-08-15  Lars Magne Ingebrigtsen  <address@hidden>
 
        * image.c (imagemagick_compute_animated_image): Animate correctly

=== modified file 'src/marker.c'
--- a/src/marker.c      2013-08-14 14:02:46 +0000
+++ b/src/marker.c      2013-08-16 00:20:56 +0000
@@ -536,11 +536,8 @@
 DEFUN ("set-marker", Fset_marker, Sset_marker, 2, 3, 0,
        doc: /* Position MARKER before character number POSITION in BUFFER.
 If BUFFER is omitted or nil, it defaults to the current buffer.  If
-POSITION is less than 1, MARKER is moved to the beginning of the
-buffer.  If POSITION is greater than the size of the buffer, marker is
-moved to the end of the buffer.  If POSITION is nil, makes marker
-point nowhere so it no longer slows down editing in any buffer.
-Returns MARKER.  */)
+POSITION is nil, makes marker point nowhere so it no longer slows down
+editing in any buffer.  Returns MARKER.  */)
   (Lisp_Object marker, Lisp_Object position, Lisp_Object buffer)
 {
   return set_marker_internal (marker, position, buffer, 0);