126 lines
4.2 KiB
Markdown
126 lines
4.2 KiB
Markdown
# vim-lastplace v3.2.1
|
|
|
|
Intelligently reopen files at your last edit position. By default git,
|
|
svn, and mercurial commit messages are ignored because you
|
|
probably want to type a new message and not re-edit the previous
|
|
one.
|
|
|
|
## Advantages
|
|
Advantages over the snippets that can be found around the net include:
|
|
* Commit messages automatically start at the beginning of a file. This is important because many version control systems re-use the same file for commit message editing.
|
|
* Maximizes Available Context
|
|
- Center the cursor vertically after restoring last edit position.
|
|
- Keep as much of the file on screen as possible when last edit position is at the end of the file.
|
|
* Opens folds if the last edit position is inside a fold.
|
|
* Works properly with new file templates and scripts that jump to a specific line in them.
|
|
|
|
## Installation
|
|
### Vim 8 & Beyond:
|
|
You can install vim-lastplace as a vim plugin without any additional tools
|
|
|
|
```bash
|
|
mkdir -p ~/.vim/pack/plugins/start
|
|
rm -rf ~/.vim/pack/plugins/start/vim-lastplace
|
|
git clone --depth=1 https://github.com/farmergreg/vim-lastplace.git ~/.vim/pack/plugins/start/vim-lastplace
|
|
```
|
|
### Pathogen:
|
|
You can also use [pathogen.vim](https://github.com/tpope/vim-pathogen) or other plugin managers to install and use vim-lastplace.
|
|
|
|
```bash
|
|
cd ~/.vim/bundle
|
|
git clone git://github.com/farmergreg/vim-lastplace.git
|
|
```
|
|
### Preventing Conflicts:
|
|
Depending on which Vim package you're using, Vim may be preconfigured with
|
|
last-edit-position logic that doesn't work quite as well as vim-lastplace.
|
|
If so, you may want to disable that in favor of vim-lastplace. For example,
|
|
for Vim as packaged with Git for Windows, you can edit
|
|
`C:\Program Files\Git\etc\vimrc` and comment out the "Remember positions in files"
|
|
`autocmd BufReadPost *` block.
|
|
|
|
## Configuration
|
|
You can configure what file types to ignore by setting
|
|
g:lastplace_ignore in your vimrc. This is a comma separated list.
|
|
By default it is set to:
|
|
|
|
```vim
|
|
let g:lastplace_ignore = "gitcommit,gitrebase,svn,hgcommit"
|
|
````
|
|
|
|
You can configure buffer types to ignore by setting
|
|
g:lastplace_ignore_buftype in your vimrc. This is a comma separated list.
|
|
By default it is set to:
|
|
|
|
```vim
|
|
let g:lastplace_ignore_buftype = "quickfix,nofile,help"
|
|
```
|
|
|
|
Closed folds are automatically opened when jumping to the last edit position. If you
|
|
do not like this behavior you can disable it by putting this in your vimrc:
|
|
|
|
```vim
|
|
let g:lastplace_open_folds = 0
|
|
```
|
|
|
|
## Miscellaneous
|
|
This plugin is complete and stable. Please do not be afraid to try it even
|
|
if there is very little recent activity in this repository. If you do find
|
|
a bug, please submit a pull request that fixes whatever problem you're having.
|
|
|
|
## Version History
|
|
vim-lastplace uses [semver](http://semver.org/) to manage version numbers.
|
|
|
|
### 3.2.1
|
|
- Re-center screen when opening folds
|
|
- Documentation fixes and updates
|
|
|
|
### 3.1.1
|
|
- Add 'nofile' and 'help' to lastplace_ignore_buftype. (Issue [#14](https://github.com/farmergreg/vim-lastplace/issues/14))
|
|
- Do not jump when a new file is created (Issue [#15](https://github.com/farmergreg/vim-lastplace/issues/15), [#16](https://github.com/farmergreg/vim-lastplace/issues/16))
|
|
|
|
### 3.1.0
|
|
- Add g:lastplace_ignore_buftype setting.
|
|
- Update github links from username dietsche to farmergreg.
|
|
|
|
### 3.0.4
|
|
- Add g:lastplace_open_folds option.
|
|
|
|
### 3.0.3
|
|
- Point release for Debian packaging. Changes all http links to https. No code changes.
|
|
|
|
### 3.0.2
|
|
- A fix for files that are smaller than the current screen size (issue #8)
|
|
|
|
### 3.0.1
|
|
- A fix for files with modelines.
|
|
|
|
### 3.0.0
|
|
|
|
- Open folds if the last edited area is inside a closed fold.
|
|
|
|
### 2.0.1
|
|
|
|
- Add gitrebase filetype to the ignore list.
|
|
|
|
### 2.0.0
|
|
|
|
- Center the screen when restoring the cursor position.
|
|
- When at the end of a file, keep as much of it on screen as possible.
|
|
|
|
### 1.0.0
|
|
|
|
- Initial version.
|
|
|
|
## About
|
|
|
|
- Author : Gregory L. Dietsche
|
|
- Web Page: https://www.gregd.org/
|
|
|
|
Get the latest version, submit pull requests, and file bug reports
|
|
on GitHub:
|
|
- https://github.com/farmergreg/vim-lastplace
|
|
|
|
If you like this plugin, please star and rate it on these sites:
|
|
|
|
- [GitHub](https://github.com/farmergreg/vim-lastplace)
|
|
- [Vim.org](http://www.vim.org/scripts/script.php?script_id=5090)
|