1 files changed, 54 insertions, 0 deletions
diff --git a/bin/man/dtch.1 b/bin/man/dtch.1
new file mode 100644
index 00000000..ad13c109
--- /dev/null
+++ b/bin/man/dtch.1
@@ -0,0 +1,54 @@
+.Dd September 7, 2018
+.Dt DTCH 1
+.Os "Causal Agency"
+.
+.Sh NAME
+.Nm dtch ,
+.Nm atch
+.Nd detached sessions
+.
+.Sh SYNOPSIS
+.Nm
+.Op Ar name Op Ar command ...
+.Nm atch
+.Op Ar name
+.
+.Sh DESCRIPTION
+.Nm
+spawns the
+.Ar command
+(by default, the user's shell)
+inside a new PTY.
+It then lends control of the detached PTY to
+.Nm atch
+over a UNIX-domain socket.
+.Nm
+should be run as a background job or with
+.Xr nohup 1 .
+.
+.Pp
+.Nm atch
+attaches to the
+.Nm
+session with the corresponding
+.Ar name .
+To detach from a session, type
+.Ic ^Q .
+.
+.Sh FILES
+.Bl -tag
+.It Pa ~/.dtch/ Ns Ar name
+UNIX-domain socket for the session
+.Ar name .
+.El
+.
+.Sh EXAMPLES
+.Bd -literal -offset indent
+dtch foo vim &
+atch foo
+.Ed
+.
+.Sh SEE ALSO
+.Xr nohup 1 ,
+.Xr screen 1 ,
+.Xr forkpty 3