From 9fb3f7a9aba781b901c0b06fdf700a3701870d0b Mon Sep 17 00:00:00 2001
From: Martin Pool <mbp@samba.org>
Date: Mon, 8 Apr 2002 07:46:34 +0000
Subject: [PATCH] Doc rsync_panic_handler()

---
 main.c | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/main.c b/main.c
index 8aad59cd..37c46183 100644
--- a/main.c
+++ b/main.c
@@ -827,6 +827,14 @@ const char *get_panic_action(void)
 }
 
 
+/**
+ * Handle a fatal signal by launching a debugger, controlled by $RSYNC_PANIC_ACTION.
+ *
+ * This signal handler is only installed if we were configured with
+ * --enable-maintainer-mode.  Perhaps it should always be on and we
+ * should just look at the environment variable, but I'm a bit leery
+ * of a signal sending us into a busy loop.
+ **/
 static RETSIGTYPE rsync_panic_handler(int UNUSED(whatsig))
 {
 	char cmd_buf[300];
-- 
2.34.1