Permalink
Browse files

Version 7.0.12

MAJOR Update. Please Note that this version will ONLY run with Vim version 7.0 or greater.

Dave Eggum has made some 'significant' updates to this latest version:
  - Added BufExplorerGetAltBuf() global function to be used in the user’s rulerformat.
  - Added g:bufExplorerSplitRight option.
  - Added g:bufExplorerShowRelativePath option with mapping.
  - Added current line highlighting.
  - The split type can now be changed whether bufexplorer is opened in split mode or not.
  - Various major and minor bug fixes and speed improvements.
  - Sort by extension.
  Other improvements/changes:
  - Changed the help key from '?' to <F1> to be more 'standard'.
  - Fixed splitting of vertical bufexplorer window.
  • Loading branch information...
jeff lanzarotta authored and vim-scripts committed Nov 30, 2006
1 parent 2cb26dd commit a15953a20a638c7ba0d776c076ee152ada510ff8
Showing with 543 additions and 637 deletions.
  1. +66 −28 doc/bufexplorer.txt
  2. +477 −609 plugin/bufexplorer.vim
View
@@ -1,7 +1,7 @@
-*bufexplorer.txt* Buffer Explorer Last Change: 10 Mar 2006
+*bufexplorer.txt* Buffer Explorer Last Change: 30 Nov 2006
Buffer Explorer *buffer-explorer* *bufexplorer*
- Version 7.0.11
+ Version 7.0.12
Plugin for easily exploring (or browsing) open buffers
@@ -12,6 +12,7 @@ Plugin for easily exploring (or browsing) open buffers
|bufexplorer-todo| Todo
|bufexplorer-credits| Credits
+For Vim version 7.0 and above.
This plugin is only available if 'compatible' is not set.
{Vi does not have any of this}
@@ -31,6 +32,7 @@ Note: If the current buffer is modified, the current window is always
Command to use once exploring:
+ <F1> Toggle help information.
<cr> or Opens the buffer that is under the cursor into the current
<leftmouse> window.
S Opens the buffer that is under the cursor into a newly split
@@ -39,24 +41,25 @@ Command to use once exploring:
o Toggles open mode. Only available in 'split mode'.
p Toggles the showing of a split filename/pathname.
q Quit exploring.
- s Selects the order the buffers are listed in. Either by their
- name, by their number or by most recently used (MRU).
- t Toggles split type. Only available in 'split mode'.
r Reverses the order the buffers are listed in.
- ? Displays help information.
+ R Toggles relative path/absolute path.
+ s Selects the order the buffers are listed in. Either by buffer
+ number, file name, file extension, most recently used (MRU), or
+ full path.
+ t Toggles split type. Only available in 'split mode'.
Typically one would put bufexplorer.vim into the .vim/plugin directory
(vimfiles\plugin for Windows) where it becomes automatically available
for use. It sets up it's default keymaps to use \be and \bs. If you would
like to use something other than '\', you may simply change the leader
(see |mapleader|).
-Once invoked, Buffer Explorer display a sorted list 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 the sort, quit exploring
-and so on...
+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
+the sort, quit exploring and so on...
You can avoid loading this plugin by setting the "loaded_bufexplorer"
variable: >
@@ -72,10 +75,11 @@ The default is not to show detailed help.
*g:bufExplorerSortBy*
To control what field the buffers are sorted by, use: >
- let g:bufExplorerSortBy='number' " Sort by the buffer's number.
- let g:bufExplorerSortBy='name' " Sort by the buffer's name.
+ let g:bufExplorerSortBy='extension' " Sort by file extension.
+ let g:bufExplorerSortBy='fullpath' " Sort by full file path name.
let g:bufExplorerSortBy='mru' " Sort by most recently used.
- let g:bufExplorerSortBy='fullPath' " Sort by full file path name.
+ let g:bufExplorerSortBy='name' " Sort by the buffer's name.
+ let g:bufExplorerSortBy='number' " Sort by the buffer's number.
The default is to sort by mru.
*g:bufExplorerSplitBelow*
@@ -86,13 +90,26 @@ current window, use: >
The default is to use what ever is set by the global &splitbelow
variable.
+ *g:bufExplorerSplitRight*
+To control when opening a new window, if the new window is split to the
+right or to the left of the current window, use: >
+ let g:bufExplorerSplitRight=0 " Split left.
+ let g:bufExplorerSplitRight=1 " Split right.
+The default is to use the global &splitright.
+
*g:bufExplorerSplitType*
To control the type of split when creating a new window, use: >
let g:bufExplorerSplitType='' " Split horizontally.
let g:bufExplorerSplitType='v' " Split vertically.
The default is to split horizontally.
- *g:bufexplorersplitvertsize*
+ *g:bufExplorerOpenMode*
+To control how the selected buffer is opened in 'split mode', use: >
+ let g:bufExplorerOpenMode=1 " Open using current window.
+ let g:bufExplorerOpenMode=0 " Open in new window.
+The default is to use a new window.
+
+ *g:bufexplorerSplitVertSize*
To control the width of the window when opening a new window vertically
use: >
let g:bufExplorerSplitVertSize = [width]
@@ -104,12 +121,6 @@ use: >
let g:bufExplorerSplitHorzSize = [height]
The default is 0, which is to use half the existing height.
- *g:bufExplorerOpenMode*
-To control how the selected buffer is opened in 'split mode', use: >
- let g:bufExplorerOpenMode=1 " Open using current window.
- let g:bufExplorerOpenMode=0 " Open in new window.
-The default is to use a new window.
-
*g:bufExplorerSortDirection*
To control whether to sort the buffers in forward or reverse order, use: >
let g:bufExplorerSortDirection=1 " Sort in forward order.
@@ -130,9 +141,33 @@ To control whether to show directories in the buffer list or not, use: >
let g:bufExplorerShowDirectories=0 " Don't show directories.
Note: This is only available when using vim 7.0 and above.
+ *g:bufExplorerShowRelativePath*
+To control whether to show absolute paths or relative to the current
+directory, use: >
+ let g:bufExplorerShowRelativePath=0 " Show absolute paths.
+ let g:bufExplorerShowRelativePath=1 " Show relative paths.
+The default is to show absolute paths.
+
===============================================================================
CHANGE LOG *bufexplorer-changelog*
+7.0.12 - MAJOR Update.
+ This version will ONLY run with Vim version 7.0 or greater.
+ Dave Eggum has made some 'significant' updates to this latest
+ version:
+ - Added BufExplorerGetAltBuf() global function to be used in the
+ user�s rulerformat.
+ - Added g:bufExplorerSplitRight option.
+ - Added g:bufExplorerShowRelativePath option with mapping.
+ - Added current line highlighting.
+ - The split type can now be changed whether bufexplorer is opened
+ in split mode or not.
+ - Various major and minor bug fixes and speed improvements.
+ - Sort by extension.
+ Other improvements/changes:
+ - Changed the help key from '?' to <F1> to be more 'standard'.
+ - Fixed splitting of vertical bufexplorer window.
+ Hopefully I have not forgot something :)
7.0.11 - Fixed a couple of highlighting bugs, reported by David Eggum. He also
changed passive voice to active on a couple of warning messages.
7.0.10 - Fixed bug report by Xiangjiang Ma. If the 'ssl' option is set,
@@ -172,7 +207,7 @@ CHANGE LOG *bufexplorer-changelog*
E493 would be displayed.
7.0.1 - Thanks to Erwin Waterlander for finding a couple problems.
The first problem allowed a modified buffer to be deleted. Opps! The
- second problem occured when several files were opened, BufExplorer
+ second problem occurred when several files were opened, BufExplorer
was started, the current buffer was deleted using the 'd' option, and
then BufExplorer was exited. The deleted buffer was still visible
while it is not in the buffers list. Opps again!
@@ -182,9 +217,9 @@ CHANGE LOG *bufexplorer-changelog*
(g:bufExplorerSplitHorzSize) of a new window when opening
bufexplorer horizontally. By default, the windows are normally
split to use half the existing width or height.
-6.3.0 - Added keepjumps so that the jumps list would not get clutered with
+6.3.0 - Added keepjumps so that the jumps list would not get cluttered with
bufexplorer related stuff.
-6.2.3 - Thanks to Jay Logan for finding a bug in the vertical split postion
+6.2.3 - Thanks to Jay Logan for finding a bug in the vertical split position
of the code. When selecting that the window was to be split
vertically by doing a '\bv', from then on, all splits, i.e. '\bs',
were split vertically, even though g:bufExplorerSplitType was not set
@@ -194,8 +229,8 @@ CHANGE LOG *bufexplorer-changelog*
'setlocal nofoldenable' and it was fixed.
6.2.1 - Thanks goes out to Takashi Matsuo for added the 'fullPath' sorting
logic and option.
-6.2.0 - Thanks goes out to Simon Johann-Günter for spotting and fixing a
- problem in that the last search pattern is overriden by the search
+6.2.0 - Thanks goes out to Simon Johann-Ganter for spotting and fixing a
+ problem in that the last search pattern is overridden by the search
pattern for blank lines.
6.1.6 - Thanks to Artem Chuprina for finding a pesky bug that has been around
for sometime now. The <esc> key mapping was causing the buffer
@@ -261,7 +296,10 @@ CHANGE LOG *bufexplorer-changelog*
===============================================================================
TODO *bufexplorer-todo*
-Sort by extension.
+- Erwin Waterlander suggestion of being able to open the explorer with one
+ buffer.
+- Once the ability to save and restore a jumplist is added to Vim, we need
+ prevent the jumplist from updating when the user searches in bufexplorer.
===============================================================================
CREDITS *bufexplorer-credits*
Oops, something went wrong.

0 comments on commit a15953a

Please sign in to comment.