From 74f68d0149f2a94780c860b0775d1e880dbe9225 Mon Sep 17 00:00:00 2001
From: Luke Shumaker <LukeShu@sbcglobal.net>
Date: Wed, 5 Mar 2014 10:57:57 -0500
Subject: teach libremessages:setup_traps to be able to use a custom signal
 handler

---
 src/lib/libremessages.1.ronn | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

(limited to 'src/lib/libremessages.1.ronn')

diff --git a/src/lib/libremessages.1.ronn b/src/lib/libremessages.1.ronn
index d4c35fc..d39dad0 100644
--- a/src/lib/libremessages.1.ronn
+++ b/src/lib/libremessages.1.ronn
@@ -69,9 +69,14 @@ Unless otherwise noted, these do not implicitly call `gettext`.
      Joins all arguments with whitespace, and sets the terminal title
      to that.
 
-   * `setup_traps`:
+   * `setup_traps` [<HANDLER>]:
      Sets traps on TERM, HUP, QUIT and INT signals, as sell as the ERR
-     event, similar to makepkg.
+     event, similar to makepkg.  If <HANDLER> is specified, instead of
+     using the default handler (which is good for most purposes), it
+     will call <HANDLER> with the arguments
+     `<HANDLER> <SIGNAL_NAME> <MESSAGE> [<MESSAGE_ARGS>...]`, where
+     <MESSAGE> is a `printf`(1)-formatted string, and <MESSAGE_ARGS>
+     are its arguments.
 
 ### PROSE ROUTINES
 
-- 
cgit v1.2.3-54-g00ecf