Skip to content

Latest commit

 

History

History
101 lines (70 loc) · 3.95 KB

README.md

File metadata and controls

101 lines (70 loc) · 3.95 KB
Raw

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 to t 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 are nil, pulse, solid, or t. The value nil turns highlighting off, the value pulse uses the pulse library from cedet (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 value solid highlights the inserted item in a fixed face for a short period of time. The value t will use the default style for highlighting the inserted item, this is currently pulse.

  • 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 to t 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! :-)