docs: update README

• update installation string
    • add "About" section
main
McAuley Penney 3 years ago
parent 1b2a6b336d
commit 98b6209b31

@ -1,4 +1,3 @@
# tidy.nvim 🧹
A function and autocommand pair that removes all
@ -10,26 +9,26 @@ on every `BufWritePre`.
![tidy](https://user-images.githubusercontent.com/59481467/148654417-73a2eaeb-272e-4cb8-910b-870f2f46fa0a.gif)
**Notes**: See the `cfg` branch for increased functionality and configuration.
**Note**: See the `cfg` branch for increased functionality and configuration.
## About
I wrote this as a wrapper around a few of the classic and ecumenical vim regex commands for formatting files before I began using formatters. These commands can be found in any vim resource; they are not mine. My contribution is a basic conditional which protects the user from an error when the cursor is in the group of empty lines removed from the end of the buffer. Even with real formatters in my setup now I still like and use this because I like these specific formats to be applied to every buffer and don't want to have a formatting tool installed for them. There really isn't a reason to have this in a plugin other than wanting to disseminate this for new users and people who didn't know you could do this. You could (should) instead just yank and put the code right in your config.
## Installation
- Packer
```lua
use "McAuleyPenney/tidy.nvim"
use "mcauley-penney/tidy.nvim"
```
or with lazy-loading
```lua
use{ "McAuleyPenney/tidy.nvim", event = "BufWritePre" }
use{ "mcauley-penney/tidy.nvim", event = "BufWritePre" }
```
## Todo
- [ ] preserve undotree
## Credits
- [Vim Tips Wiki entry for removing unwanted spaces](https://vim.fandom.com/wiki/Remove_unwanted_spaces#Automatically_removing_all_trailing_whitespace)
@ -39,3 +38,7 @@ use{ "McAuleyPenney/tidy.nvim", event = "BufWritePre" }
- [This line](https://github.com/gpanders/editorconfig.nvim/blob/ae3586771996b2fb1662eb0c17f5d1f4f5759bb7/lua/editorconfig.lua#L180)
in [gpanders/editorconfig.nvim](https://github.com/gpanders/editorconfig.nvim) for exposing me to the `keepjumps`
and `keeppatterns` modifiers
## Todo
- [ ] preserve undotree

Loading…
Cancel
Save