mirror of
https://github.com/amix/vimrc
synced 2025-07-09 18:55:01 +08:00
Update bufexplorer.
This commit is contained in:
@ -1,7 +1,7 @@
|
||||
*bufexplorer.txt* Buffer Explorer Last Change: 08 Dec 2018
|
||||
*bufexplorer.txt* Buffer Explorer Last Change: 03 Nov 2014
|
||||
|
||||
Buffer Explorer *buffer-explorer* *bufexplorer*
|
||||
Version 7.4.21
|
||||
Version 7.4.6
|
||||
|
||||
Plugin for easily exploring (or browsing) Vim|:buffers|.
|
||||
|
||||
@ -41,24 +41,22 @@ To install:
|
||||
USAGE *bufexplorer-usage*
|
||||
|
||||
To start exploring in the current window, use: >
|
||||
<Leader>be or :BufExplorer or Your custom key mapping
|
||||
To toggle bufexplorer on or off in the current window, use: >
|
||||
<Leader>bt or :ToggleBufExplorer or Your custom key mapping
|
||||
\be or :BufExplorer or Your custom key mapping
|
||||
To start exploring in a newly split horizontal window, use: >
|
||||
<Leader>bs or :BufExplorerHorizontalSplit or Your custom key mapping
|
||||
\bs or :BufExplorerHorizontalSplit or Your custom key mapping
|
||||
To start exploring in a newly split vertical window, use: >
|
||||
<Leader>bv or :BufExplorerVerticalSplit or Your custom key mapping
|
||||
\bv or :BufExplorerVerticalSplit or Your custom key mapping
|
||||
|
||||
If you would like to use something other than the default leader key - '\' -
|
||||
you may simply change the leader (see |mapleader|).
|
||||
If you would like to use something other than '\', you may simply change the
|
||||
leader (see |mapleader|).
|
||||
|
||||
When <Leader>bs or <Leader>bv is issued, bufexplorer opens in either a
|
||||
horizontally or vertically split window. By issuing either of these commands,
|
||||
the user is telling bufexplorer that they want to split the window and have
|
||||
bufexplorer show the buffer they are about to select (from the bufexplorer
|
||||
windows) in the newly split window. When <Leader>be is issued, bufexplorer
|
||||
opens the bufexplorer contents in the current window and the buffer the user
|
||||
selects is opened in the current window.
|
||||
When \bs or \bv is issued, bufexplorer opens in either a horizonally or
|
||||
vertically split window. By issusing either of these commands, the user is
|
||||
telling bufexplorer that they want to split the window and have bufexplorer
|
||||
show the buffer they are about to select (from the bufexplorer windows) in the
|
||||
newly split window. When \be is issued, bufexplorer opens the bufexplorer
|
||||
contents in the current window and the buffer the user selects is opened in
|
||||
the current window.
|
||||
|
||||
Note: If the current buffer is modified when bufexplorer started, the current
|
||||
window is always split and the new bufexplorer is displayed in that new
|
||||
@ -72,20 +70,18 @@ Commands to use once exploring:
|
||||
<leftmouse> Opens the buffer that is under the cursor into the current
|
||||
window.
|
||||
<shift-enter> Opens the buffer that is under the cursor in another tab.
|
||||
a Toggles whether you are taken to the active window when
|
||||
selecting a buffer or not.
|
||||
b Fast buffer switching with b<any bufnum>.
|
||||
B Works in association with the |ShowTabBuffer| option. If
|
||||
|ShowTabBuffer| is set to 1, this toggles if BufExplorer is to
|
||||
B Works in association with the|ShowTabBuffer|option. If
|
||||
|ShowTabBuffer|is set to 1, this toggles if BufExplorer is to
|
||||
only store the most recent tab for this buffer or not.
|
||||
d |:delete| the buffer under the cursor from the list. The
|
||||
d |:delete|the buffer under the cursor from the list. The
|
||||
buffer's 'buflisted' is cleared. This allows for the buffer to
|
||||
be displayed again using the 'show unlisted' command.
|
||||
D |:wipeout| the buffer under the cursor from the list. When a
|
||||
buffer is wiped, it will not be shown when unlisted buffers are
|
||||
D |:wipeout|the buffer under the cursor from the list. When a
|
||||
buffers is wiped, it will not be shown when unlisted buffer are
|
||||
displayed.
|
||||
F Open selected buffer in another window above the current.
|
||||
f Open selected buffer in another window below the current.
|
||||
f Toggles whether you are taken to the active window when
|
||||
selecting a buffer or not.
|
||||
o Opens the buffer that is under the cursor into the current
|
||||
window.
|
||||
p Toggles the showing of a split filename/pathname.
|
||||
@ -101,14 +97,12 @@ Commands to use once exploring:
|
||||
t Opens the buffer that is under the cursor in another tab.
|
||||
T Toggles to show only buffers for this tab or not.
|
||||
u Toggles the showing of "unlisted" buffers.
|
||||
V Open the selected buffer in another window on the left of the current.
|
||||
v Open the selected buffer in another window on the right of the current.
|
||||
|
||||
Once invoked, Buffer Explorer displays a sorted list (MRU is the default
|
||||
sort method) of all the buffers that are currently opened. You are then
|
||||
able to move the cursor to the line containing the buffer's name you are
|
||||
wanting to act upon. Once you have selected the buffer you would like,
|
||||
you can then either open it, close it (delete), resort the list, reverse
|
||||
you can then either open it, close it(delete), resort the list, reverse
|
||||
the sort, quit exploring and so on...
|
||||
|
||||
===============================================================================
|
||||
@ -125,18 +119,17 @@ WINDOW LAYOUT *bufexplorer-windowlayout*
|
||||
| | | | +-- Current Line #.
|
||||
| | | +-- Relative/Full Path
|
||||
| | +-- Buffer Name.
|
||||
| +-- Buffer Attributes. See |:buffers| for more information.
|
||||
+-- Buffer Number. See |:buffers| for more information.
|
||||
| +-- Buffer Attributes. See|:buffers|for more information.
|
||||
+-- Buffer Number. See|:buffers|for more information.
|
||||
|
||||
===============================================================================
|
||||
CUSTOMIZATION *bufexplorer-customization*
|
||||
|
||||
If you do not like the default key mappings of <Leader>be, <Leader>bs, and
|
||||
<Leader>bv, you can override bufexplorer's default mappings by setting up
|
||||
something like the following in your vimrc file:
|
||||
If you do not like the default key mappings of \be, \bs, and \bv, you can
|
||||
override bufexplorer's default mappings by setting up something like the
|
||||
following in your vimrc file:
|
||||
|
||||
nnoremap <silent> <F11> :BufExplorer<CR>
|
||||
nnoremap <silent> <s-F11> :ToggleBufExplorer<CR>
|
||||
nnoremap <silent> <m-F11> :BufExplorerHorizontalSplit<CR>
|
||||
nnoremap <silent> <c-F11> :BufExplorerVerticalSplit<CR>
|
||||
|
||||
@ -200,13 +193,13 @@ directory, use: >
|
||||
The default is to show absolute paths.
|
||||
|
||||
*g:bufExplorerShowTabBuffer*
|
||||
To control whether or not to show buffers on for the specific tab or not, use: >
|
||||
To control weither or not to show buffers on for the specific tab or not, use: >
|
||||
let g:bufExplorerShowTabBuffer=0 " No.
|
||||
let g:bufExplorerShowTabBuffer=1 " Yes.
|
||||
The default is not to show.
|
||||
|
||||
*g:bufExplorerShowUnlisted*
|
||||
To control whether to show unlisted buffers or not, use: >
|
||||
To control whether to show unlisted buffer or not, use: >
|
||||
let g:bufExplorerShowUnlisted=0 " Do not show unlisted buffers.
|
||||
let g:bufExplorerShowUnlisted=1 " Show unlisted buffers.
|
||||
The default is to NOT show unlisted buffers.
|
||||
@ -249,79 +242,14 @@ current window, use: >
|
||||
The default is to use the global &splitright.
|
||||
|
||||
*g:bufExplorerSplitVertSize*
|
||||
To control the size of the new vertical split window, use: >
|
||||
let g:bufExplorerSplitVertSize=n " New split window is n columns wide.
|
||||
let g:bufExplorerSplitVertSize=0 " New split windows size set by Vim.
|
||||
To control the size of the new vertical split window. use: >
|
||||
let g:bufExplorerVertSize=n " New split window is n columns wide.
|
||||
let g:bufExplorerVertSize=0 " New split windows size set by Vim.
|
||||
The default is 0, so that the size is set by Vim.
|
||||
|
||||
*g:bufExplorerVersionWarn*
|
||||
To control whether to warning about Vim version or not, use: >
|
||||
let g:bufExplorerVersionWarn=1 " Warn if version conflict.
|
||||
let g:bufExplorerVersionWarn=0 " Do not warn if version conflict.
|
||||
The default is 1.
|
||||
|
||||
===============================================================================
|
||||
CHANGE LOG *bufexplorer-changelog*
|
||||
|
||||
7.4.21 December 8, 2018
|
||||
- Merged in changes from adelarsq that introduced ryanoasis/vim-devicons
|
||||
support. If the global g:loaded_webdevicons has been set, bufexplorer
|
||||
will now load the associated dev icons for each buffer.
|
||||
7.4.20 January 18, 2017
|
||||
- Thanks to jpflouret for supplying code that can remove the warning
|
||||
messages if you using this plugin on an older version of Vim. The
|
||||
global variable is g:bufExplorerVersionWarn.
|
||||
7.4.19 September 18, 2017
|
||||
- Merged all changes from github back into this version and tried to sync
|
||||
to the correct version number.
|
||||
7.4.18 - Github.
|
||||
7.4.17 - Github.
|
||||
7.4.16 August 14, 2017
|
||||
- Thanks to Yubo Su for the patch that adds 'f, F, V, and v' commands.
|
||||
With this change, the original 'f' command was remapped to 'a'.
|
||||
|
||||
The set of commands that can be used during exploring are:
|
||||
F - Open selected buffer in another window above the current.
|
||||
f - Open selected buffer in another window below the current.
|
||||
V - Open the selected buffer in another window on the left of the
|
||||
current.
|
||||
v - Open the selected buffer in another window on the right of the
|
||||
current.
|
||||
7.4.15 May 01, 2017
|
||||
- Finally applied the patch submitted by justfalter. This patch is a
|
||||
backward-compatible fix for the "invalid tab range" bug.
|
||||
7.4.14 April 10, 2017
|
||||
- As suggested by adelarsq way back on January 5th, 2016, a filetype has
|
||||
been added. There is now 'filetype=bufexplorer'.
|
||||
7.4.13 March 08, 2017
|
||||
- Thanks to devakivamsi for pointing out that even though bufexplorer
|
||||
turns off line numbers by default within its own window, this did not
|
||||
work correctly when using WinManager. This has now been corrected.
|
||||
7.4.12 September 30, 2016
|
||||
- Thanks again to Martin Vuille for several more fixes related to making
|
||||
bufexplorer more tab-friendly.
|
||||
7.4.11 September, 20, 2016
|
||||
- Thanks to Martin Vuille for reworking the per-tab buffer listing code.
|
||||
Fix for g:bufExplorerShowTabBuffer is not working correctly and other
|
||||
"gliches" when the ShotTabBuffer option is enabled. For example old
|
||||
code would not correctly handle adding/deleting a tab that wasn't the
|
||||
highest-numbered tab.
|
||||
7.4.10 August 26, 2016
|
||||
- Thanks to buddylindsey for fixing a misspelling in the docs.
|
||||
7.4.9 April 01, 2016
|
||||
- Thanks to ivegotasthma for supplying a patch to fix a major issue with
|
||||
plugin performance when lots of buffers are open.
|
||||
- Thanks to ershov for the patch to fix grouping of files in ambiguous
|
||||
sort modes.
|
||||
- Thanks to PhilRunninger for changing documentation to use <Leader>, in
|
||||
place of '\'.
|
||||
7.4.8 January 27, 2015
|
||||
- Thanks to Marius Gedminas for fixing up the documentation and correcting
|
||||
various typos.
|
||||
7.4.7 January 20, 2015
|
||||
- Thanks goes out to Phil Runninger for added the ability to toggle the
|
||||
bufexplorer list on and off using the :ToggleBufExplorer command, the
|
||||
map <Leader>bt, and the function ToggleBufExplorer().
|
||||
7.4.6 November 03, 2014
|
||||
- Not sure how, but the file format was converted to Dos instead of Unix.
|
||||
I converted the file back to Unix.
|
||||
@ -347,7 +275,7 @@ CHANGE LOG *bufexplorer-changelog*
|
||||
- First update related to Vim 7.4.
|
||||
- Changed license text.
|
||||
- Fixed issue with 'hidden'. If 'hidden' is set, make sure that
|
||||
g:bufExplorerFindActive is set to 0. Otherwise, when using \bs or \bv,
|
||||
g:bufExplorerFindActive is set to 0. Otherwise, when using /bs or /bv,
|
||||
and selecting a buffer, the original buffer will be switched to instead
|
||||
of being opened in the newly created windows.
|
||||
- Added new 'b' mapping when the bufExplorer window is opened. When 'b'
|
||||
@ -404,7 +332,7 @@ CHANGE LOG *bufexplorer-changelog*
|
||||
fixes. Overall, I am hopeful that I not forgotten or lost a feature.
|
||||
- Thanks to Tim Johnson for testing out this new version.
|
||||
- I have hopefully allowed for better mapping of the main public
|
||||
methods as is explained in the |bufexplorer-customization| section
|
||||
methods as is explained in the|bufexplorer-customization|section
|
||||
of the documentation.
|
||||
- Add new 'B', 'o', and 'S' key mappings.
|
||||
7.2.8 November 08, 2010
|
||||
@ -575,7 +503,7 @@ CHANGE LOG *bufexplorer-changelog*
|
||||
- Dave Eggum has made some 'significant' updates to this latest
|
||||
version:
|
||||
* Added BufExplorerGetAltBuf() global function to be used in the
|
||||
user's rulerformat.
|
||||
user<EFBFBD>s rulerformat.
|
||||
* Added g:bufExplorerSplitRight option.
|
||||
* Added g:bufExplorerShowRelativePath option with mapping.
|
||||
* Added current line highlighting.
|
||||
@ -702,7 +630,7 @@ CHANGE LOG *bufexplorer-changelog*
|
||||
- Thanks to Andre Pang for the original patch/idea to get bufexplorer
|
||||
to work in insertmode/modeless mode (evim).
|
||||
- Added Initialize and Cleanup autocommands to handle commands that
|
||||
need to be performed when starting or leaving bufexplorer.
|
||||
need to be performed when starting or leaving bufexplorer.
|
||||
6.0.15 February 20, 2002
|
||||
- Srinath Avadhanulax added a patch for winmanager.vim.
|
||||
6.0.14 February 19, 2002
|
||||
@ -764,7 +692,7 @@ TODO *bufexplorer-todo*
|
||||
===============================================================================
|
||||
CREDITS *bufexplorer-credits*
|
||||
|
||||
Author: Jeff Lanzarotta <delux256-vim at outlook dot com>
|
||||
Author: Jeff Lanzarotta <delux256-vim at yahoo dot com>
|
||||
|
||||
Credit must go out to Bram Moolenaar and all the Vim developers for
|
||||
making the world's best editor (IMHO). I also want to thank everyone who
|
||||
@ -774,7 +702,7 @@ won't list names.
|
||||
===============================================================================
|
||||
COPYRIGHT *bufexplorer-copyright*
|
||||
|
||||
Copyright (c) 2001-2017, Jeff Lanzarotta
|
||||
Copyright (c) 2001-2014, Jeff Lanzarotta
|
||||
All rights reserved.
|
||||
|
||||
Redistribution and use in source and binary forms, with or without
|
||||
|
Reference in New Issue
Block a user