X-Git-Url: https://git.lizzy.rs/?a=blobdiff_plain;ds=sidebyside;f=runtime%2Fhelp%2Fcommands.md;h=d77e98f5ffad30b1bc1fcb430233efc6cd411f89;hb=ef768e36f3e9f8b97db4dfb52d3e9723d760c586;hp=5e04dd347bf582473fe63dd5cd5f25284f1d73fb;hpb=50ff45c213a15428f2b33ca72d6fafb679a09137;p=micro.git diff --git a/runtime/help/commands.md b/runtime/help/commands.md index 5e04dd34..d77e98f5 100644 --- a/runtime/help/commands.md +++ b/runtime/help/commands.md @@ -1,19 +1,19 @@ # Command bar -The command bar is opened by pressing Ctrl-e. It is a single-line buffer, +The command bar is opened by pressing CtrlE. It is a single-line buffer, meaning that all keybindings from a normal buffer are supported (as well as mouse and selection). 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. +running the command. To use an argument with a space in it, put it in +quotes. The command bar parser uses the same rules for parsing arguments that +`/bin/sh` would use (single quotes, double quotes, escaping). The command bar +does not look up environment variables. # Commands Micro provides the following commands that can be executed at the command-bar by -pressing `Ctrl-e` and entering the command. Arguments are placed in single +pressing `CtrlE` and entering the command. Arguments are placed in single quotes here but these are not necessary when entering the command in micro. * `bind 'key' 'action'`: creates a keybinding from key to action. See the @@ -69,14 +69,21 @@ quotes here but these are not necessary when entering the command in micro. 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 list`: lists all installed plugins. + +* `plugin install 'pl'`: install a plugin. + +* `plugin remove 'pl'`: remove a plugin. -* `plugin version 'pl'`: shows version for specified plugin. +* `plugin update 'pl'`: update a plugin (if no arguments are provided + updates all plugins). -* `plugin info 'pl'`: shows additional info for specified plugin. +* `plugin search 'pl'`: search available plugins for a keyword. + +* `plugin available`: show available plugins that can be installed. * `reload`: reloads all runtime files. @@ -99,10 +106,12 @@ quotes here but these are not necessary when entering the command in micro. * `showkey`: Show the action(s) bound to a given key. For example running `> showkey CtrlC` will display `Copy`. +* `term exec?`: Open a terminal emulator running the given executable. If no + executable is given, this will open the default shell in the terminal emulator. + --- 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.