GNU bug report logs - #42748
26.3; Should `move-(beginning|end)-of-line' be in the Elisp manual?

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 42748 in the body.
You can then email your comments to 42748 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 26.3; Should `move-(beginning|end)-of-line' be in the Elisp manual?
Date: Fri, 7 Aug 2020 09:40:23 -0700 (PDT)

(elisp) `Text Lines' documents `(beginning|end)-of-line'.  It doesn't
document `move-(beginning|end)-of-line'.  The Emacs manual documents
the latter and not the former.  Is this the best approach, or did the
Elisp manual perhaps just not get updated when `C-a' and `C-e' were
changed to use the `move-*' commands?

In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.18362
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''

Message #10 received at 42748-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 42748-done <at> debbugs.gnu.org
Subject: Re: bug#42748: 26.3;
 Should `move-(beginning|end)-of-line' be in the Elisp manual?
Date: Sat, 08 Aug 2020 11:25:53 +0300

> Date: Fri, 7 Aug 2020 09:40:23 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> (elisp) `Text Lines' documents `(beginning|end)-of-line'.  It doesn't
> document `move-(beginning|end)-of-line'.  The Emacs manual documents
> the latter and not the former.  Is this the best approach, or did the
> Elisp manual perhaps just not get updated when `C-a' and `C-e' were
> changed to use the `move-*' commands?

It looks like Lisp programs use beginning-of-line and end-of-line
overwhelmingly more than the move-* counterparts, so it seems like the
discrepancy is actually justified.

So I'm closing this bug report.

Message #13 received at 42748 <at> debbugs.gnu.org (full text, mbox):

From: Richard Stallman <rms <at> gnu.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: eliz <at> gnu.org, drew.adams <at> oracle.com, 42748 <at> debbugs.gnu.org
Subject: Re: bug#42748: 26.3;
 Should `move-(beginning|end)-of-line' be in the Elisp manual?
Date: Sat, 08 Aug 2020 21:59:43 -0400

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > > (elisp) `Text Lines' documents `(beginning|end)-of-line'.  It doesn't
  > > document `move-(beginning|end)-of-line'.  The Emacs manual documents
  > > the latter and not the former.  Is this the best approach, or did the
  > > Elisp manual perhaps just not get updated when `C-a' and `C-e' were
  > > changed to use the `move-*' commands?

The difference between the keyboard commands and the basic functions
is intentional.  THe basic functions are useful in Lisp programs; the
move- commands are on C-a and C-e but are not worth documenting for
Lisp programs to call.

-- 
Dr Richard Stallman
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.