|author||Tom Ryder <firstname.lastname@example.org>||2017-11-04 18:46:01 +1300|
|committer||Tom Ryder <email@example.com>||2017-11-04 18:46:01 +1300|
Update dotfiles(7) manual from README.md
1 files changed, 21 insertions, 3 deletions
diff --git a/man/man7/dotfiles.7df b/man/man7/dotfiles.7df
index fe56e138..fbb1da64 100644
@@ -142,6 +142,8 @@ Fork of the rxvt terminal emulator with Unicode support
Subversion (https://subversion.apache.org/) \[en] Apache Subversion, a
version control system
.IP \[bu] 2
+tidy (http://www.html-tidy.org/) \[en] HTML/XHTML linter and tidier
+.IP \[bu] 2
tmux (https://tmux.github.io/) \[en] Terminal multiplexer similar to GNU
.IP \[bu] 2
@@ -475,13 +477,29 @@ I try not to deviate too much from the Vim defaults behaviour in terms
of interactive behavior and keybindings.
The configuration is broken into subfiles in
-\f[C]\&.vim/config/*.vim\f, included by \f[C]~/.vimrc\f using
+\f[C]~/.vim/config/*.vim\f, included by \f[C]~/.vimrc\f using
It's extensively commented, mostly because I was reading through it one
day and realised I'd forgotten what half of it did.
+If the logic for doing something involves more than a few lines or any
+structures like functions, I like to implement it as a plugin in
+\f[C]~/.vim/plugin\f and/or \f[C]~/.vim/autoload\f.
+There's documentation for each of those in \f[C]~/.vim/doc\f.
+I also define a few custom per\-filetype rules for stuff I often edit in
+\f[C]~/.vim/ftplugin\f, including some local mappings for checking,
+linting, and tidying.
+Any/all of the general or filetype plugins may eventually be spun off
+into their own repositories in the future, but for the moment they live
+Contact me if you find one of them useful and you'd like to see it in
+its own distribution.
-Plugins are in submodules in \f[C]\&.vim/bundle\f, loaded using Tim
-Pope's pathogen.vim (https://github.com/tpope/vim-pathogen).
+Third\-party plugins are in submodules in \f[C]~/.vim/bundle\f, loaded
+using Tim Pope's pathogen.vim (https://github.com/tpope/vim-pathogen).
Where practical, I make short scripts into POSIX (but not Bourne)