From 6d47df31e962e1e5b9bc3e6b5a3a5a3f9c3b4997 Mon Sep 17 00:00:00 2001
From: Curtis McEnroe <june@causal.agency>
Date: Mon, 14 Jan 2019 15:58:35 -0500
Subject: Add cash.7 README

---
 bin/cash/cash.7 | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 bin/cash/cash.7

(limited to 'bin/cash/cash.7')

diff --git a/bin/cash/cash.7 b/bin/cash/cash.7
new file mode 100644
index 00000000..35f9fc4f
--- /dev/null
+++ b/bin/cash/cash.7
@@ -0,0 +1,63 @@
+.Dd January 14, 2019
+.Dt CASH 7
+.Os "Causal Agency"
+.
+.Sh NAME
+.Nm cash
+.Nd the Causal Agency shell
+.
+.Sh DESCRIPTION
+.Nm
+is a shell derived from
+.Fx
+.Xr sh 1 ,
+which is in turn derived from Almquist shell.
+It includes
+.Xr editline 3
+from
+.Nx .
+.
+.Ss Differences from Xr sh 1
+.Bl -bullet
+.It
+.Va ENV
+defaults to
+.Ql ${XDG_CONFIG_HOME:-${HOME}/.config}/cash/env.sh .
+.
+.It
+.Va PS0
+is printed before each prompt,
+allowing multi-line prompts.
+.
+.It
+Right-aligned prompts can be set with
+.Va RPS1
+and
+.Va RPS2 .
+.
+.It
+.Va PSlit
+can be used to embed terminal escape sequences in prompts,
+as in
+.Nx
+.Xr sh 1 .
+.
+.It
+.Va HOME
+is shortened to
+.Sq ~
+in prompt expansion.
+.
+.It
+.Ic fc Fl s Ar = Ns Ar new
+allows prefixing commands with
+.Ar new .
+.El
+.
+.Sh HISTORY
+.Xr sh 1
+sources were imported from
+.Fx 12.0 .
+.Xr editline 3
+sources were imported from
+.Nx 8.0 .
-- 
cgit 1.4.1