Merge from trunk.

[gnu-emacs] / src / editfns.c

diff --git a/src/editfns.c b/src/editfns.c
index afd4ed4833327a8c8d20bcea6bdabf127d313d2a..7e7f82c5992356e4d6c6b556e0a3376da239332d 100644 (file)
--- a/src/editfns.c
+++ b/src/editfns.c
@@ -658,10 +658,11 @@ is after LIMIT, then LIMIT will be returned instead.  */)
 
 DEFUN ("constrain-to-field", Fconstrain_to_field, Sconstrain_to_field, 2, 5, 0,
        doc: /* Return the position closest to NEW-POS that is in the same field as OLD-POS.
-
 A field is a region of text with the same `field' property.
-If NEW-POS is nil, then the current point is used instead, and set to the
-constrained position if that is different.
+
+If NEW-POS is nil, then use the current point instead, and move point
+to the resulting constrained position, in addition to returning that
+position.
 
 If OLD-POS is at the boundary of two fields, then the allowable
 positions for NEW-POS depends on the value of the optional argument