telemere/main/resources/signal-docstrings
Peter Taoussanis fda22ce80c [mod] Signal options: drop :location, add :coords
This is the input-side change related to [1], and only
affects folks who've been providing custom callsite info to
Telemere signals (usually in the context of wrapper macros).

To provide custom callsite info BEFORE this commit:
  (tel/signal! {:location {:ns "my-ns", :line 10, :column 20}})

To provide custom callsite info AFTER this commit:
  (tel/signal! {:ns "my-ns", :coords [10 20]})

Motivation for the new override API:

  - It's shorter and cleaner.
  - It's less likely to cause confusion since it avoids the
    redundant signal keys (signals previously contained callsite
    info in 2 duplicate places).
  - The underlying implementation is simpler.
  - The util for manually getting coords is easier to use and doesn't
    require macro-time environment info, making it easier for folks
    to write wrapper macros that include line + column info.
  - When embedded, the new callsite info is shorter and easier for
    Cljs advanced compilation to de-duplicate (so helps reduce .js
    build size).

[1] Commit 1f99f7186b
2025-02-27 12:44:55 +01:00
..
catch-to-error!.txt [nop] Simplify dir structure 2025-01-14 10:35:25 +01:00
environmental-config.txt [doc] Misc improvements 2025-02-12 09:18:44 +01:00
error!.txt [nop] Simplify dir structure 2025-01-14 10:35:25 +01:00
event!.txt [nop] Simplify dir structure 2025-01-14 10:35:25 +01:00
log!.txt [nop] Simplify dir structure 2025-01-14 10:35:25 +01:00
signal!.txt [nop] Simplify dir structure 2025-01-14 10:35:25 +01:00
signal-content.txt [mod] Signal content: drop :location, add :coords 2025-02-27 12:44:30 +01:00
signal-creators.txt [nop] Simplify dir structure 2025-01-14 10:35:25 +01:00
signal-options.txt [mod] Signal options: drop :location, add :coords 2025-02-27 12:44:55 +01:00
spy!.txt [fix] [#45] spy! docstring typo (@rafd) 2025-01-22 14:52:38 +01:00
trace!.txt [nop] Simplify dir structure 2025-01-14 10:35:25 +01:00