doomemacs/modules/ui/window-select/README.org

ui/window-select

• Table of Contents
• Description
  • Module Flags
  • Packages
• Prerequisites
• Features
• Configuration
  • ace-window
  • switch-window

Table of Contents   TOC

• Description

  • Module Flags
  • Packages
• Prerequisites
• Features

• Configuration

  • ace-window
  • switch-window

Description

This module provides several methods for selecting windows without the use of the mouse or spatial navigation (e.g. C-w {h,j,k,l}). The command other-window is remapped to either switch-window or ace-window, depending on which backend you've enabled.

other-window is bound to C-x o and SPC w o.

It also provides numbered windows and selection with the winum package, if desired. Evil users can jump to window N in C-w <N> (where N is a number between 0 and 9). Non evil users have C-x w <N> instead.

Module Flags

• +switch-window Use the switch-window package as the backend, instead of ace-window (avy).
• +numbers Enable numbered windows and window selection (using winum).

Packages

• switch-window (if +switch-window)
• ace-window (if +switch-window isn't enabled)
• winum (if +numbers)

Prerequisites

This module has no additional dependencies.

TODO Features

Configuration

This module provides two backends, both providing the same functionality, but with different visual cues. They are ace-window and switch-window.

ace-window

The first character of the buffers changes to a highlighted, user-selectable character.

• Pros: the content of the buffers are always visible.
• Cons: The displayed characters are small and difficult to see.

switch-window

Replaces the entire buffer with large letters.

• Pros: The displayed characters are really easy to see.
• Cons: You can't see the contents of the buffers.