From 7d977a295412ea93fce693a6fa4f5af1e20e0a5e Mon Sep 17 00:00:00 2001 From: Michael van der Kamp Date: Sun, 7 Mar 2021 18:17:53 -0600 Subject: [PATCH] Documentation touchups --- doc/vimux.txt | 62 +++++++++++++++++++++++++++------------------------ 1 file changed, 33 insertions(+), 29 deletions(-) diff --git a/doc/vimux.txt b/doc/vimux.txt index fda9664..b137d67 100644 --- a/doc/vimux.txt +++ b/doc/vimux.txt @@ -94,7 +94,7 @@ vimux from automatically sending a return after the command. VimuxSendText~ Send raw text to the runner pane. This command will not open a new pane if one -does not already exist. You will need to use VimuxOpenRunner to do this. This +does not already exist. You will need to use |VimuxOpenRunner| to do this. This command can be used to interact with REPLs or other interactive terminal programs that are not shells. @@ -104,7 +104,7 @@ programs that are not shells. VimuxSendKeys~ Send keys to the runner pane. This command will not open a new pane if one -does not already exist. You will need to use VimuxOpenRunner to do this. You +does not already exist. You will need to use |VimuxOpenRunner| to do this. You can use this command to send keys such as "Enter" or "C-c" to the runner pane. ------------------------------------------------------------------------------ @@ -113,7 +113,7 @@ VimuxOpenRunner~ This will either open a new pane or use the nearest pane and set it as the vimux runner pane for the other vimux commands. You can control if this command -uses the nearest pane or always creates a new one with g:VimuxUseNearest +uses the nearest pane or always creates a new one with g:|VimuxUseNearest| ------------------------------------------------------------------------------ *VimuxPromptCommand* @@ -295,9 +295,9 @@ change the behavior of Vimux in just the current buffer. 4.1 g:VimuxHeight~ The percent of the screen the split pane Vimux will spawn should take up. - +> let g:VimuxHeight = "40" - +< Default: "20" ------------------------------------------------------------------------------ @@ -307,9 +307,9 @@ Default: "20" The default orientation of the split tmux pane. This tells tmux to make the pane either vertically or horizontally, which is backward from how Vim handles creating splits. - +> let g:VimuxOrientation = "h" - +< Options: "v": vertical "h": horizontal @@ -318,13 +318,13 @@ Default: "v" ------------------------------------------------------------------------------ *VimuxConfiguration_use_nearest* -4.3 g:VimuxUseNearest +4.3 g:VimuxUseNearest~ Use existing pane or window (not used by vim) if found instead of running split-window. - +> let g:VimuxUseNearest = 1 - +< Default: 1 ------------------------------------------------------------------------------ @@ -333,9 +333,9 @@ Default: 1 The keys sent to the runner pane before running a command. By default it sends `q` to make sure the pane is not in scroll-mode and `C-u` to clear the line. - +> let g:VimuxResetSequence = "" - +< Default: "q C-u" ------------------------------------------------------------------------------ @@ -345,9 +345,9 @@ Default: "q C-u" The string presented in the vim command line when Vimux is invoked. Be sure to put a space at the end of the string to allow for distinction between the prompt and your input. - +> let g:VimuxPromptString = "" - +< Default: "Command? " ------------------------------------------------------------------------------ @@ -356,9 +356,9 @@ Default: "Command? " The type of view object Vimux should use for the runner. For reference, a tmux session is a group of windows, and a window is a layout of panes. - +> let g:VimuxRunnerType = "window" - +< Options: "pane": for panes "window": for windows @@ -367,14 +367,16 @@ Default: "pane" ------------------------------------------------------------------------------ *VimuxRunnerName* -4.7 g:VimuxRunnerName +4.7 g:VimuxRunnerName~ Setting the name for the runner. Works for panes and windows. This makes the VimuxRunner reusable between sessions. Caveat is, all your instances (in the -same session/window) use the same window. +same session/window) use the same window. +Caution: It is probably best not to mix this with |VimuxCloseOnExit|. +> let g:VimuxRunnerName = "vimuxout" - +< Default: "" ------------------------------------------------------------------------------ @@ -383,9 +385,9 @@ Default: "" The command that Vimux runs when it calls out to tmux. It may be useful to redefine this if you're using something like tmate. - +> let g:VimuxTmuxCommand = "tmate" - +< Default: "tmux" ------------------------------------------------------------------------------ @@ -395,13 +397,13 @@ Default: "tmux" Allows addtional arguments to be passed to the tmux command that opens the runner. Make sure that the arguments specified are valid depending on whether you're using panes or windows, and your version of tmux. - +> let g:VimuxOpenExtraArgs = "-c #{pane_current_path}" - -Default: "tmux" +< +Default: "" ------------------------------------------------------------------------------ - VimuxExpandCommand + *VimuxExpandCommand* 4.10 g:VimuxExpandCommand~ Should the command given at the prompt via VimuxPromptCommand be expanded @@ -411,20 +413,22 @@ Unfortunately expand() only expands % (etc.) if the string starts with that character. So the command is split at spaces and then rejoined after expansion. With this simple approach things like "%:h/test.xml" are not possible. - +> let g:VimuxExpandCommand = 1 - +< Default: 0 ------------------------------------------------------------------------------ *VimuxCloseOnExit* 4.11 g:VimuxCloseOnExit~ -Set this option to 1 or v:true to tell vimux to close the runner when you quit +Set this option to `1` or `v:true` to tell vimux to close the runner when you quit vim. +Caution: It is probably best not to mix this with |VimuxRunnerName|. +> let g:VimuxCloseOnExit = 1 - +< Default: 0 ==============================================================================