From 39877086c7c73afa1abc8bab79e96de5bd3ae40a Mon Sep 17 00:00:00 2001 From: Steven Orvell Date: Mon, 22 May 2017 18:06:05 -0700 Subject: [PATCH] Improve comment more --- lib/mixins/property-effects.html | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/lib/mixins/property-effects.html b/lib/mixins/property-effects.html index f80d371ad8..00da87e9e9 100644 --- a/lib/mixins/property-effects.html +++ b/lib/mixins/property-effects.html @@ -1442,9 +1442,17 @@ } // NOTE: We ensure clients either enable or flush as appropriate. This - // handles two corner cases: (1) clients flush properly when - // connected/enabled before the host enables, (2) clients enable properly - // when not connected/enabled when the host flushes. + // handles two corner cases: + // (1) clients flush properly when connected/enabled before the host + // enables; e.g. + // (a) Templatize stamps with no properties and does not flush and + // (b) the instance is inserted into dom and + // (c) then the instance flushes. + // (2) clients enable properly when not connected/enabled when the host + // flushes; e.g. + // (a) a template is runtime stamped and not yet connected/enabled + // (b) a host sets a property, causing stamped dom to flush + // (c) the stamped dom enables. __enableOrFlushClients() { let clients = this.__dataPendingClients; if (clients) {