1 files changed, 52 insertions, 0 deletions
diff --git a/vp.1 b/vp.1
new file mode 100644
index 0000000..54f3a62
--- /dev/null
+++ b/vp.1
@@ -0,0 +1,52 @@
+.Dd $Mdocdate$
+.Dt vp 1
+.Os
+.
+.Sh NAME
+.Nm vp
+.Nd run commands interactively
+.
+.Sh SYNOPSIS
+.Nm
+.Op Ar arg ...
+.
+.Sh DESCIPTION
+.Pp
+.Nm
+opens
+.Xr vi 1
+with two custom key mappings, defined in
+.Pa /usr/local/etc/vprc :
+.Bl -tag
+.It Sy g
+Execute the buffer as a shell command
+and append the output to the buffer
+with each line beginning with
+.Sq #\  .
+Lines beginning with
+.Sq #
+are ignored by
+.Sy g .
+.It Sy q
+Remove any lines not beginning with
+.Sq #
+and remove the
+.Sq #\ 
+prefix from all remaining lines.
+.El
+.Pp
+These mappings are useful for interactively testing shell commands.
+Any arguments given to
+.Nm
+are passed on to
+.Xr vi 1 .
+.
+.Sh AUTHORS
+.Pp
+.Nm
+is written by John Ankarström
+.Aq Mt john (at) ankarstrom.se .
+It is inspired by Mateusz Czapliński's
+.Em up
+.Dq ( Ultimate Plumber )
+tool.