aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0f7d95c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+strip\_trailing\_whitespace.vim
+===============================
+
+This plugin provides a mapping target and an optional custom command 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
+- Provide a user command to do the stripping as well if wanted
+- Strip trailing lines as well as trailing spaces, reporting both
+- 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 force a key mapping
+- Don't define a global function
+
+License
+-------
+
+Copyright (c) [Tom Ryder][1]. Distributed under the same terms as Vim itself.
+See `:help license`.
+
+[1]: https://sanctum.geek.nz/