summaryrefslogtreecommitdiff
path: root/contrib
diff options
context:
space:
mode:
authorAlbin Otterhäll <github@inquisitive.se>2018-04-28 14:37:04 +0200
committerAlbin Otterhäll <github@inquisitive.se>2018-04-29 10:04:22 +0200
commitb9cc0d94a9030e7af09aed8cb3461782ca8dc35b (patch)
tree0687a9071bb61dfe0c3be93e10dc1b1eaffc0646 /contrib
parent3afa32935f93d1b56c21e1800a5b006d31d2bc5a (diff)
Small improvements of TRAMPOLINE
Diffstat (limited to 'contrib')
-rw-r--r--contrib/TRAMPOLINE23
1 files changed, 12 insertions, 11 deletions
diff --git a/contrib/TRAMPOLINE b/contrib/TRAMPOLINE
index 494bfa0f..47f49d0b 100644
--- a/contrib/TRAMPOLINE
+++ b/contrib/TRAMPOLINE
@@ -9,11 +9,11 @@
Mawww's experiment for a better code editor
+=----------------------------------------------------------------------------=+
-This walk-through is an introduction to Kakoune's basic edition capabilities
+This walk-through is an introduction to Kakoune's basic editing capabilities
to help new users transition over easily from another editor, or simply
learn how to write and edit documents with style.
-In the first section, you will learn about the primitives of the edition
+In the first section, you will learn about the primitives of the editing
language to be able to get to a level of knowledge of the editor that
guarantees that you can work with it efficiently.
@@ -31,22 +31,23 @@ using the built-in `:doc` command.
=[ MODES
- Kakoune uses a paradigm called "modal edition" to allow
+ Kakoune uses a paradigm called "modal editing" to allow
.---, users to either have every single key they type inserted
| i | into the file being edited (called "insert mode"),
`---' or execute commands that are triggered by the keys hit
(the "normal mode"). Aside from arrow keys, most keys
- .---, described in this document are "edition primitives" that
- |esc| have to be hit in command mode, which is the default mode
+ .---, described in this document are "editing primitives" that
+ |esc| have to be hit in normal mode, which is the default mode
`---' when you start the editor. To enter insert mode, hit the
- `i` key, and to leave it, hit the escape key.
+ `i` key, and to leave it and return to normal mode, hit the
+ escape key.
=[ MOVEMENT
.---,
- | ^ | Movement in a buffer (the representation of the contents
+ | ↑ | Movement in a buffer (the representation of the contents
.---'---'---, of a file opened by Kakoune) can be achieved using the arrow
- | < | v | > | keys, which will move the cursor up one column/row into
+ | ← | ↓ | → | keys, which will move the cursor up one column/row into
`---'---'---` a given direction.
However, furthering the tradition of mode-based editors,
@@ -55,7 +56,7 @@ using the built-in `:doc` command.
`---'---'---'---` left, down, up, right by one, when hit. Using those keys
| | | | is the recommended way of moving around in a buffer.
.---,---,---,---, If you're not familiar with this concept, the proximity
- | < | V | ^ | > | of those four keys with the rest of the lettered keys
+ | ← | ↓ | ↑ | → | of those four keys with the rest of the lettered keys
`---'---'---'---` on a `qwerty` layout allows faster interaction with the
primitives than if the user had to moves their hand to
.---, reach the arrow keys.
@@ -124,7 +125,7 @@ using the built-in `:doc` command.
"cursor" by introducing selections, but it also allows
.---, multiple selections within the same buffer. This makes
| % | it very convenient to modify text in multiple locations
- `---' at once, as edition primitives apply to all the currently
+ `---' at once, as editing primitives apply to all the currently
selected text.
.---,
| s | Example: to remove all occurrences of the word "foo", one
@@ -341,7 +342,7 @@ using the built-in `:doc` command.
Despite the ability to select bits of data using regular
expressions, there are times when using them isn't enough,
- and additional manual edition of the selections is
+ and additional manual editing of the selections is
.---, needed. In order to loop through all the selections and
| ) | remove the current one, two primitives are available:
`---' respectively the parenthesis (`)`), and the alt/space