Mercurial > emacs
comparison lisp/ChangeLog @ 111851:dd83cbcddf69
Adjust parameter names and doc strings to resolve confusion over
whether "bookmark" meant a bookmark name or a bookmark record.
Along the way, shorten one function's name for similar reasons.
(Issue #7548)
* lisp/bookmark.el
(bookmark-name-from-record):
New name for `bookmark-name-from-full-record'. All callers changed.
(bookmark-get-bookmark, bookmark-get-bookmark-record,
bookmark-default-annotation-text, bookmark-prop-get, bookmark-prop-set,
bookmark-get-annotation, bookmark-set-annotation,
bookmark-get-filename, bookmark-set-filename,
bookmark-get-position, bookmark-set-position,
bookmark-get-front-context-string, bookmark-set-front-context-string,
bookmark-get-rear-context-string, bookmark-set-rear-context-string,
bookmark-get-handler, bookmark-edit-annotation, bookmark--jump-via,
bookmark-handle-bookmark, bookmark-location, bookmark-show-annotation):
Rename `bookmark' parameter to `bookmark-name-or-record', to
clearly show its role, and shorten or adjust doc strings accordingly.
(bookmark-set-name):
Same, and pass the parameter directly to `bookmark-get-bookmark'
instead of redundantly doing the callee's work.
(bookmark-default-annotation-text, bookmark-send-edited-annotation,
bookmark-relocate, bookmark-insert-location, bookmark-insert,
bookmark-delete):
Rename `bookmark' parameter to `bookmark-name', and in some cases
shorten doc string accordingly.
(bookmark-rename):
Change `old' and `new' parameters to `old-name'
and `new-name', and adjust an internal variable to avoid confusion.
(bookmark-jump, bookmark-jump-noselect):
Clarify `bookmark' parameter in doc string.
| author | Karl Fogel <kfogel@red-bean.com> |
|---|---|
| date | Wed, 08 Dec 2010 03:09:27 -0500 |
| parents | f2a5b5a7f017 |
| children | 1d5b34014445 |
comparison
equal
deleted
inserted
replaced
| 111850:f2a5b5a7f017 | 111851:dd83cbcddf69 |
|---|---|
| 1 2010-12-08 Karl Fogel <kfogel@red-bean.com> | |
| 2 | |
| 3 * bookmark.el: Adjust parameter names and doc strings to resolve | |
| 4 confusion over whether "bookmark" meant a bookmark name or a | |
| 5 bookmark record. Along the way, shorten one function's name for | |
| 6 similar reasons. (Issue #7548) | |
| 7 (bookmark-name-from-record): New name for | |
| 8 `bookmark-name-from-full-record'. All callers changed. | |
| 9 (bookmark-get-bookmark, bookmark-get-bookmark-record) | |
| 10 (bookmark-default-annotation-text, bookmark-prop-get, bookmark-prop-set) | |
| 11 (bookmark-get-annotation, bookmark-set-annotation) | |
| 12 (bookmark-get-filename, bookmark-set-filename) | |
| 13 (bookmark-get-position, bookmark-set-position) | |
| 14 (bookmark-get-front-context-string, bookmark-set-front-context-string) | |
| 15 (bookmark-get-rear-context-string, bookmark-set-rear-context-string) | |
| 16 (bookmark-get-handler, bookmark-edit-annotation, bookmark--jump-via) | |
| 17 (bookmark-handle-bookmark, bookmark-location, bookmark-show-annotation): | |
| 18 Rename `bookmark' parameter to `bookmark-name-or-record', to | |
| 19 clearly show its role, and shorten or adjust doc strings accordingly. | |
| 20 (bookmark-set-name): Same, and pass the parameter directly to | |
| 21 `bookmark-get-bookmark' instead of redundantly doing the callee's work. | |
| 22 (bookmark-default-annotation-text, bookmark-send-edited-annotation) | |
| 23 (bookmark-relocate, bookmark-insert-location, bookmark-insert) | |
| 24 (bookmark-delete): Rename `bookmark' parameter to `bookmark-name', | |
| 25 and in some cases shorten doc string accordingly. | |
| 26 (bookmark-rename): Change `old' and `new' parameters to `old-name' | |
| 27 and `new-name', and adjust an internal variable to avoid confusion. | |
| 28 (bookmark-jump, bookmark-jump-noselect): Clarify `bookmark' | |
| 29 parameter in doc string. | |
| 30 | |
| 1 2010-12-08 Glenn Morris <rgm@gnu.org> | 31 2010-12-08 Glenn Morris <rgm@gnu.org> |
| 2 | 32 |
| 3 * progmodes/gdb-mi.el (gdb): Try to initialize comint input history | 33 * progmodes/gdb-mi.el (gdb): Try to initialize comint input history |
| 4 from gdb's history file. (Bug#7575) | 34 from gdb's history file. (Bug#7575) |
| 5 | 35 |