5.21.1 Ispell Install

Simplified Install

If Casual is installed using package-install, then you can use casual-init to setup support for Ispell.

By default, casual-init will setup support for Ispell via the hook function casual-ispell-init which is included in the customizable variable casual-init-hook.

Use the command customize-variable on casual-init-hook to control inclusion of casual-ispell-init via a checkbox interface.

casual-init-hook treats the Transient menu casual-ispell-tmenu with a tertiary binding specified in the customizable variable casual-ispell-keybinding (default C-c s). casual-ispell-keybinding can be reconfigured to preference.

Refer to the Simplified Install (Install) section for more detail on customizing casual-init.

Casual makes opinionated decisions on the keybindings used in its menus. Such opinions are extended from said menus to the keymap(s) of a particular mode. For Ispell, this can be controlled via the customizable variable casual-ispell-add-extra-keybindings (default t).

Hook Install

Users who want a more granular install of Casual modules can invoke the hook function of interest in their Emacs initialization file.

(casual-ispell-init)

Manual Install

For users who have manually installed Casual outside of package-install, the following guidance is offered.

The primary interface for Casual Ispell is the Transient menu casual-ispell-tmenu. It is autoloaded ((elisp)Autoload) so if Casual is installed via package-install ((emacs)Package Installation) then casual-ispell-tmenu can be invoked via execute-extended-command (M-x) without need for modifying your Emacs initialization file.

If you already have Casual EditKit installed then access to the Transient casual-ispell-tmenu is available from casual-editkit-main-tmenu.

That said, Casual is designed with the intent of using a common (key)binding across multiple modes to lower cognitive load. This document uses the binding C-c s for this purpose, but can be changed to user preference.

casual-ispell-tmenu can also be bound to a mode of preference. Shown below is a recommended configuration to use in an initialization file to support the modes prog-mode, text-mode, bibtex, conf-mode.

(require 'prog-mode)
(require 'text-mode)
(require 'bibtex)
(require 'conf-mode)

(keymap-set prog-mode-map "C-c s" #'casual-ispell-tmenu)
(keymap-set text-mode-map "C-c s" #'casual-ispell-tmenu)
(keymap-set bibtex-mode-map "C-c s" #'casual-ispell-tmenu)
(keymap-set conf-mode-map "C-c s" #'casual-ispell-tmenu)

If lazy loading is desired then trying using eval-after-load:

(eval-after-load 'prog-mode
  (keymap-set prog-mode-map "C-c s" #'casual-ispell-tmenu))

The above configuration can be used as a template to support other modes.