docs: function () {
  
          var obj = {
              somethingReady: _.barrier (),
              whenSomething:  _.trigger () }
  
  
          /*  Test conventional semantics (1:1 multicast)
           */
          $assertEveryCalled (function (mkay1__2, mkay2__2) {
  
              obj.whenSomething (mkay1__2)                // that's how you bind
              obj.whenSomething (mkay2__2)
  
              obj.whenSomething ()                        // that's how you trigger it
              obj.whenSomething ()     })                      
  
  
          /*  Test unbinding
           */
          $assertEveryCalledOnce (function (shouldCall) {
  
              var whenSomething = _.trigger ()
  
              var shouldBeCalled    = function () { shouldCall () },
                  shouldNotBeCalled = function () { $fail }
  
              whenSomething (shouldBeCalled)
              whenSomething (shouldNotBeCalled)
              whenSomething.off (shouldNotBeCalled) // that's how you unbind specific listeners
              whenSomething () })
  
  
          /*  Test 'barrier' semantics + test argument passing
           */
          $assertEveryCalledOnce (function (mkay1, mkay2) {
  
              obj.somethingReady (function (x) {
                  $assert (x === 'foo')               // you may pass arguments to callbacks
                  obj.somethingReady (x)              // should not call anything
                  mkay1 () })
  
              obj.somethingReady (function (x) {
                  $assert (x === 'foo')
                  mkay2 () })
  
              obj.somethingReady ('foo') })   // that's how you trigger it (may pass arguments)
          obj.somethingReady ('bar')          // should not call anything
  
      }