src/lib/pubsub/lib_pubsub.md

   1 @dir /lib/pubsub
   2 @brief lib/pubsub: Publish-subscribe message passing.
   3
   4 This module wraps the \refdir{lib/dispatch} module, to provide a more
   5 ergonomic and type-safe approach to message passing.
   6
   7 In general, we favor this mechanism for cases where higher-level modules
   8 need to be notified when something happens in lower-level modules. (The
   9 alternative would be calling up from the lower-level modules, which
  10 would be error-prone; or maintaining lists of function-pointers, which
  11 would be clumsy and tend to complicate the call graph.)
  12
  13 See pubsub.c for more information.
  14