blob: 93a4d89c4526233f0703f743232cd4c197b95cf8 (
plain) (
tree)
|
|
*strip_trailing_whitespace.txt* For Vim version 6.0 Last change: 2018 June 27
DESCRIPTION *strip_trailing_whitespace*
This plugin provides a mapping target with the author's approach to stripping
trailing whitespace from an entire buffer, including removing empty or
whitespace-only lines at the end of the buffer, without making command noise
and without moving the cursor from its current position.
This is a very commonly written and implemented plugin, but I wrote my own
because I could not find a plugin that did this in exactly the way I wanted:
- Provide a |<Plug>| mapping
- Strip trailing lines as well as trailing spaces
- Accurately report what was changed
- Work with even very old Vim (>=6.0)
- Work with a single |undo|
- Don't move the cursor
- Don't change the search pattern
- Don't define an |autocmd|
- Don't define a user command
- Don't force a key mapping
- Don't define a global function
REQUIREMENTS *strip_trailing_whitespace-requirements*
This plugin is only available if 'compatible' is not set.
MAPPINGS *strip_trailing_whitespace-mappings*
*<Plug>StripTrailingWhitespace*
The single mapping target provided is |<Plug>StripTrailingWhitespace|,
mappable in any mode. There is no default key mapping to the target; you
should define this yourself in your |vimrc|. For example:
>
nmap <Leader>x <Plug>StripTrailingWhitespace
<
AUTHOR *strip_trailing_whitespace-author*
Written and maintained by Tom Ryder <tom@sanctum.geek.nz>.
LICENSE *strip_trailing_whitespace-license*
Licensed for distribution under the same terms as Vim itself (see |license|).
vim:tw=78:ts=8:ft=help:norl:
|