Synopsis
Are you tired of using the endless keystrokes of C-y M-y M-y M-y ... to get
at that bit of text you killed thirty-seven kills ago? Ever wish you could just
look through everything you've killed recently to find out if you killed that
piece of text that you think you killed, but you're not quite sure? If so, then
browse-kill-ring
is the Emacs extension for you.
Installation
Manual
Just drop browse-kill-ring.el
somewhere in your load-path
. The
folder ~/.emacs.d/vendor
is a popular choice:
(add-to-list 'load-path "~/emacs.d/vendor")
(require 'browse-kill-ring)
Marmalade
If you're an Emacs 24 user or you have a recent version of package.el you can install browse-kill-ring from the Marmalade repository.
MELPA
If you're an Emacs 24 user or you have a recent version of package.el you can install browse-kill-ring from the MELPA repository.
el-get
If you prefer el-get, you can install browse-kill-ring with M-x el-get-install.
Emacs Prelude
browse-kill-ring
is naturally part of the
Emacs Prelude. If you're a Prelude
user - browse-kill-ring
is already properly configured and ready for
action.
Usage
Just do M-x browse-kill-ring
.
Optionally, you can map M-y to browse-kill-ring
by adding the form
(browse-kill-ring-default-keybindings)
to your ~/.emacs
.
Alternatively you can map browse-kill-ring
to another key combination,
for example (global-set-key "\C-cy" 'browse-kill-ring)
.
Additional Configuration
The browse-kill-ring
package can be customized through the usual emacs customization interface using M-x customize-group <RET> browse-kill-ring <RET>
. The following list contains some of the interesting configuration variables:
-
Setting
browse-kill-ring-highlight-current-entry
tot
will cause the item in the*Kill Ring*
that will be inserted, to be highlighted. -
Setting
browse-kill-ring-highlight-inserted-item
to non-nil will cause the item that has just been inserted to be highlighted. Possible values to which this variable can be set arenil
,pulse
,solid
, ort
. The valuenil
turns highlighting off, the valuepulse
uses thepulse
library fromcedet
(which is a part of recent emacs versions) to highlight the inserted item then fade the highlighting out over a short period of time. The valuesolid
highlights the inserted item in a fixed face for a short period of time. The valuet
will use the default style for highlighting the inserted item, this is currentlypulse
. -
The variable
browse-kill-ring-separator
is the string that is placed between items in the*Kill Ring*
buffer between entries. -
The variable
browse-kill-ring-separator-face
contains the face used for the separator in the*Kill Ring*
buffer. -
Setting
browse-kill-ring-show-preview
tot
will cause a preview of the item under point in the*Kill Ring*
buffer to be displayed in the original buffer where the item would be inserted.
Known issues
Check out the project's issue list a list of unresolved issues. By the way - feel free to fix any of them and send a pull request. :-)
History
Originally written by Colin Walters (Debian Developer, Emacs hacker, SELinux hacker, and general Free Software Guru Extrordinaire). After that maintained by Nick Hurley. Unfortunately he had to abandon Emacs and this organisation account was created at Github. Feel free to issue pull requests.
Contributors
Here's a list of all the people who have contributed to the development of browse-kill-ring.
Bugs & Improvements
Bug reports and suggestions for improvements are always welcome. GitHub pull requests are even better! :-)