]> code.delx.au - gnu-emacs/commitdiff
Document 'bookmark-set-no-overwrite'
authorEli Zaretskii <eliz@gnu.org>
Sat, 5 Dec 2015 12:21:00 +0000 (14:21 +0200)
committerEli Zaretskii <eliz@gnu.org>
Sat, 5 Dec 2015 12:21:00 +0000 (14:21 +0200)
* doc/emacs/regs.texi (Bookmarks): Document the new command
'bookmark-set-no-overwrite' and its keybinding.

doc/emacs/regs.texi
etc/NEWS

index d8841caa311e0e6f2ad0287a332a61144db93499..13c03f78a52217a5dc5ad19996ad97209bc3d33f 100644 (file)
@@ -293,9 +293,11 @@ various files.
 Set the bookmark for the visited file, at point.
 
 @item C-x r m @var{bookmark} @key{RET}
-@findex bookmark-set
 Set the bookmark named @var{bookmark} at point (@code{bookmark-set}).
 
+@item C-x r M @var{bookmark} @key{RET}
+Like @kbd{C-x r m}, but don't overwrite an existing bookmark.
+
 @item C-x r b @var{bookmark} @key{RET}
 @findex bookmark-jump
 Jump to the bookmark named @var{bookmark} (@code{bookmark-jump}).
@@ -320,6 +322,12 @@ name.  If you name each bookmark after the file it points to, then you
 can conveniently revisit any of those files with @kbd{C-x r b}, and move
 to the position of the bookmark at the same time.
 
+@kindex C-x r M
+@findex bookmark-set-no-overwrite
+  The command @kbd{C-x r M} (@code{bookmark-set-no-overwrite}) works
+like @kbd{C-x r m}, but it signals an error if the specified bookmark
+already exists, instead of overwriting it.
+
 @kindex C-x r l
   To display a list of all your bookmarks in a separate buffer, type
 @kbd{C-x r l} (@code{list-bookmarks}).  If you switch to that buffer,
index 482db099d6b253a17adff1ba30089294d847edbb..e3638b4f8040d804210a37bc57755f149d87d169 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -305,6 +305,7 @@ current package keywords are recognized.  Set the new option
 It's meant for use together with `compile':
 emacs -batch --eval "(checkdoc-file \"subr.el\")"
 
++++
 ** New function `bookmark-set-no-overwrite' bound to C-x r M.
 It raises an error if a bookmark of that name already exists,
 unlike `bookmark-set' which silently updates an existing bookmark.