(Fbeginning_of_line, Fend_of_line): Clarify interaction with fields and

suggest using `forward-line' to avoid them.

diff --git a/src/ChangeLog b/src/ChangeLog
index 4289120c71756e03a6f52537745f330cde850406..deb25afe8c81b5776972ba894227776c283f5d63 100644 (file)
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,3 +1,10 @@
+2001-10-19  Miles Bader  <miles@gnu.org>
+
+       * cmds.c (Fbeginning_of_line, Fend_of_line): Clarify interaction
+       with fields and suggest using `forward-line' to avoid them.
+       * editfns.c (Fline_beginning_position, Fline_end_position):
+       Clarify documentation.
+
 2001-10-19  Gerd Moellmann  <gerd@gnu.org>
 
        * xdisp.c (redisplay_internal): Don't clear echo area if the

diff --git a/src/cmds.c b/src/cmds.c
index b3394c2fc4ea12299045f1845599114f0db9cfb8..ba9f15dd2535599dc59f61662000731f3bc0e84c 100644 (file)
--- a/src/cmds.c
+++ b/src/cmds.c
@@ -1,5 +1,5 @@
 /* Simple built-in editing commands.
-   Copyright (C) 1985, 93, 94, 95, 96, 97, 1998 Free Software Foundation, Inc.
+   Copyright (C) 1985, 93, 94, 95, 96, 97, 1998, 2001 Free Software Foundation, Inc.
 
 This file is part of GNU Emacs.
 
@@ -149,15 +149,19 @@ With positive N, a non-empty line at the end counts as one line\n\
   return make_number (count <= 0 ? - shortage : shortage);
 }
 
-DEFUN ("beginning-of-line", Fbeginning_of_line, Sbeginning_of_line,
-  0, 1, "p",
-  "Move point to beginning of current line.\n\
+DEFUN ("beginning-of-line", Fbeginning_of_line, Sbeginning_of_line, 0, 1, "p",
+       "Move point to beginning of current line.\n\
 With argument N not nil or 1, move forward N - 1 lines first.\n\
 If point reaches the beginning or end of buffer, it stops there.\n\
-This command does not move point across a field boundary\n\
-unless it would move beyond there to a different line.\n\
-If N is nil or 1, and point starts at a field boundary, point does not move.")
-  (n)
+\n\
+This command does not move point across a field boundary unless doing so\n\
+would move beyond there to a different line; If N is nil or 1, and point\n\
+starts at a field boundary, point does not move.  To ignore field\n\
+boundaries, either bind `inhibit-field-text-motion' to t, or use the\n\
+`forward-line' function instead.  For instance, `(forward-line 0)' does\n\
+the same thing as `(beginning-of-line)', except that it ignores field\n\
+boundaries.") 
+     (n)
      Lisp_Object n;
 {
   if (NILP (n))
@@ -170,15 +174,16 @@ If N is nil or 1, and point starts at a field boundary, point does not move.")
   return Qnil;
 }
 
-DEFUN ("end-of-line", Fend_of_line, Send_of_line,
-  0, 1, "p",
-  "Move point to end of current line.\n\
+DEFUN ("end-of-line", Fend_of_line, Send_of_line, 0, 1, "p",
+       "Move point to end of current line.\n\
 With argument N not nil or 1, move forward N - 1 lines first.\n\
 If point reaches the beginning or end of buffer, it stops there.\n\
-This command does not move point across a field boundary\n\
-unless it would move beyond there to a different line.\n\
-If N is nil or 1, and point starts at a field boundary, point does not move.")
-  (n)
+\n\
+This command does not move point across a field boundary unless doing so\n\
+would move beyond there to a different line; if N is nil or 1, and\n\
+point starts at a field boundary, point does not move.  To ignore field\n\
+boundaries bind `inhibit-field-text-motion' to t.")
+     (n)
      Lisp_Object n;
 {
   if (NILP (n))