History

Henrik Lissner 1abcf913aa revert: fix(docs): set mode in file-local vars emacs-straight/org-mode@e22b4eb7aa introduced a breaking change that made it impossible to rely on .dir-locals.el to change org-mode buffers in $EMACSDIR to doom-docs-org-mode (without infinite recursion), so we used file-local variables in `7e400ab`. emacs-straight/org-mode@215de6176b reverted that change, so we can use .dir-locals.el again, and this is my preference, since it requires less boilerplate across our hundreds of org files. Ref: emacs-straight/org-mode@215de6176b Ref: emacs-straight/org-mode@e22b4eb7aa Revert: `7e400abdc0`		2022-08-07 19:08:07 +02:00
..
config.el	fix(window-select): allow Switch Window to work with >6 windows	2022-06-17 18:38:39 +02:00
packages.el	bump: :ui	2022-03-31 21:08:31 +02:00
README.org	revert: fix(docs): set mode in file-local vars	2022-08-07 19:08:07 +02:00

README.org

:ui window-select

Description
- Maintainers
- Module flags
- Packages
- Hacks
- Changelog
Installation
Usage
Configuration
- ace-window
  - Custom font-face example
- switch-window
Troubleshooting
Frequently asked questions
Appendix

Description unfold

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. It is bound to C-x o (and C-w C-w for evil users).

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.

Maintainers

This module has no dedicated maintainers. Become a maintainer?

Module flags

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

Packages

Hacks

No hacks documented for this module.

TODO Changelog

This module does not have a changelog yet.

Installation

Enable this module in your doom! block.

This module has no external requirements.

TODO Usage

🔨 This module has no usage documentation yet. Write some?

TODO Configuration

🔨 This module's configuration documentation is incomplete. Complete it?

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 display characters are small and difficult to see (see below for a way to enlarge them).

Custom font-face example

This changes the ace-window display to show a white letter with a red background. The box attribute adds some padding:

(custom-set-faces!
  '(aw-leading-char-face
    :foreground "white" :background "red"
    :weight bold :height 2.5 :box (:line-width 10 :color "red")))

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.

Troubleshooting

There are no known problems with this module. Report one?

Frequently asked questions

This module has no FAQs yet. Ask one?

TODO Appendix

🔨 This module has no appendix yet. Write one?