GNU bug report logs - #29551
24.5; doc string of `bookmark-alist'

Previous Next

Package: emacs;

Reported by: Drew Adams <drew.adams <at> oracle.com>

Date: Sun, 3 Dec 2017 23:42:02 UTC

Severity: minor

Found in version 24.5

Done: Eli Zaretskii <eliz <at> gnu.org>

Bug is archived. No further changes may be made.

Full log

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: 24.5; doc string of `bookmark-alist'
Date: Sun, 3 Dec 2017 15:41:10 -0800 (PST)

A bookmark is more than a name.

The first line of the doc string says this:

  Association list of bookmarks and their records.

That's wrong, or at best misleading.  Each entry in the alist is a
_bookmark_.  That is, each entry is a bookmark "record", whose car
is the bookmark name, and whose cdr is the associated bookmark data.

The doc should say something like this:

"Association list of bookmark names and bookmark data."
or
"Association list of bookmark records." (and then say what a record is)

In GNU Emacs 24.5.1 (i686-pc-mingw32)
 of 2015-04-11 on LEG570
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/usr --host=i686-pc-mingw32'
This bug report was last modified 7 years and 225 days ago.

Previous Next

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