diff --git a/runtime/help/help.md b/runtime/help/help.md index 39be5d80..7ee81a7d 100644 --- a/runtime/help/help.md +++ b/runtime/help/help.md @@ -1,26 +1,25 @@ # Micro help text -Micro is a terminal-based text editor that aims to be easy to use and -intuitive, while also taking advantage of the full capabilities of modern -terminals. +Micro is an easy to use, intuitive, text editor that takes advantage of the +full capabilities of modern terminals. -To open the command bar, press Ctrl-e. This enables a `>` prompt for typing -commands. From now on when the documentation says to run a command such as `> -help`, this means press Ctrl-e and type `help` (and press enter to execute the -command). +Micro can be controlled by commands entered on the command bar, or with +keybindings. To open the command bar, press Ctrl-e: the `>` prompt will +display. From now on, when the documentation shows a command to run (such as +`> help`), press Ctrl-e and type the command followed by enter. -For a list of the default keybindings run `> help defaultkeys`. -For more information on keybindings see `> help keybindings`. +For a list of the default keybindings, run `> help defaultkeys`. +For more information on keybindings, see `> help keybindings`. +To toggle a short list of important keybindings, press Alt-g. ## Quick-start -Press Ctrl-q to quit, and Ctrl-s to save. Press Ctrl-e to start typing commands -and you can see which commands are available by pressing tab, or by viewing the -help topic `> help commands`. +To quit, press Ctrl-q. Save by pressing Ctrl-s. Press Ctrl-e, as previously +mentioned, to start typing commands. To see which commands are available, at the +prompt, press tab, or view the help topic with `> help commands`. -Move the cursor around with the mouse or the arrow keys. Run -`> help defaultkeys` to get a quick, easy overview of the default hotkeys and -what they do. For more info on rebinding keys, see type `> help keybindings`. +Move the cursor around with the mouse or with the arrow keys. Enter text simply +by pressing character keys. If the colorscheme doesn't look good, you can change it with `> set colorscheme ...`. You can press tab to see the available colorschemes, @@ -32,19 +31,20 @@ Press Ctrl-w to move between splits, and type `> vsplit filename` or ## Accessing more help -Micro has a built-in help system which can be accessed with the `help` command. +Micro has a built-in help system which can be accessed with the `> help` command. -To use it, press Ctrl-e to access command mode and type in `help` followed by a -topic. Typing `help` followed by nothing will open this page. +To view help for the various available topics, press Ctrl-e to access command +mode and type in `> help` followed by a topic. Typing just `> help` will open +this page. -Here are the possible help topics that you can read: +Here are the available help topics: * tutorial: A brief tutorial which gives an overview of all the other help topics * keybindings: Gives a full list of the default keybindings as well as how to rebind them * defaultkeys: Gives a more straight-forward list of the hotkey commands and - what they do. + what they do * commands: Gives a list of all the commands and what they do * options: Gives a list of all the options you can customize * plugins: Explains how micro's plugin system works and how to create your own