From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 9 Dec 2017 09:18:06 +0000 (+0200)
Subject: * lisp/bookmark.el (bookmark-alist): Doc fix.  (Bug#29551)
X-Git-Tag: emacs-26.0.91~180
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=161b0e5493bc86892255e06770b80fbe1d5f4815;p=emacs.git

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

diff --git a/lisp/bookmark.el b/lisp/bookmark.el
index 1c8ff3df23e..43d1f57aa5f 100644
--- a/lisp/bookmark.el
+++ b/lisp/bookmark.el
@@ -229,7 +229,7 @@ functions have a binding in this keymap.")
 
 ;;; 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'.")