From b8c661c6facd7f5803d96f7c31c87811b97975b5 Mon Sep 17 00:00:00 2001
From: Akib Azmain Turja <akib@disroot.org>
Date: Wed, 8 Feb 2023 21:11:45 +0600
Subject: [PATCH] * eat.texi (Querying Before Kill): New chapter
---
eat.texi | 27 +++++++++++++++++++++++++++
1 file changed, 27 insertions(+)
diff --git a/eat.texi b/eat.texi
index d0c09c6..32f15d4 100644
--- a/eat.texi
+++ b/eat.texi
@@ -66,6 +66,7 @@ Basic Operations
Advanced Customizations
* Shell Integration:: Getting the most from Eat and your shell.
+* Querying Before Kill:: Confirming before you kill your terminal.
* Display:: The region where everything is shown.
* Scrollback:: Region for things that went out of display.
* Cursor Types:: Cursor can displayed in many forms.
@@ -466,6 +467,32 @@ face @code{eat-shell-prompt-annotation-failure} control the indicator
used to indicate the command has exited unsuccessfully with non-zero
exit status.
+@node Querying Before Kill
+@cindex querying before kill
+@cindex querying before kill terminal
+@cindex confirm before kill
+@cindex confirm before kill terminal
+@cindex terminal, kill, query
+@cindex terminal, kill, confirm
+@chapter Querying Before Kill
+
+When a terminal is killed, the terminal process is also killed. Since
+the process can do some important things, Eat asks for confirmation
+before killing a terminal with running process by default. Eat
+provides the user option
+@code{eat-query-before-killing-running-terminal} to control this.
+
+@vindex eat-query-before-killing-running-terminal
+@defopt eat-query-before-killing-running-terminal
+When set to @code{nil}, Eat would never ask. When set to @code{t},
+Eat would always ask for confirmation. When set to @code{auto}, Eat
+would ask only if a shell command is running inside the shell running
+in the terminal. This is effective only after shell integration is
+enabled in the shell (@pxref{Shell Integration}) (i.e. after the shell
+integration code is executed on shell); before that it is essentially
+same as @code{t}, and Eat will always query.
+@end defopt
+
@node Display
@cindex display
@chapter Display