path: root/man
diff options
authorTom Ryder <tom@sanctum.geek.nz>2017-10-29 00:16:46 +1300
committerTom Ryder <tom@sanctum.geek.nz>2017-10-29 00:16:46 +1300
commit70fcb350c9fe0de853051b387032dd5687b4df76 (patch)
treeaf2dd8d36b4d87e633ccf2906db667b39f49498d /man
parentAdjust description of Vim configuration (diff)
Rebuild dotfiles(7) manual from README.md
Diffstat (limited to 'man')
1 files changed, 17 insertions, 19 deletions
diff --git a/man/man7/dotfiles.7df b/man/man7/dotfiles.7df
index 5538fdd2..0c398eb0 100644
--- a/man/man7/dotfiles.7df
+++ b/man/man7/dotfiles.7df
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 1.17.2
+.\" Automatically generated by Pandoc
-.TH "DOTFILES" "7" "June 2016" "Tom Ryder's personal scripts and configuration" ""
+.TH "" "" "" "" ""
.SH Dotfiles (Tom Ryder)
@@ -301,9 +301,6 @@ repository.
\f[C]ed()\f[] tries to get verbose error messages, a prompt, and a
Readline environment for \f[C]ed(1)\f[].
.IP \[bu] 2
-\f[C]env()\f[] sorts the output of \f[C]env(1)\f[] if it was invoked
-with no arguments, just for convenience when running it interactively.
-.IP \[bu] 2
\f[C]gdb()\f[] silences startup messages from \f[C]gdb(1)\f[].
.IP \[bu] 2
\f[C]gpg()\f[] quietens \f[C]gpg(1)\f[] down for most commands.
@@ -472,15 +469,19 @@ My \f[C]~/.inputrc\f[] file binds Alt+M to run that, and Tmux in turn
binds the same key combination to detach.
.SS Vim
-The majority of the \f[C]\&.vimrc\f[] file is just setting options, with
-a few mappings.
+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 behaviour in terms
of interactive behavior and keybindings.
-The configuration is extensively commented, mostly because I was reading
-through it one day and realised I'd forgotten what half of it did.
-Plugins are loaded using \@tpope's
-pathogen.vim (https://github.com/tpope/vim-pathogen).
+The configuration is broken into subfiles 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 realised I'd forgotten what half of it did.
+Plugins are in submodules in \f[C]\&.vim/bundle\f[], loaded using Tim
+Pope's pathogen.vim (https://github.com/tpope/vim-pathogen).
.SS Scripts
Where practical, I make short scripts into POSIX (but not Bourne)
@@ -889,6 +890,11 @@ input.
\f[C]kvlt(6df)\f[] translates input to emulate a style of typing unique
to black metal communities on the internet.
.IP \[bu] 2
+\f[C]philsay(6df)\f[] shows a picture to accompany \f[C]pks(6df)\f[]
+.IP \[bu] 2
+\f[C]pks(6df)\f[] laughs at a randomly selected word.
+.IP \[bu] 2
\f[C]rndn(6df)\f[] implements an esoteric random number generation
.IP \[bu] 2
@@ -904,12 +910,6 @@ occurrence of \[lq]s\[rq] in the text on its standard input.
The \f[C]install\-bin\f[] and \f[C]install\-games\f[] targets install
manuals for each script they install.
-There's also an \f[C]install\-dotfiles\-man\f[] target that uses
-\f[C]pandoc(1)\f[] to reformat this document as a manual page for
-section 7 (\f[C]dotfiles(7df)\f[]) if you want that.
-I haven't made that install by default, because \f[C]pandoc(1)\f[] is a
-bit heavy.
If you want to use the manuals, you may need to add
\f[C]~/.local/share/man\f[] to your \f[C]~/.manpath\f[] or
\f[C]/etc/manpath\f[] configuration, depending on your system.
@@ -943,5 +943,3 @@ Software in the Public Interest (https://www.spi-inc.org/)
FreeBSD Foundation (https://www.freebsdfoundation.org/)
.IP \[bu] 2
OpenBSD Foundation (http://www.openbsdfoundation.org/)
-Tom Ryder.