[new] Alias keep-callsite, mention in signal! docs

taoensso · Mar 3, 2025 · bfea515 · bfea515
1 parent ac5feb4
commit bfea515
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 3 deletions.
diff --git 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
@@ -58,6 +58,7 @@
   enc/newline
   enc/comp-middleware
   sigs/default-handler-dispatch-opts
+  truss/keep-callsite
 
   ;; Impl
   impl/msg-splice