This package allows to replace GUI popup menu (created by x-popup-menu by default) with little temporary window (like that in which Dired shows you files you want to copy). In this window, menu items are displayed and labeled with one or two letters. You press a key corresponding to desired choice (or C-g) and you are done.

Download this package and place it somewhere, so Emacs can see it. Then put (require 'ace-popup-menu) into your configuration file. Done!

In order to replace standard behavior of x-popup-menu, activate ace-popup-menu-mode in your configuration file, like this:

(ace-popup-menu-mode 1)

You can toggle/activate it either interactively or via Lisp, the mode follows all usual Emacs Lisp conventions for minor modes, except it's always global (because it doesn't make any sense to replace behavior of x-popup-menu only for in some specific buffer). See documentation for ace-popup-menu-mode for more information.

You can use the enhanced menu directly via ace-popup-menu too. To use it you don't need to enable the minor mode. See documentation of the function for detailed information.

You can ask Ace Popup Menu to show headers of individual panes (they are not shown in original GUI popup menu):

(setq ace-popup-menu-show-pane-header t)

This variable can be changed via «customize» interface too.

Here is something you may want to know:

• Original x-popup-menu can take menu argument in form of keymap or list of keymaps. This is currently not supported. If you encounter a situation when this breaks something, please open an issue. Describe how to reproduce your problem and I'll fix it.

• Some packages, like flyspell may test if they work under X-window system and refuse to call x-popup-menu if they think it's unavailable. There is nothing I can do about it, so it may be hard to use Ace Popup Menu in terminal, even though it's perfectly capable of functioning there.

• Currently only horizontal format of menu items is available. This is because it's much easier to implement. This should not be a problem, though.

Copyright © 2015 Mark Karpov

Distributed under GNU GPL, version 3.