Update tcell to include true color fix

[micro.git] / runtime / help / keybindings.md

diff --git a/runtime/help/keybindings.md b/runtime/help/keybindings.md
index 661c02fa85a55b8413843264739fc4bdfcc1a07d..305e04a8c0ca93f60e451d3ffc4ade795c49276d 100644 (file)
--- a/runtime/help/keybindings.md
+++ b/runtime/help/keybindings.md
@@ -5,7 +5,7 @@ hotkeys are fully customizable to your liking.
 
 Custom keybindings are stored internally in micro if changed with the `> bind`
 command or you can also be added in the file `~/.config/micro/bindings.json` as
 
 Custom keybindings are stored internally in micro if changed with the `> bind`
 command or you can also be added in the file `~/.config/micro/bindings.json` as

-discussed below.  For a list of the default keybindings in the json format used
+discussed below. For a list of the default keybindings in the json format used

 by micro, please see the end of this file. For a more user-friendly list with
 explanations of what the default hotkeys are and what they do, please see
 `> help defaultkeys` (a json formatted list of default keys is included
 by micro, please see the end of this file. For a more user-friendly list with
 explanations of what the default hotkeys are and what they do, please see
 `> help defaultkeys` (a json formatted list of default keys is included


@@ -20,7 +20,6 @@ cursor the start and end of the buffer.
 
 You can hold shift with all of these movement actions to select while moving.
 
 
 You can hold shift with all of these movement actions to select while moving.
 

-

 ## Rebinding keys
 
 The bindings may be rebound using the `~/.config/micro/bindings.json` file. Each
 ## Rebinding keys
 
 The bindings may be rebound using the `~/.config/micro/bindings.json` file. Each


@@ -48,6 +47,21 @@ save and quit you can bind it like so:
 }
 ```
 
 }
 ```
 

+Each action will return a success flag. Actions can be chained such that
+the chain only continues when there are successes, or failures, or either.
+The `,` separator will always chain to the next action. The `|` separator
+will abort the chain if the action preceding it succeeds, and the `&` will
+abort the chain if the action preceding it fails. For example, in the default
+bindings, tab is bound as
+
+```
+"Tab": "Autocomplete|IndentSelection|InsertTab"
+```
+
+This means that if the `Autocomplete` action is successful, the chain will abort.
+Otherwise, it will try `IndentSelection`, and if that fails too, it will
+execute `InsertTab`.
+

 ## Binding commands
 
 You can also bind a key to execute a command in command mode (see 
 ## Binding commands
 
 You can also bind a key to execute a command in command mode (see 


@@ -120,12 +134,10 @@ You can do this in linux using the loadkeys program.
 
 Coming soon!
 
 
 Coming soon!
 

-

 ## Unbinding keys
 
 It is also possible to disable any of the default key bindings by use of the 
 ## Unbinding keys
 
 It is also possible to disable any of the default key bindings by use of the 

-`UnbindKey` action in the user's `bindings.json` file.
-
+`None` action in the user's `bindings.json` file.

 
 ## Bindable actions and bindable keys
 
 
 ## Bindable actions and bindable keys
 


@@ -222,8 +234,9 @@ SpawnMultiCursorSelect
 RemoveMultiCursor
 RemoveAllMultiCursors
 SkipMultiCursor
 RemoveMultiCursor
 RemoveAllMultiCursors
 SkipMultiCursor

-UnbindKey
+None

 JumpToMatchingBrace
 JumpToMatchingBrace

+Autocomplete

 ```
 
 You can also bind some mouse actions (these must be bound to mouse buttons)
 ```
 
 You can also bind some mouse actions (these must be bound to mouse buttons)


@@ -410,8 +423,8 @@ MouseWheelRight
     "Backspace":      "Backspace",
     "Alt-CtrlH":      "DeleteWordLeft",
     "Alt-Backspace":  "DeleteWordLeft",
     "Backspace":      "Backspace",
     "Alt-CtrlH":      "DeleteWordLeft",
     "Alt-Backspace":  "DeleteWordLeft",

-    "Tab":            "IndentSelection,InsertTab",
-    "Backtab":        "OutdentSelection,OutdentLine",
+    "Tab":            "Autocomplete|IndentSelection|InsertTab",
+    "Backtab":        "OutdentSelection|OutdentLine",

     "CtrlO":          "OpenFile",
     "CtrlS":          "Save",
     "CtrlF":          "Find",
     "CtrlO":          "OpenFile",
     "CtrlS":          "Save",
     "CtrlF":          "Find",


@@ -434,9 +447,12 @@ MouseWheelRight
     "CtrlEnd":        "CursorEnd",
     "PageUp":         "CursorPageUp",
     "PageDown":       "CursorPageDown",
     "CtrlEnd":        "CursorEnd",
     "PageUp":         "CursorPageUp",
     "PageDown":       "CursorPageDown",

+    "CtrlPageUp":     "PreviousTab",
+    "CtrlPageDown":   "NextTab",

     "CtrlG":          "ToggleHelp",
     "CtrlG":          "ToggleHelp",

+    "Alt-g":          "ToggleKeyMenu",

     "CtrlR":          "ToggleRuler",
     "CtrlR":          "ToggleRuler",

-    "CtrlL":          "JumpLine",
+    "CtrlL":          "command-edit:goto ",

     "Delete":         "Delete",
     "CtrlB":          "ShellMode",
     "CtrlQ":          "Quit",
     "Delete":         "Delete",
     "CtrlB":          "ShellMode",
     "CtrlQ":          "Quit",


@@ -444,6 +460,7 @@ MouseWheelRight
     "CtrlW":          "NextSplit",
     "CtrlU":          "ToggleMacro",
     "CtrlJ":          "PlayMacro",
     "CtrlW":          "NextSplit",
     "CtrlU":          "ToggleMacro",
     "CtrlJ":          "PlayMacro",

+    "Insert":         "ToggleOverwriteMode",

 
     // Emacs-style keybindings
     "Alt-f": "WordRight",
 
     // Emacs-style keybindings
     "Alt-f": "WordRight",


@@ -452,7 +469,6 @@ MouseWheelRight
     "Alt-e": "EndOfLine",
 
     // Integration with file managers
     "Alt-e": "EndOfLine",
 
     // Integration with file managers

-    "F1":  "ToggleHelp",

     "F2":  "Save",
     "F3":  "Find",
     "F4":  "Quit",
     "F2":  "Save",
     "F3":  "Find",
     "F4":  "Quit",


@@ -467,12 +483,11 @@ MouseWheelRight
     "MouseMiddle":    "PastePrimary",
     "Ctrl-MouseLeft": "MouseMultiCursor",
 
     "MouseMiddle":    "PastePrimary",
     "Ctrl-MouseLeft": "MouseMultiCursor",
 

-    // Multiple cursors bindings

     "Alt-n": "SpawnMultiCursor",
     "Alt-m": "SpawnMultiCursorSelect",
     "Alt-p": "RemoveMultiCursor",
     "Alt-c": "RemoveAllMultiCursors",
     "Alt-n": "SpawnMultiCursor",
     "Alt-m": "SpawnMultiCursorSelect",
     "Alt-p": "RemoveMultiCursor",
     "Alt-c": "RemoveAllMultiCursors",

-    "Alt-x": "SkipMultiCursor",
+    "Alt-x": "SkipMultiCursor"

 }
 ```
 
 }
 ```
 


@@ -486,3 +501,9 @@ Additionally, alt keys can be bound by using `Alt-key`. For example `Alt-a` or
 `Ctrl` so `Alt-a` could be rewritten as `Alta` (case matters for alt bindings).
 This is why in the default keybindings you can see `AltShiftLeft` instead of
 `Alt-ShiftLeft` (they are equivalent).
 `Ctrl` so `Alt-a` could be rewritten as `Alta` (case matters for alt bindings).
 This is why in the default keybindings you can see `AltShiftLeft` instead of
 `Alt-ShiftLeft` (they are equivalent).

+
+Please note that terminal emulators are strange applications and micro only receives
+key events that the terminal decides to send. Some terminal emulators may not
+send certain events even if this document says micro can receive the event. To see
+exactly what micro receives from the terminal when you press a key, run the `> raw`
+command.