Skip to content

Delete buffers and close files in Vim without closing your windows or messing up your layout.

License

Notifications You must be signed in to change notification settings

MenBrial/vim-bbye

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bbye (Buffer Bye) for Vim

Bbye allows you to do delete buffers (close files) without closing your windows or messing up your layout.

Vim by default closes all windows that have the buffer (file) open when you do :bdelete. If you've just got your splits and columns perfectly tuned, having them messed up equals a punch in the face and that's no way to tango.

Bbye gives you :Bdelete and :Bwipeout commands that behave like well designed citizens:

  • Close and remove the buffer.
  • Show another file in that window.
  • Show an empty file if you've got no other files open.
  • Do not leave useless [no file] buffers if you decide to edit another file in that window.
  • Work even if a file's open in multiple windows.
  • Work a-okay with various buffer explorers and tabbars.

Regain your throne as king of buffers!

Installing

The easiest way to install Bbye is to use a plugin manager.

Otherwise download Bbye to ~/.vim/bundle:

mkdir -p ~/.vim/bundle/bbye

Using Git:

git clone https://github.com/RobertAudi/vim-bbye.git ~/.vim/bundle/bbye

Using Wget:

wget https://github.com/RobertAudi/vim-bbye/archive/master.tar.gz -O- | tar -xf- --strip-components 1 -C ~/.vim/bundle/bbye

Then prepend that directory to Vim's &runtimepath (or use Pathogen):

set runtimepath^=~/.vim/bundle/bbye

Using

Instead of :bdelete and :bwipeout, use :Bdelete and :Bwipeout respectively. Fortunately autocomplete helps by sorting :Bdelete before its lowercase brother.

As it's likely you'll be using :Bdelete often, make a shortcut to \q, for example, to save time. Throw this to your vimrc:

:nnoremap <Leader>q :Bdelete<CR>

Buffer delete vs wipeout

Vim has two commands for closing a buffer: :bdelete and :bwipeout. The former removes the file from the buffer list, clears its options, variables and mappings. However, it remains in the jumplist, so Ctrl-o takes you back and reopens the file. If that's not what you want, use :bwipeout or Bbye's equivalent :Bwipeout where you would've used :bdelete.

Closing vim when deleting the last buffer

If the variable g:bbye_close_on_last is set to v:true, upon closing the last buffer with either :Bdelete or :Bwipeout, vim will quit.

Closing all open buffers and files

Occasionally you'll want to close all open buffers and files while leaving your pristine window setup as is. That's easy. Just do:

:bufdo :Bdelete

For some variations, like closing all-but-one buffer, see @qiushihe's script in moll#4.

License

Bbye is released under a Lesser GNU Affero General Public License, which in summary means:

  • You can use this program for no cost.
  • You can use this program for both personal and commercial reasons.
  • You do not have to share your own program's code which uses this program.
  • You have to share modifications (e.g bug-fixes) you've made to this program.

For more convoluted language, see the LICENSE file.

About

Andri Möll authored this in SublemacslipseMate++.
Monday Calendar supported the engineering work.
Inspired by Bclose.vim, but rewritten to be perfect.

If you find Bbye needs improving or you've got a question, please don't hesitate to create an issue online.

About

Delete buffers and close files in Vim without closing your windows or messing up your layout.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Vim Script 100.0%