Homepage: https://www.emacswiki.org/emacs/download/bookmark%2b.el
Author: Drew Adams, Thierry Volpiatto
Updated:
Bookmark+: extensions to standard library `bookmark.el'
Bookmark+: extensions to standard library `bookmark.el'.
The Bookmark+ libraries are these:
`bookmark+.el' - main (driver) library (this file)
`bookmark+-mac.el' - Lisp macros
`bookmark+-lit.el' - (optional) code for highlighting bookmarks
`bookmark+-bmu.el' - code for the `*Bookmark List*' (bmenu)
`bookmark+-1.el' - other required code (non-bmenu)
`bookmark+-key.el' - key and menu bindings
`bookmark+-doc.el' - documentation (comment-only file)
`bookmark+-chg.el' - change log (comment-only file)
The documentation (in `bookmark+-doc.el') includes how to
byte-compile and install Bookmark+. The documentation is also
available in these ways:
1. From the bookmark list (`C-x r l'):
Use `?' to show the current bookmark-list status and general
help, then click link `Doc in Commentary' or link `Doc on the
Web'.
2. From the Emacs-Wiki Web site:
https://www.emacswiki.org/emacs/BookmarkPlus.
3. From the Bookmark+ group customization buffer:
`M-x customize-group bookmark-plus', then click link
`Commentary'.
(The commentary links in #1 and #3 work only if you have library
`bookmark+-doc.el' in your `load-path'.)
To report Bookmark+ bugs: `M-x customize-group bookmark-plus'
and then follow (e.g. click) the link `Send Bug Report', which
helps you prepare an email to me.
****** NOTE ******
Whenever you update Bookmark+ (i.e., download new versions of
Bookmark+ source files), I recommend that you do the
following:
1. Delete all existing byte-compiled Bookmark+ files
(bookmark+*.elc).
2. Load Bookmark+ (`load-library' or `require').
3. Byte-compile the source files.
In particular, always load `bookmark+-mac.el' (not
`bookmark+-mac.elc') before you byte-compile new versions of
the files, in case there have been any changes to Lisp macros
(in `bookmark+-mac.el').
******************
****** NOTE ******
On 2010-06-18, I changed the prefix used by package Bookmark+
from `bookmarkp-' to `bmkp-'. THIS IS AN INCOMPATIBLE CHANGE.
I apologize for the inconvenience, but the new prefix is
preferable for a number of reasons, including easier
distinction from standard `bookmark.el' names.
This change means that YOU MUST MANUALLY REPLACE ALL
OCCURRENCES of `bookmarkp-' by `bmkp-' in the following
places, if you used Bookmark+ prior to this change:
1. In your init file (`~/.emacs') or your `custom-file', if
you have one. This is needed if you customized any
Bookmark+ features.
2. In your default bookmark file, `bookmark-default-file'
(`~/.emacs.bmk'), and in any other bookmark files you might
have.
3. In your `*Bookmark List*' state file,
`bmkp-bmenu-state-file' (`~/.emacs-bmk-bmenu-state.el').
4. In your `*Bookmark List*' commands file,
`bmkp-bmenu-commands-file' (`~/.emacs-bmk-bmenu-commands.el'),
if you have one.
You can do this editing in a virgin Emacs session (`emacs
-Q'), that is, without loading Bookmark+.
Alternatively, you can do this editing in an Emacs session
where Bookmark+ has been loaded, but in that case you must
TURN OFF AUTOMATIC SAVING of both your default bookmark file
and your `*Bookmark List*' state file. Otherwise, when you
quit Emacs your manually edits will be overwritten.
To turn off this automatic saving, you can use `M-~' and `M-l'
in buffer `*Bookmark List*' (commands
`bmkp-toggle-saving-bookmark-file' and
`bmkp-toggle-saving-menu-list-state' - they are also in the
`Bookmark+' menu).
Again, sorry for this inconvenience.
******************
Commands defined here:
`bmkp-version'.
Internal variables defined here:
`bmkp-version-number'.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3, or (at your option)
any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; see the file COPYING. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth
Floor, Boston, MA 02110-1301, USA.