* src/editfns.c (Fconstrain_to_field): Doc fix.

* doc/lispref/text.texi (Fields): Minor copyedit.

Fixes: debbugs:9452

doc/lispref/ChangeLog

@@ -6,6 +6,8 @@
 	* display.texi (Temporary Displays): with-output-to-temp-buffer is
 	now a macro.
 
+	* text.texi (Fields): Minor copyedit.
+
 2012-03-10  Eli Zaretskii  <eliz@gnu.org>
 
 	* strings.texi (String Basics):

doc/lispref/text.texi

@@ -3777,7 +3777,7 @@ closest to @var{new-pos} that is in the same field as @var{old-pos}.
 
 If @var{new-pos} is @code{nil}, then @code{constrain-to-field} uses
 the value of point instead, and moves point to the resulting position
-as well as returning it.
+in addition to returning that position.
 
 If @var{old-pos} is at the boundary of two fields, then the acceptable
 final positions depend on the argument @var{escape-from-edge}.  If

src/ChangeLog

@@ -1,3 +1,7 @@
+2012-03-11  Chong Yidong  <cyd@gnu.org>
+
+	* editfns.c (Fconstrain_to_field): Doc fix (Bug#9452).
+
 2012-03-10  Chong Yidong  <cyd@gnu.org>
 
 	* frame.c (other_visible_frames): Don't assume the selected frame

src/editfns.c

@@ -663,10 +663,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