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

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

[Drew Adams]

(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''

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

[Eli Zaretskii]

> Date: Fri, 7 Aug 2020 09:40:23 -0700 (PDT)
> From: Drew Adams <drew.adams@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.

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

[Richard Stallman]

[[[ 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)