- /// call listeners for connected blocks if they are still around.
- /// returns true if notified listeners registered additional listener
+ /// Notify listeners that a block was connected.
+ /// Returns true if notified listeners registered additional watch data (implying that the
+ /// block must be re-scanned and this function called again prior to further block_connected
+ /// calls, see ChainListener::block_connected for more info).