From bfea51570fa0acccb195aed2f458618feda3b17e Mon Sep 17 00:00:00 2001 From: Peter Taoussanis Date: Mon, 3 Mar 2025 11:29:09 +0100 Subject: [PATCH] [new] Alias `keep-callsite`, mention in `signal!` docs --- main/resources/signal-docstrings/signal!.txt | 8 +++++--- main/src/taoensso/telemere.cljc | 1 + 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/main/resources/signal-docstrings/signal!.txt b/main/resources/signal-docstrings/signal!.txt index e70b354..b4a65be 100644 --- a/main/resources/signal-docstrings/signal!.txt +++ b/main/resources/signal-docstrings/signal!.txt @@ -12,9 +12,11 @@ dispatches it to registered handlers for processing (e.g. writing to console/file/queue/db, etc.). Generic signals are fairly low-level and useful mostly for library authors or -advanced users writing their own wrapper macros. Regular users will typically -prefer one of the higher-level signal creators optimized for ease-of-use in -common cases [1]. +advanced users writing their own wrapper macros. NB see `keep-callsite` for +preserving callsite coords when wrapping Telemere macros like `signal!`. + +Regular users will typically prefer one of the higher-level signal creators +optimized for ease-of-use in common cases [1]. Tips: diff --git a/main/src/taoensso/telemere.cljc b/main/src/taoensso/telemere.cljc index 6f85d2d..b1472b8 100644 --- a/main/src/taoensso/telemere.cljc +++ b/main/src/taoensso/telemere.cljc @@ -58,6 +58,7 @@ enc/newline enc/comp-middleware sigs/default-handler-dispatch-opts + truss/keep-callsite ;; Impl impl/msg-splice