Skip to content

Commit 8146fe3

Browse files
committed
docs(readme): tweaks
1 parent ecb6b6e commit 8146fe3

File tree

1 file changed

+16
-12
lines changed

1 file changed

+16
-12
lines changed

README.md

+16-12
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,8 @@ which key(s) you will need to press _before_ you actually need to do that.
2424
- After typing the first character, you see "labels" appearing next to some of
2525
the `{c1}{?}` pairs. You cannot _use_ the labels yet.
2626
- Enter `{c2}`. If the pair was not labeled, then voilà, you're already there.
27-
No need to be bothered by remaining labels, just continue editing.
27+
No need to be bothered by remaining labels - those are guaranteed "safe"
28+
letters -, just continue editing.
2829
- Else: select a label. In case of multiple groups, first switch to the desired
2930
one, using `<space>` (step back with `<tab>`, if needed).
3031

@@ -116,10 +117,10 @@ characters altogether to reach a given target.
116117
### Auxiliary principles
117118

118119
- Optimize for the common case, not the pathological: a good example of this is
119-
the Sneak-like "one-character labels in multiple groups"-approach, which can
120-
become awkward for, say, 200 targets, but eliminates all kinds of edge cases
121-
and implementation problems, and allows for features like
122-
[multiselect](#extending-leap).
120+
the Sneak-like "use strictly one-character labels, and switch between
121+
groups"-approach, which can become awkward for, say, 200 targets, but
122+
eliminates all kinds of edge cases and implementation problems, and allows
123+
for features like [multiselect](#extending-leap).
123124

124125
- [Sharpen the saw](http://vimcasts.org/blog/2012/08/on-sharpening-the-saw/):
125126
build on Vim's native interface, and aim for synergy as much as possible. The
@@ -433,18 +434,21 @@ Note that each of the forward motions are inclusive (`:h inclusive`), and the
433434
In this case, the matches are sorted by their screen distance from the cursor,
434435
advancing in concentric circles. The one default motion that works this way is
435436
`gs` (`<Plug>(leap-from-window)`), searching in all other windows on the tab
436-
page. To create custom motions like this, e.g. bidirectional search in the
437-
current window, see [Extending Leap](#extending-leap).
437+
page.
438+
439+
To create custom motions like this, e.g. bidirectional search in the current
440+
window, see [Extending Leap](#extending-leap).
438441

439442
#### Smart autojump
440443

441444
Leap automatically jumps to the first match if the remaining matches can be
442445
covered by a limited set of "safe" target labels (keys you would not use right
443-
after a jump), but stays in place, and switches to an extended, more
444-
comfortable label set otherwise (the trade-off becomes more and more acceptable
445-
as the number of targets increases, since the probability of aiming for the
446-
very first target becomes less and less). For fine-tuning, see `:h leap-config`
447-
(`labels` and `safe_labels`).
446+
after a jump), but stays in place, and switches to an extended label set
447+
otherwise. (The trade-off becomes more and more acceptable as the number of
448+
targets increases, since the probability of aiming for the very first target
449+
becomes less and less.)
450+
451+
For fine-tuning, see `:h leap-config` (`labels` and `safe_labels`).
448452

449453
#### Repeat and traversal
450454

0 commit comments

Comments
 (0)