From 32470d03244a7dbc8373c30b4fd5cdf4785af699 Mon Sep 17 00:00:00 2001 From: Mike Thompson Date: Sat, 10 Feb 2018 14:59:05 +1100 Subject: [PATCH] Update InterEpoch.md --- docs/HyperlinkedInformation/InterEpoch.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/docs/HyperlinkedInformation/InterEpoch.md b/docs/HyperlinkedInformation/InterEpoch.md index 6be87d7..fe2846f 100644 --- a/docs/HyperlinkedInformation/InterEpoch.md +++ b/docs/HyperlinkedInformation/InterEpoch.md @@ -2,15 +2,14 @@ > "Music is the space between the notes." - Claude Debussy -re-frame-trace is built around the idea of epochs. An epoch captures all of the traces that are emitted by re-frame after handling an event. But what about the traces that are emitted when re-frame *isn't* handling an event? These are the inter-epoch traces. +`re-frame-trace` is built around the idea of epochs. An epoch captures all of the traces emitted by re-frame during the handling an event. But what about the traces that are emitted when re-frame *isn't* handling an event? These are the inter-epoch traces. -Inter-epoch traces are emitted under (at least) four circumstances: +Inter-epoch traces are emitted under (at least) three circumstances: -* Mouse hover state causing subscriptions to run/re-run -* Click/input events sent to local ratoms (rather than as events to app-db) -* Figwheel disposing old subscriptions and re-rendering your application -* Resetting app-db in re-frame-trace +* When views have local ratoms, used, for example, to handle the appearance of popups or mouseover annimations. When the state of these ratoms change, views will likely rerender, and the trace to do with this rerendering will flow from reagent to `re-frame`trace`. But there'll be no "current" epoch to put it in. Because there was no event. +* A Figwheel recompile and subsequent code reload will cause all existing subscriptions to be destroyed, andwill trigger a complete re-render of your application +* `re-frame-trace` itself resetting the value in `app-db`. Again there will be a flurry of subscription and view trace, but no epoch, because there was no event. -The first two of these are essential to your application, the latter two are incidental to the tooling. +The first of these is essential to the functioning of your application, whidh makes their trace interesting and informative. The last two are incidental to the tooling and are probably best ignored. Probably. -re-frame-trace collects any inter-epoch subscription traces and shows them in the subs panel with the next epoch. They are broken out into a separate section marked: "Inter-Epoch Subscriptions". +`re-frame-trace` collects any inter-epoch subscription traces and shows them in the subs panel with the next epoch. They are broken out into a separate section marked: "Inter-Epoch Subscriptions".