This package has been superseded by the package casual. Please install the package casual from either MELPA or MELPA stable.
Upon installation and upgrade of casual, this package will be uninstalled from your Emacs configuration. Please revisit your configuration of Casual I-Search in your initialization file(s) accordingly.
This repository should be treated as an archive. All future development on Casual I-Search will be done in the Casual repository.
This package contains a Transient menu for I-Search. When in basic I-Search mode, this menu can be raised by pressing the C-o key. A menu of different isearch commands will be offered as shown below:
Casual I-Search requires usage of
- Emacs ≥ 29.1
- Casual Lib ≥ 1.1.0
Use the following lines to install casual-isearch-tmenu.
(require 'casual-isearch)
(keymap-set isearch-mode-map "C-o" #'casual-isearch-tmenu)Alternately install with use-package using the following initialization:
(use-package casual-isearch
:ensure t
:bind (:map isearch-mode-map ("C-o" . casual-isearch-tmenu)))The keybinding to casual-isearch-tmenu can be changed to user preference.
Casual I-Search requires Casual Lib which in turn requires a recent installation of Transient 0.6.0+ from either ELPA or MELPA. As an older version of Transient is built-in to the Emacs release, the package manager package.el will not update this package unless the customizable variable package-install-upgrade-built-in is set to t. Set this variable and proceed with installing Casual I-Search. Alternately invoking package-install with a prefix (C-u) will temporarily coerce the update of the built-in package. (example: C-u M-x package-install casual-isearch)
As Transient is closely tied to Magit, installing the latest version of Magit (via non-GNU ELPA or MELPA) before installing Casual I-Search can also pick up the latest version of Transient.
The following I-Search commands are grouped as follows in the Transient menu casual-isearch-tmenu. Keys associated with each command are shown enclosed in parentheses.
isearch-edit-string(e)isearch-yank-word-or-char(w)isearch-yank-symbol-or-char(s)isearch-yank-line(l)isearch-yank-kill(y)isearch-forward-thing-at-point(t)
isearch-query-replace(r)isearch-query-replace-regexp(x)
isearch-toggle-regexp(X)isearch-toggle-symbol(S)isearch-toggle-word(W)isearch-toggle-case-fold(F)isearch-toggle-lax-whitespace(L)
isearch-occur(o)isearch-highlight-regexp(h)isearch-highlight-lines-matching-regexp(H)unhighlight-regexp(u)
isearch-repeat-forward(n)isearch-repeat-backward(p)
To exit search, press the RET key. This will leave the point at the last successful search item.
When in search mode (typically via the keybinding C-s or C-r), pressing the keybinding C-o (or binding of your preference) will raise the Transient menu casual-isearch-tmenu. Once raised, only the I-Search commands in the Replace and Misc sections will automatically dismiss the menu when selected. All other I-Search commands will not dismiss the menu.
Note that editing the search text via isearch-edit-string will enter a recursive editing mode that is normally exited when pressing the return (RET) key.
Use C-g to dismiss this Transient menu.
Casual I-Search is part of a suite of user interfaces for different Emacs packages called Casual Suite.
Different interfaces include those for Dired, Info, Calc, Bookmarks, RE-Builder, IBuffer, and others. Learn more about them today!
If you enjoy using Casual I-Search, consider making a modest financial contribution to help support its development and maintenance.
