diff options
| author | Josh Triplett <josh@joshtriplett.org> | 2016-07-10 12:41:07 -0700 |
|---|---|---|
| committer | Josh Triplett <josh@joshtriplett.org> | 2016-07-12 14:42:17 -0700 |
| commit | 83aea9ccf58f66b70808ed6125eedcd9e8d9324c (patch) | |
| tree | 626386e08cc36b7aac9f8c4336c544d4479f0843 | |
| parent | d529ca01034f7c4991be77e52ad9883a3c8dbd68 (diff) | |
| download | rneovim-83aea9ccf58f66b70808ed6125eedcd9e8d9324c.tar.gz rneovim-83aea9ccf58f66b70808ed6125eedcd9e8d9324c.tar.bz2 rneovim-83aea9ccf58f66b70808ed6125eedcd9e8d9324c.zip | |
Document terminal buffer-local variables
Include an example of using them in 'statusline'.
| -rw-r--r-- | runtime/doc/nvim_terminal_emulator.txt | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/runtime/doc/nvim_terminal_emulator.txt b/runtime/doc/nvim_terminal_emulator.txt index 4296ef6490..8f7dc0dbf0 100644 --- a/runtime/doc/nvim_terminal_emulator.txt +++ b/runtime/doc/nvim_terminal_emulator.txt @@ -10,6 +10,7 @@ Embedded terminal emulator *terminal-emulator* 2. Spawning |terminal-emulator-spawning| 3. Input |terminal-emulator-input| 4. Configuration |terminal-emulator-configuration| +5. Status Variables |terminal-emulator-status| ============================================================================== 1. Introduction *terminal-emulator-intro* @@ -113,4 +114,25 @@ The terminal cursor can be highlighted via |hl-TermCursor| and |hl-TermCursorNC|. ============================================================================== +5. Status Variables *terminal-emulator-status* + +Terminal buffers maintain some information about the terminal in buffer-local +variables: + +- *b:term_title* The settable title of the terminal, typically displayed in + the window title or tab title of a graphical terminal emulator. Programs + running in the terminal can set this title via an escape sequence. +- *b:terminal_job_id* The nvim job ID of the job running in the terminal. See + |job-control| for more information. +- *b:terminal_job_pid* The PID of the top-level process running in the + terminal. + +These variables will have a value by the time the TermOpen autocmd runs, and +will continue to have a value for the lifetime of the terminal buffer, making +them suitable for use in 'statusline'. For example, to show the terminal title +as the status line: +> + :autocmd TermOpen * setlocal statusline=%{b:term_title} +< +============================================================================== vim:tw=78:ts=8:noet:ft=help:norl: |