Merge pull request #1414 from Microsoft/tyriar/terminal-split

Document terminal splitting
microsoft · Feb 21, 2018 · 7c611ba · 7c611ba
2 parents 1135081 + ef15c9f
commit 7c611ba
Show file tree

Hide file tree

Showing 2 changed files with 15 additions and 0 deletions.
diff --git a/docs/editor/images/integrated-terminal/terminal-split-pane.png b/docs/editor/images/integrated-terminal/terminal-split-pane.png
diff --git a/docs/editor/integrated-terminal.md b/docs/editor/integrated-terminal.md
@@ -31,6 +31,21 @@ Remove terminal instances by pressing the trash can button.
 
 >**Tip:** If you use multiple terminals extensively, you can add key bindings for the `focusNext`, `focusPrevious` and `kill` commands outlined in the [Key Bindings section](/docs/editor/integrated-terminal.md#terminal-key-bindings) to allow navigation between them using only the keyboard.
 
+### Terminal Splitting
+
+You can also split the terminal by triggering the `kb(workbench.action.terminal.split)` command or via the right click context menu.
+
+![Split terminals](images/integrated-terminal/terminal-split-pane.png)
+
+When focusing a split terminal pane, you can move focus and resize using one of the following commands:
+
+* `kb(workbench.action.terminal.focusPreviousPane)`
+* `kb(workbench.action.terminal.focusNextPane)`
+* `kb(workbench.action.terminal.resizePaneLeft)`
+* `kb(workbench.action.terminal.resizePaneRight)`
+* `kb(workbench.action.terminal.resizePaneUp)`
+* `kb(workbench.action.terminal.resizePaneDown)`
+
 ## Configuration
 
 The shell used defaults to `$SHELL` on Linux and macOS, PowerShell on Windows 10 and cmd.exe on earlier versions of Windows. These can be overridden manually by setting `terminal.integrated.shell.*` in [settings](/docs/getstarted/settings.md). Arguments can be passed to the terminal shell on Linux and macOS using the `terminal.integrated.shellArgs.*` settings.