(Fbeginning_of_line, Fend_of_line): Clarify interaction with fields and

suggest using `forward-line' to avoid them.

1 files changed, 20 insertions, 15 deletions

diff --git a/src/cmds.c b/src/cmds.c
index b3394c2fc4e..ba9f15dd253 100644
--- 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))