summary refs log tree commit diff
path: root/bin/catsh/README
diff options
context:
space:
mode:
Diffstat (limited to 'bin/catsh/README')
-rw-r--r--bin/catsh/README28
1 files changed, 28 insertions, 0 deletions
diff --git a/bin/catsh/README b/bin/catsh/README
new file mode 100644
index 00000000..ccd41938
--- /dev/null
+++ b/bin/catsh/README
@@ -0,0 +1,28 @@
+CATSH(7)               Miscellaneous Information Manual               CATSH(7)
+
+NAME
+     catsh – a shell
+
+DESCRIPTION
+     catsh is a shell derived from FreeBSD sh(1), which is in turn derived
+     from Almquist shell.  It includes editline(3) from NetBSD.
+
+   Differences from sh(1)
+     •   ENV defaults to ‘${XDG_CONFIG_HOME:-${HOME}/.config}/catsh/env.sh’.
+
+     •   PS0 is printed before each prompt, allowing multi-line prompts.
+
+     •   Right-aligned prompts can be set with RPS1 and RPS2.
+
+     •   PSlit can be used to embed terminal escape sequences in prompts, as
+         in NetBSD sh(1).
+
+     •   HOME is shortened to ‘~’ in prompt expansion.
+
+     •   fc -s =new allows prefixing commands with new.
+
+HISTORY
+     sh(1) sources were imported from FreeBSD 12.0.  editline(3) sources were
+     imported from NetBSD 8.0.
+
+Causal Agency                  January 14, 2019                  Causal Agency