Update 2026-01-25 09:38 OpenBSD/amd64-t14
This commit is contained in:
@@ -1,119 +0,0 @@
|
||||
*bufferline.txt* Simple plugin for generating buffer list names
|
||||
|
||||
==============================================================================
|
||||
INTRODUCTION *bufferline*
|
||||
|
||||
vim-bufferline is a simple plugin that helps you keep track of all your open
|
||||
buffers. It also integrates nicely with vim-airline.
|
||||
|
||||
==============================================================================
|
||||
CONFIGURATION *bufferline-configuration*
|
||||
|
||||
There are a couple configuration values available (shown with their default
|
||||
values):
|
||||
|
||||
* denotes whether bufferline should automatically echo to the command bar
|
||||
>
|
||||
let g:bufferline_echo = 1
|
||||
<
|
||||
|
||||
* the separator used on the left side of a buffer
|
||||
>
|
||||
let g:bufferline_active_buffer_left = '['
|
||||
<
|
||||
|
||||
* the separator used on the right side of a buffer
|
||||
>
|
||||
let g:bufferline_active_buffer_right = ']'
|
||||
<
|
||||
|
||||
* the symbol to denote that a buffer is modified
|
||||
>
|
||||
let g:bufferline_modified = '+'
|
||||
<
|
||||
|
||||
* denotes whether buffer numbers should be displayed
|
||||
>
|
||||
let g:bufferline_show_bufnr = 1
|
||||
<
|
||||
|
||||
* denotes whether the bufferline should have rotation applied
|
||||
>
|
||||
" default, no rotate, no scrolling
|
||||
let g:bufferline_rotate = 0
|
||||
|
||||
" scrolling with fixed current buffer position
|
||||
let g:bufferline_rotate = 1
|
||||
|
||||
" scrolling without fixed current buffer position
|
||||
let g:bufferline_rotate = 2
|
||||
<
|
||||
|
||||
* only valid when `g:bufferline_rotate` is set to 1:
|
||||
>
|
||||
let g:bufferline_fixed_index = 0 "always first
|
||||
let g:bufferline_fixed_index = 1 "always second (default)
|
||||
let g:bufferline_fixed_index = -1 "always last
|
||||
<
|
||||
|
||||
* denotes how to display the filename of a buffer (see |filename-modifiers|
|
||||
for more details)
|
||||
>
|
||||
let g:bufferline_fname_mod = ':t'
|
||||
<
|
||||
|
||||
* denotes the highlight group for inactive buffers when used in the
|
||||
|statusline|
|
||||
>
|
||||
let g:bufferline_inactive_highlight = 'StatusLineNC'
|
||||
<
|
||||
|
||||
* denotes the highlight group for the active buffer when used in the
|
||||
|statusline|
|
||||
>
|
||||
let g:bufferline_active_highlight = 'StatusLine'
|
||||
<
|
||||
|
||||
* denotes whether the active highlight should be used when there is only one
|
||||
buffer.
|
||||
>
|
||||
let g:bufferline_solo_highlight = 0
|
||||
<
|
||||
|
||||
* denotes any exclude patterns.
|
||||
>
|
||||
let g:bufferline_excludes = [] "see source for defaults
|
||||
<
|
||||
|
||||
* denotes whether paths in buffer names should be |pathshorten()|-ed.
|
||||
>
|
||||
let g:bufferline_pathshorten = 0
|
||||
<
|
||||
|
||||
==============================================================================
|
||||
STATUSLINE INTEGRATION *bufferline-statusline*
|
||||
|
||||
>
|
||||
let g:bufferline_echo = 0
|
||||
autocmd VimEnter *
|
||||
\ let &statusline='%{bufferline#refresh_status()}'
|
||||
\ .bufferline#get_status_string()
|
||||
<
|
||||
|
||||
The function refresh_status() returns an empty string and only exists to
|
||||
populate some global variables. Since it is inside an %{} block, the
|
||||
variables will get updated whenever the statusline needs to be drawn.
|
||||
get_status_string() creates a string which references these variables.
|
||||
|
||||
==============================================================================
|
||||
CONTRIBUTIONS *bufferline-contributions*
|
||||
|
||||
Contributions and pull requests are welcome.
|
||||
|
||||
==============================================================================
|
||||
LICENSE *bufferline-license*
|
||||
|
||||
MIT License. Copyright © 2013 Bailey Ling.
|
||||
|
||||
|
||||
vim:tw=78:ts=8:ft=help:norl:
|
||||
143
.vim/pack/plugins/start/vim-bufferline/doc/buftabline.txt
Normal file
143
.vim/pack/plugins/start/vim-bufferline/doc/buftabline.txt
Normal file
@@ -0,0 +1,143 @@
|
||||
*buftabline.txt* Use the tabline to render buffer tabs
|
||||
|
||||
BUFTABLINE by Aristotle Pagaltzis
|
||||
|
||||
==============================================================================
|
||||
0. Contents *buftabline*
|
||||
|
||||
1. Intro ....................................... |buftabline-intro|
|
||||
2. Configuration settings ...................... |buftabline-config|
|
||||
3. Mappings .................................... |buftabline-mappings|
|
||||
4. Tab coloring and colorscheme support ........ |buftabline-colors|
|
||||
5. Source ...................................... |buftabline-source|
|
||||
|
||||
|
||||
==============================================================================
|
||||
1. Intro *buftabline-intro*
|
||||
|
||||
This plugin takes over the 'tabline' and renders the buffer list in it instead
|
||||
of a tab list. It is designed with the ideal that it should Just Work: drop it
|
||||
into your setup and you're done. There is only minimal configurable behavior.
|
||||
|
||||
|
||||
==============================================================================
|
||||
2. Configuration settings *buftabline-config*
|
||||
|
||||
Changes to any of the plugin's configuration settings at runtime will not take
|
||||
effect immediately unless you force an update: >
|
||||
:call buftabline#update(0)
|
||||
<
|
||||
|
||||
*g:buftabline_show* number (default 2)
|
||||
|
||||
The value of this option specifies when the line with buffer labels will
|
||||
be displayed:
|
||||
0: never
|
||||
1: only if there are at least two buffers
|
||||
2: always
|
||||
This is analogous to the 'showtabline' setting, only for the |buftabline|.
|
||||
|
||||
|
||||
*g:buftabline_numbers* number (default 0)
|
||||
|
||||
The value of this option specifies how to number the buffer labels:
|
||||
0: no numbering
|
||||
1: buffer number
|
||||
2: ordinal number
|
||||
The buffer number corresponds to Vim's internal buffer number as shown by
|
||||
the |:ls| command, whereas the ordinal number is a simple sequential count
|
||||
from left to right.
|
||||
|
||||
|
||||
*g:buftabline_indicators* boolean (default off)
|
||||
|
||||
When on, the buffer's state is indicated in the buffer label. Currently
|
||||
the only state indicated is whether the buffer is 'modified'.
|
||||
|
||||
|
||||
*g:buftabline_separators* boolean (default off)
|
||||
|
||||
When on, a vertical line is drawn inbetween tabs. (This is not strictly
|
||||
correct. The effect is actually achieved by replacing the space on the
|
||||
left side of each tab with U+23B8 LEFT VERTICAL BOX LINE. Therefore the
|
||||
separator will be highlighted the same way as the tab to its left.)
|
||||
|
||||
|
||||
*g:buftabline_plug_max* number (default 10)
|
||||
|
||||
The number of |buftabline-mappings| that will be created by the plugin.
|
||||
You can request more of them or turn off the functionality entirely by
|
||||
setting this to 0. Note it only has an effect before loading the plugin,
|
||||
not if you change it later.
|
||||
|
||||
|
||||
==============================================================================
|
||||
3. Mappings *buftabline-mappings*
|
||||
|
||||
To switch buffers by their ordinal number (|g:buftabline_numbers| = 2) you can
|
||||
map keys to the |<Plug>| mappings provided by this plugin: >
|
||||
nmap <leader>1 <Plug>BufTabLine.Go(1)
|
||||
nmap <leader>2 <Plug>BufTabLine.Go(2)
|
||||
nmap <leader>3 <Plug>BufTabLine.Go(3)
|
||||
nmap <leader>4 <Plug>BufTabLine.Go(4)
|
||||
nmap <leader>5 <Plug>BufTabLine.Go(5)
|
||||
nmap <leader>6 <Plug>BufTabLine.Go(6)
|
||||
nmap <leader>7 <Plug>BufTabLine.Go(7)
|
||||
nmap <leader>8 <Plug>BufTabLine.Go(8)
|
||||
nmap <leader>9 <Plug>BufTabLine.Go(9)
|
||||
nmap <leader>0 <Plug>BufTabLine.Go(10)
|
||||
<
|
||||
There is also a |<Plug>| mapping which always switches to the last buffer: >
|
||||
nmap <leader>0 <Plug>BufTabLine.Go(-1)
|
||||
<
|
||||
On Mac OS, you probably want to use a |<D-| mapping instead, which will emulate
|
||||
the standard Cmd+1, Cmd+2, etc. keybindings for this feature: >
|
||||
nmap <D-1> <Plug>BufTabLine.Go(1)
|
||||
nmap <D-2> <Plug>BufTabLine.Go(2)
|
||||
nmap <D-3> <Plug>BufTabLine.Go(3)
|
||||
nmap <D-4> <Plug>BufTabLine.Go(4)
|
||||
nmap <D-5> <Plug>BufTabLine.Go(5)
|
||||
nmap <D-6> <Plug>BufTabLine.Go(6)
|
||||
nmap <D-7> <Plug>BufTabLine.Go(7)
|
||||
nmap <D-8> <Plug>BufTabLine.Go(8)
|
||||
nmap <D-9> <Plug>BufTabLine.Go(9)
|
||||
nmap <D-0> <Plug>BufTabLine.Go(10)
|
||||
" or to go to the last buffer:
|
||||
nmap <D-0> <Plug>BufTabLine.Go(-1)
|
||||
<
|
||||
You can ask for more (or fewer) than the default 10 <Plug> mappings using the
|
||||
|g:buftabline_plug_max| setting.
|
||||
|
||||
==============================================================================
|
||||
4. Tab coloring and colorscheme support *buftabline-colors*
|
||||
|
||||
This plugin uses several custom highlight groups to render the buffer tabs.
|
||||
The custom groups are linked to several other built-in Vim highlight groups
|
||||
that should provide a sensible default which automatically harmonizes with
|
||||
your |colorscheme|.
|
||||
|
||||
However, if you dislike your colorscheme's chosen tabline colours, you can
|
||||
override the default links in your |vimrc| -- c.f. |:hi-link|.
|
||||
|
||||
Or if you are a colorscheme designer (|44.1|), you can add support to your
|
||||
colorscheme for this plugin specifically.
|
||||
|
||||
The highlight groups and their default links are as follows:
|
||||
|
||||
Custom group Default link Meaning
|
||||
*BufTabLineCurrent* |TabLineSel| Buffer shown in current window
|
||||
*BufTabLineActive* |PmenuSel| Buffer shown in other window
|
||||
*BufTabLineHidden* |TabLine| Buffer not currently visible
|
||||
*BufTabLineFill* |TabLineFill| Empty area
|
||||
*BufTabLineModifiedCurrent* |BufTabLineCurrent| (Same as linked but 'modified')
|
||||
*BufTabLineModifiedActive* |BufTabLineActive| (Same as linked but 'modified')
|
||||
*BufTabLineModifiedHidden* |BufTabLineHidden| (Same as linked but 'modified')
|
||||
|
||||
|
||||
==============================================================================
|
||||
5. Source *buftabline-source*
|
||||
|
||||
https://github.com/ap/vim-buftabline
|
||||
|
||||
|
||||
vim:tw=78:et:ft=help:norl:
|
||||
Reference in New Issue
Block a user