summary refs log tree commit diff
path: root/bin/catsh/catsh.7
blob: e41544fdf851121d5de7efc6e2634a9b161f822c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
.Dd January 14, 2019
.Dt CATSH 7
.Os "Causal Agency"
.
.Sh NAME
.Nm catsh
.Nd a 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}/catsh/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 .