You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
vim-vimux/doc/vimux.txt

72 lines
2.5 KiB
Plaintext

*vimux.txt* easily interact with tmux
Vimux
effortless vim and tmux interaction
==============================================================================
CONTENTS *vimux-contents*
1. Usage ........................... |VimuxUsage|
2. Configuration ................... |VimuxConfiguration|
==============================================================================
1. Usage *VimuxUsage*
The function RunVimTmuxCommand(command) is the core of Vimux. It will
create a split pane in the current window and run the passed command in it.
:call RunVimTmuxCommand("ls")
This will run the command in a split pane without losing focus of vim. If the
command takes a long time to return you can continue to use vim while the
process finishes and will see the output in the pane when it's finished. Check
out http://github.com/benmills/vimux for more information and updates.
==============================================================================
2. Configuration *VimuxConfiguration*
These are the available options for Vimux
------------------------------------------------------------------------------
2.1 g:VimuxHeight *VimuxConfiguration_height*
The percent of the screen the split pane Vimux will spawn should take up.
let g:VimuxHeight = "40"
Default: "20"
------------------------------------------------------------------------------
2.2 g:VimuxOrientation *VimuxConfiguration_orientation*
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
Default: "v"
------------------------------------------------------------------------------
2.3 g:VimuxUseNearestPane *VimuxConfiguration_use_nearest_pane*
Use exising pane (not used by vim) if found instead of running split-window.
let VimuxUseNearestPane = 1
Default: 0
------------------------------------------------------------------------------
2.4 g:VimuxResetSequence *VimuxConfiguration_reset_sequence*
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 VimuxUseNearestPane = ""
Default: "q C-u"