X-Git-Url: https://git.lizzy.rs/?a=blobdiff_plain;ds=sidebyside;f=runtime%2Fhelp%2Fcommands.md;h=61f6fe10a791ecf9d57ec554f189d14275809e5b;hb=e420872a270e351653f62756cda24892dc1417c9;hp=3a7fddd309386ceb550fee54d3e5cf76980c3bbd;hpb=4a0c48587ae08c4db18a658275a42c162a25df93;p=micro.git

diff --git a/runtime/help/commands.md b/runtime/help/commands.md
index 3a7fddd3..61f6fe10 100644
--- a/runtime/help/commands.md
+++ b/runtime/help/commands.md
@@ -5,30 +5,95 @@ Here are the possible commands that you can use.
 
 * `quit`: Quits micro.
 
-* `save`: Saves the current buffer.
+* `save filename?`: Saves the current buffer. If the filename is provided it
+  will 'save as' the filename.
 
 * `replace "search" "value" flags`: This will replace `search` with `value`. 
-   The `flags` are optional.
-   At this point, there is only one flag: `c`, which enables `check` mode 
-   which asks if you'd like to perform the replacement each time
+   The `flags` are optional. Possible flags are:
+   * `-a`: Replace all occurrences at once
+   * `-l`: Do a literal search instead of a regex search
 
-   Note that `search` must be a valid regex.  If one of the arguments
-   does not have any spaces in it, you may omit the quotes.
+   Note that `search` must be a valid regex (unless `-l` is passed). If one 
+   of the arguments does not have any spaces in it, you may omit the quotes.
 
-* `set option value`: sets the option to value. Please see the next section for
+* `replaceall "search" "value"`: This will replace `search` with `value` without
+   user confirmation.
+
+	See `replace` command for more information.
+
+* `set option value`: sets the option to value. See the `options` help topic for
    a list of options you can set.
 
+* `setlocal option value`: sets the option to value locally (only in the current
+   buffer).
+
+* `show option`: shows the current value of the given option.
+
 * `run sh-command`: runs the given shell command in the background. The 
    command's output will be displayed in one line when it finishes running.
 
-* `bind key action`: creates a keybinding from key to action. See the sections on
-   keybindings above for more info about what keys and actions are available.
+* `bind key action`: creates a keybinding from key to action. See the sections
+   on keybindings above for more info about what keys and actions are available.
 
 * `vsplit filename`: opens a vertical split with `filename`. If no filename is
-   provided, a vertical split is opened with an empty buffer
+   provided, a vertical split is opened with an empty buffer.
 
-* `hsplit filename`: same as `vsplit` but opens a horizontal split instead of
-   a vertical split
+* `hsplit filename`: same as `vsplit` but opens a horizontal split instead of a
+   vertical split.
 
 * `tab filename`: opens the given file in a new tab.
 
+* `tabswitch tab`: This command will switch to the specified tab. The `tab` can
+   either be a tab number, or a name of a tab.
+
+* `textfilter sh-command`: filters the current selection through a shell command
+   as standard input and replaces the selection with the stdout of the shell command.
+   For example, to sort a list of numbers, first select them, and then execute
+   `> textfilter sort -n`.
+					 
+* `log`: opens a log of all messages and debug statements.
+
+* `plugin list`: lists all installed plugins.
+
+* `plugin version pl`: shows version for specified plugin.
+
+* `plugin info pl`: shows additional info for specified plugin.
+
+* `reload`: reloads all runtime files.
+
+* `cd path`: Change the working directory to the given `path`.
+
+* `pwd`: Print the current working directory.
+
+* `open filename`: Open a file in the current buffer.
+
+* `reset option`: resets the given option to its default value
+
+* `retab`: Replaces all leading tabs with spaces or leading spaces with tabs
+   depending on the value of `tabstospaces`.
+
+* `raw`: Micro will open a new tab and show the escape sequence for every event
+   it receives from the terminal. This shows you what micro actually sees from
+   the terminal and helps you see which bindings aren't possible and why. This
+   is most useful for debugging keybindings.
+
+* `showkey`: Show the action(s) bound to a given key. For example
+   running `> showkey CtrlC` will display `main.(*View).Copy`. Unfortuately
+   showkey does not work well for keys bound to plugin actions. For those
+   it just shows "LuaFunctionBinding."
+
+---
+
+The following commands are provided by the default plugins:
+
+* `lint`: Lint the current file for errors.
+
+* `comment`: automatically comment or uncomment current selection or line.
+
+# Command Parsing
+
+When running a command, you can use extra syntax that micro will expand before
+running the command. To use an argument with a space in it, simply put it in
+quotes. You can also use environment variables in the command bar and they
+will be expanded to their value. Finally, you can put an expression in backticks
+and it will be evaluated by the shell beforehand.