doomemacs/modules/ui/window-select/README.org
Henrik Lissner 77e4cc4d58
💥 Remove :feature category
:feature was a "catch-all" category. Many of its modules fit better in
other categories, so they've been moved:

- feature/debugger -> tools/debugger
- feature/evil -> editor/evil
- feature/eval -> tools/eval
- feature/lookup -> tools/lookup
- feature/snippets -> editor/snippets
- feature/file-templates -> editor/file-templates
- feature/workspaces -> ui/workspaces

More potential changes in the future:

- A new :term category for terminal emulation modules (eshell, term and
  vterm).
- A new :os category for modules dedicated to os-specific functionality.
  The :tools macos module would fit here, but so would modules for nixos
  and arch.
- A new :services category for web-service integration, like wakatime,
  twitter, elfeed, gist and pastebin services.
2019-04-24 18:16:04 -04:00

45 lines
1.4 KiB
Org Mode

#+TITLE: :ui window-select
This module provides the user with a visual way to switch windows. By default, the module only kicks in if there are more than two windows open at the same time.
* Table of Contents :TOC:
- [[#install][Install]]
- [[#module-flags][Module flags]]
- [[#usage][Usage]]
- [[#configuration][Configuration]]
- [[#ace-window][ace-window]]
- [[#switch-window][switch-window]]
* Install
Add =:tools lookup= to your init.el.
** Module flags
This module provides two flags:
+ ~+ace-window~ Use avy (and ace-window) as the backend.
+ ~+switch-window~ Use switch-window as the backend.
If neither flag is specified, ~+ace-window~ will be used.
* Usage
This module remaps the function ~other-window~ 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~.
* 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.