* lisp/bookmark.el (bookmark-alist): Doc fix. (Bug#29551)

diff --git a/lisp/bookmark.el b/lisp/bookmark.el
index 1c8ff3df23e5885a94643f55ca745bdf70930829..43d1f57aa5ffb1aa0a11a2799612ce6fd442fad8 100644 (file)
--- a/lisp/bookmark.el
+++ b/lisp/bookmark.el
@@ -229,7 +229,7 @@ functions have a binding in this keymap.")
 \f
 ;;; Core variables and data structures:
 (defvar bookmark-alist ()
-  "Association list of bookmarks and their records.
+  "Association list of bookmark names and their parameters.
 Bookmark functions update the value automatically.
 You probably do NOT want to change the value yourself.
 
@@ -254,7 +254,7 @@ or the deprecated form (BOOKMARK-NAME PARAM-ALIST).
   (annotation . ANNOTATION)
 
  FILENAME names the bookmarked file.
- POS is the bookmarked buffer position (position in the file).
+ POS is the bookmarked buffer position.
  STR-AFTER-POS is buffer text that immediately follows POS.
  STR-BEFORE-POS is buffer text that immediately precedes POS.
  ANNOTATION is a string that describes the bookmark.
@@ -262,7 +262,7 @@ or the deprecated form (BOOKMARK-NAME PARAM-ALIST).
    `bookmark-automatically-show-annotations'.
  HANDLER is a function that provides the bookmark-jump behavior for a
  specific kind of bookmark.  This is the case for Info bookmarks,
- for instance.  HANDLER must accept a bookmark as argument.")
+ for instance.  HANDLER must accept a bookmark as its single argument.")
 
 (defvar bookmarks-already-loaded nil
   "Non-nil if and only if bookmarks have been loaded from `bookmark-default-file'.")