From 3b095f4cdbb447f804d716a425a0ea6e5e6fb833 Mon Sep 17 00:00:00 2001 From: Miles Bader Date: Fri, 19 Oct 2001 15:05:16 +0000 Subject: [PATCH] (Fbeginning_of_line, Fend_of_line): Clarify interaction with fields and suggest using `forward-line' to avoid them. --- src/ChangeLog | 7 +++++++ src/cmds.c | 35 ++++++++++++++++++++--------------- 2 files changed, 27 insertions(+), 15 deletions(-) diff --git a/src/ChangeLog b/src/ChangeLog index 4289120c717..deb25afe8c8 100644 --- a/src/ChangeLog +++ b/src/ChangeLog @@ -1,3 +1,10 @@ +2001-10-19 Miles Bader + + * 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 * xdisp.c (redisplay_internal): Don't clear echo area if the 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)) -- 2.39.2