aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTom Ryder <tom@sanctum.geek.nz>2018-06-06 18:04:24 +1200
committerTom Ryder <tom@sanctum.geek.nz>2018-06-06 18:04:24 +1200
commitfca745eb90e767871c274f1dd2abf4e479874d98 (patch)
treebb70b743e029fa151247bf677510665998dfecf5
parentf0c63f6ae45795a955459074eb961ce40fe96f1d (diff)
downloaddotfiles-fca745eb90e767871c274f1dd2abf4e479874d98.tar.gz
dotfiles-fca745eb90e767871c274f1dd2abf4e479874d98.zip
Rebuild dotfiles(7) manual page
-rw-r--r--man/man7/dotfiles.7df25
1 files changed, 19 insertions, 6 deletions
diff --git a/man/man7/dotfiles.7df b/man/man7/dotfiles.7df
index c215ae80..6960e3c5 100644
--- a/man/man7/dotfiles.7df
+++ b/man/man7/dotfiles.7df
@@ -477,12 +477,17 @@ The majority of the Vim configuration is just setting options, with a
few mappings.
I try not to deviate too much from the Vim defaults behavior in terms of
interactive behavior and keybindings.
-.PP
-The configuration is broken into smaller files in
-\f[C]~/.vim/config/*.vim\f[], included by \f[C]~/.vimrc\f[] using
-\f[C]:runtime\f[] (http://vimdoc.sourceforge.net/htmldoc/repeat.html#:runtime).
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 \f[C]~/.vim/config\f[].
+.SS Filetypes
+.PP
+I define my own \f[C]filetype.vim\f[] and \f[C]scripts.vim\f[], 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 \f[C]~/.vim\f[], you'll get the stock
+filetype detection back.
.SS Plugins
.PP
If the logic for doing something involves more than a few lines or any
@@ -501,6 +506,14 @@ All plugins and colorschemes are available as submodules in
\f[C]~/.vim/bundle\f[].
They are installed into \f[C]~/.vim\f[].
.PP
+I still use two third\-party plugins: Tim Pope's
+repeat.vim (https://www.vim.org/scripts/script.php?script_id=2136) and
+surround.vim (https://www.vim.org/scripts/script.php?script_id=1697).
+In my opinion, these plugins are so fundamental and useful that they
+should have been implemented in or bundled with Vim itself many years
+ago.
+.SS Filetype plugins
+.PP
I also define a few rules specific to file types I often edit in
\f[C]~/.vim/after/ftplugin\f[], including some local mappings for
checking, linting, and tidying, and a few more in
@@ -508,8 +521,8 @@ checking, linting, and tidying, and a few more in
There are also a few tweaks to core syntax files in
\f[C]~/.vim/after/syntax\f[], especially for shell script
(\f[C]sh.vim\f[]).
-Some/all of these filetype plugins are also due to be separately
-distributed and installed via submodules instead.
+Some of these filetype plugins are also due to be separately distributed
+and installed via submodules instead.
.SS Neovim
.PP
I test my configuration every now and then with the Neovim