From 3996a7ac8910259f4403aee5319cd6a38fc5cd96 Mon Sep 17 00:00:00 2001
From: dmiller <dmiller@e0a8ed71-7df4-0310-8962-fdc924857419>
Date: Mon, 9 Dec 2024 23:02:00 +0000
Subject: [PATCH] Document new meaning of -k for Ncat

---
 ncat/docs/ncat.xml | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/ncat/docs/ncat.xml b/ncat/docs/ncat.xml
index c81e72bc5..91a497434 100644
--- a/ncat/docs/ncat.xml
+++ b/ncat/docs/ncat.xml
@@ -262,7 +262,7 @@
       <varlistentry>
         <term>
           <option>-k</option>,
-          <option>--keep-open</option> (Accept multiple connections)
+          <option>--keep-open</option> (Accept multiple connections, do not quit on socket EOF)
           <indexterm><primary><option>--keep-open</option> (Ncat option)</primary></indexterm>
           <indexterm><primary><option>-k</option> (Ncat option)</primary><see><option>--keep-open</option></see></indexterm>
         </term>
@@ -276,6 +276,12 @@
           until interrupted. This also means that it will never close its
           output stream, so any program reading from Ncat and looking for
           end-of-file will also hang.</para>
+        <para>In connect mode, the <option>-k</option> option has a different
+          meaning: when the remote end of a TCP connection shuts down its side
+          of the connection, Ncat will keep running and sending any available
+          data. This was the default behavior in Ncat 7.95 and earlier, but it
+          was changed to better align with existing netcat implementations. TCP
+          is the only transport that supports this option in connect mode.</para>
         </listitem>
       </varlistentry>