aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTom Ryder <tom@sanctum.geek.nz>2019-06-13 11:41:35 +1200
committerTom Ryder <tom@sanctum.geek.nz>2019-06-13 11:41:35 +1200
commit267535086fd934f96a5826278001ec4f58da2416 (patch)
treead58fe4ba0a2bcbf071807b528aa943a2ed4b49e
parentDrop support for Neovim (diff)
downloaddotfiles-267535086fd934f96a5826278001ec4f58da2416.tar.gz
dotfiles-267535086fd934f96a5826278001ec4f58da2416.zip
Update README.md to reflect Vim configuration
-rw-r--r--README.md39
-rw-r--r--vim/vimrc4
2 files changed, 20 insertions, 23 deletions
diff --git a/README.md b/README.md
index 827fb81e..92f53c87 100644
--- a/README.md
+++ b/README.md
@@ -343,17 +343,14 @@ key combination to detach.
The majority of the Vim configuration is just setting options, with a fair few
mappings and remappings, both global and buffer-local. I try not to deviate
too much from the Vim defaults behavior in terms of interactive behavior and
-keybindings. It's extensively commented, mostly because I was reading through
-it one day and realized I'd forgotten what half of it did. System-specific
-configuration files go in `~/.vim/config`.
+keybindings. It's extensively commented.
#### Filetypes
I define my own `filetype.vim` and `scripts.vim`, so that filetype detection
-works in a way I like, and loads quickly. They are very unlikely to suit you
-as they are, but you might be able to extend them with your favourite
-filetypes. If you delete both of them from `~/.vim`, you'll get the stock
-filetype detection back.
+works in a way I like, and loads quickly. They are unlikely to suit you as
+they are, but if you want to use it, you can extend them with your favourite
+filetypes in custom `ftdetect` rules.
#### Plugins
@@ -362,26 +359,26 @@ structures like functions, I like to implement it as a plugin in
`~/.vim/plugin` and/or `~/.vim/autoload`, with documentation for each in
`~/.vim/doc`.
-They eventually get either discarded or spun off into their own repositories,
-added to this repository as submodules under `vim/bundle` instead, and uploaded
-to [vim.org](https://www.vim.org/account/profile.php?user_id=73687).
+They eventually get either discarded if I stop using them, or spun off into
+their own repositories if I don't, and added to this repository as submodules
+under `vim/bundle` instead. Some of them I upload to
+[vim.org](https://www.vim.org/account/profile.php?user_id=73687).
#### Filetype plugins
-I also define a few rules specific to file types I often edit in
-`~/.vim/after/ftplugin`, including some buffer-local mapping targets for
-checking, linting, and tidying, and a few more in `~/.vim/after/indent`. There
-are also a few tweaks to core syntax files in `~/.vim/after/syntax`, especially
-for shell script (`sh.vim`). Some of these filetype plugins are also due to be
-separately distributed and installed via submodules instead.
+I apply some replacement or supplementary configuration specific to file types
+I often edit in `~/.vim` and `~/.vim/after`, in the `ftplugin`, `indent`, and
+`syntax` subdirectories. Some of these filetype plugins or extensions will
+also eventually be removed to be separately distributed, and installed via
+submodules instead.
#### Compilers
-I define a few of my own `:compiler` scripts for `~/.vim/compiler`, for use for
-checking and linting of appropriate filetypes. Because checking (does it
-compile?) and linting (is it correct and well-written?) are separate processes
-for me, I bind them separately with local leader maps; for example, for `perl`
-filetypes, `,c` switches `makprg` to `perl -c`, and `,l` to `perlcritic`.
+I define a few of my own `:compiler` scripts for `~/.vim/compiler` to check and
+lint appropriate filetypes. I bind checking--"does it run?"--and linting--"is
+it good?"--with separate local leader maps; for example, for `perl` filetypes,
+`<LocalLeader>c` switches `makeprg` to `perl -c` for checking, and
+`<LocalLeader>l` to `perlcritic` for linting.
#### No Neovim support
diff --git a/vim/vimrc b/vim/vimrc
index 0c29ecfb..629ab631 100644
--- a/vim/vimrc
+++ b/vim/vimrc
@@ -761,9 +761,9 @@ set nrformats-=octal
" and is near-instinctive now.
"
" Rude system vimrc files tend to switch this back on, though, so we force it
-" back to the default here.
+" off here.
"
-set ruler&
+set noruler
" Sessions preserve window, tab, and buffer layout, and are thereby great for
" more complex and longer-term projects like books, but they don't play