[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] master 752c2cc 37/68: README.md: update
From: |
Oleh Krehel |
Subject: |
[elpa] master 752c2cc 37/68: README.md: update |
Date: |
Sat, 21 Mar 2015 19:07:00 +0000 |
branch: master
commit 752c2cc1ee635bb88a9a1627de1f0bb605962510
Author: Oleh Krehel <address@hidden>
Commit: Oleh Krehel <address@hidden>
README.md: update
---
README.md | 40 ++++++++++++++++++++++++++++++++--------
1 files changed, 32 insertions(+), 8 deletions(-)
diff --git a/README.md b/README.md
index 357aa71..1b2f808 100644
--- a/README.md
+++ b/README.md
@@ -19,14 +19,14 @@ and pack it into a single key binding, similar to
`other-window`.
## Setup
Just assign `ace-window` to a short key binding, as switching windows
-is a common task. I suggest **M-p** as it's short and not bound in the
-default Emacs.
+is a common task. I suggest <kbd>M-p</kbd>, as it's short and not
+bound in the default Emacs.
## Usage
When there are two windows, `ace-window` will call `other-window`. If
there are more, each window will have its first character highlighted.
-Pressing that character will switch to that window. Note that unlike
+Pressing that character will switch to that window. Note that, unlike
`ace-jump-mode`, the point position will not be changed: it's the same
behavior as that of `other-window`.
@@ -35,20 +35,44 @@ you remember your window layouts, you can switch windows
without even
looking at the leading char. For instance, the top left window will
always be `1`.
+`ace-window` works across multiple frames, as you can see from the
+[in-action gif](http://oremacs.com/download/ace-window.gif).
+
## Swap and delete window
-You can swap windows by calling `ace-window` with a prefix argument **C-u**.
+- You can swap windows by calling `ace-window` with a prefix argument
<kbd>C-u</kbd>.
-You can delete the selected window by calling `ace-window` with a double prefix
-argument, i.e. **C-u C-u**.
+- You can delete the selected window by calling `ace-window` with a double
prefix argument, i.e. <kbd>C-u C-u</kbd>.
## Customization
+Aside from binding `ace-window`:
+
+ (global-set-key (kbd "M-p") 'ace-window)
-Aside from binding `ace-window`, maybe you'd like to customize
+maybe you'd like the following customizations:
+
+### `aw-keys`
`aw-keys` - the sequence of leading characters for each window:
- (global-set-key (kbd "M-p") 'ace-window)
(setq aw-keys '(?a ?s ?d ?f ?g ?h ?j ?k ?l))
`aw-keys` are 0-9 by default, which is reasonable, but in the setup
above, the keys are on the home row.
+
+### `aw-scope`
+The default one is `global`, which means that `ace-window` will work
+across frames. If you set this to `frame`, `ace-window` will offer you
+the windows only on current frame.
+
+### `aw-background`
+
+By default, `ace-window` temporarily sets a gray background and
+removes color from available windows in order to make the
+window-switching characters more visible. This is the behavior
+inherited from `ace-jump-mode`.
+
+This behavior might not be necessary, as you already know the locations
+where to look, i.e. the top-left corners of each window.
+So you can turn off the gray background with:
+
+ (setq aw-background nil)
- [elpa] master b7b8e72 28/68: ace-window.el (aw-list-visual-area): improve, (continued)
- [elpa] master b7b8e72 28/68: ace-window.el (aw-list-visual-area): improve, Oleh Krehel, 2015/03/21
- [elpa] master f7001fb 33/68: ace-window.el (aw-background): new custom, Oleh Krehel, 2015/03/21
- [elpa] master 038a426 31/68: ace-window.el: whitespace, Oleh Krehel, 2015/03/21
- [elpa] master c8d7ae1 21/68: ace-window.el: change version to 0.3.0, Oleh Krehel, 2015/03/21
- [elpa] master 5fb2caf 36/68: ace-window.el: mark two customs as boolean, Oleh Krehel, 2015/03/21
- [elpa] master 3a06c99 35/68: ace-window.el (aw--doit): fix conflict with helm, Oleh Krehel, 2015/03/21
- [elpa] master db5763f 32/68: ace-window.el (aw-swap-window): improve, Oleh Krehel, 2015/03/21
- [elpa] master 22ebc3a 34/68: ace-window.el (aw--doit): use map with most priority, Oleh Krehel, 2015/03/21
- [elpa] master e03ceb9 30/68: ace-window.el: remove aw-generic macro, Oleh Krehel, 2015/03/21
- [elpa] master 8d40101 39/68: ace-window.el (ace-window-end-hook): add, Oleh Krehel, 2015/03/21
- [elpa] master 752c2cc 37/68: README.md: update,
Oleh Krehel <=
- [elpa] master b86d163 40/68: ace-window.el (ace-window-end-once-hook): Add, Oleh Krehel, 2015/03/21
- [elpa] master 6becad8 38/68: ace-window.el: bump version, Oleh Krehel, 2015/03/21
- [elpa] master bb9da9c 44/68: Update `aw--doit' signature, Oleh Krehel, 2015/03/21
- [elpa] master 352c33a 43/68: Finalize transition to `read-char', Oleh Krehel, 2015/03/21
- [elpa] master 32911db 42/68: Start transition to `read-char', Oleh Krehel, 2015/03/21
- [elpa] master 50fafc5 45/68: ace-window.el (aw--doit): don't show anything in echo area, Oleh Krehel, 2015/03/21
- [elpa] master 4291989 41/68: ace-window.el (ace-maximize-window): Add, Oleh Krehel, 2015/03/21
- [elpa] master 064c4fb 49/68: ace-window.el (aw-select): Rename from `aw--doit', Oleh Krehel, 2015/03/21
- [elpa] master b351b51 48/68: Clean up code, Oleh Krehel, 2015/03/21
- [elpa] master 4570578 46/68: ace-window.el (aw--doit): simplify, Oleh Krehel, 2015/03/21