From 7f162666995e927e7a8abf7f6441feee44d5cc8f Mon Sep 17 00:00:00 2001
From: Peter Taoussanis <peter@taoensso.com>
Date: Tue, 16 Apr 2024 10:57:24 +0200
Subject: [PATCH] [new] Incl. sig filter system val info in internal docs

---
 src/taoensso/telemere.cljc | 29 ++++++++++++++++++++++-------
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/src/taoensso/telemere.cljc b/src/taoensso/telemere.cljc
index a9d8d08..c00d67a 100644
--- a/src/taoensso/telemere.cljc
+++ b/src/taoensso/telemere.cljc
@@ -51,7 +51,25 @@
    :sf-arity 4
    :ct-sig-filter   impl/ct-sig-filter
    :*rt-sig-filter* impl/*rt-sig-filter*
-   :*sig-handlers*  impl/*sig-handlers*})
+   :*sig-handlers*  impl/*sig-handlers*
+   :sig-filter-system-vals-info
+   "These include:
+
+    Compile-time:
+
+      ns-filter: (get-env {:as :edn} :taoensso.telemere/ct-ns-filter<.platform><.edn>)
+      id-filter: (get-env {:as :edn} :taoensso.telemere/ct-id-filter<.platform><.edn>)
+      min-level: (get-env {:as :edn} :taoensso.telemere/ct-min-level<.platform><.edn>)
+
+    Runtime:
+
+      ns-filter: (get-env {:as :edn}                 :taoensso.telemere/rt-ns-filter<.platform><.edn>)
+      id-filter: (get-env {:as :edn}                 :taoensso.telemere/rt-id-filter<.platform><.edn>)
+      min-level: (get-env {:as :edn, :default :info} :taoensso.telemere/rt-min-level<.platform><.edn>)
+
+    See `get-env` for details."})
+
+(comment help:filters)
 
 (comment
   [level-aliases
@@ -79,16 +97,13 @@
   #?(:clj impl/with-signals)
   #?(:clj impl/signal!))
 
-;;;; Signal help
-
-(comment help:filters help:handlers) ; Via Encore
+;;;; Help
 
 (impl/defhelp help:signal-options    :signal-options)
 (impl/defhelp help:signal-content    :signal-content)
-(impl/defhelp help:signal-flow       :signal-flow)
+(enc/defalias help:signal-filters    help:filters)  ; Via Encore
+(enc/defalias help:signal-handlers   help:handlers) ; Via Encore
 (impl/defhelp help:signal-formatters :signal-formatters)
-(enc/defalias help:signal-filters    help:filters)
-(enc/defalias help:signal-handlers   help:handlers)
 
 ;;;; Context