aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorTom Ryder <tom@sanctum.geek.nz>2017-03-24 14:02:59 +1300
committerTom Ryder <tom@sanctum.geek.nz>2017-03-24 14:02:59 +1300
commit2e28d5a885608fddd1e0b7464ba3c9582a9e8ca4 (patch)
treef2ac4ae683f7dd4cfa416813bf93838df0de256d /man
parentRemove double-up colon check in path() (diff)
downloaddotfiles-2e28d5a885608fddd1e0b7464ba3c9582a9e8ca4.tar.gz
dotfiles-2e28d5a885608fddd1e0b7464ba3c9582a9e8ca4.zip
Add exm(1df) to work around Vim's screen-clearing
Diffstat (limited to 'man')
-rw-r--r--man/man1/exm.1df22
1 files changed, 22 insertions, 0 deletions
diff --git a/man/man1/exm.1df b/man/man1/exm.1df
new file mode 100644
index 00000000..892ca326
--- /dev/null
+++ b/man/man1/exm.1df
@@ -0,0 +1,22 @@
+.TH EXM 1df "March 2017" "Manual page for exm"
+.SH NAME
+.B exm
+\- invoke Vim's ex(1) with a dumb terminal
+.SH SYNOPSIS
+.B exm
+[EX_OPTIONS...] [FILES]
+.SH DESCRIPTION
+.B exm
+works around a quirk of Vim that causes it to clear the screen when invoked as
+ex(1) interactively. It applies Vim's -T option to force the terminal to the
+builtin "dumb" terminal.
+.SH CAVEATS
+This doesn't work on its first invocation from any given terminal, but does
+work thereafter. I haven't yet figured out why.
+.P
+This breaks switching to visual mode with :visual somewhat, as the terminal
+will persist in its dumb state. I'm not sure there's a way to fix this. If
+there were a Vim :autocmd for mode switching, it might be possible, or perhaps
+by wrapping :visual somehow to :set terminal=$TERM.
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>