blob: 8ee64f3998e5871dcfaecc29c49336e9e6d56da6 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
*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:
|
