   "Registers a standard on-event handler with key which will call
    handler when matching triggers are recieved. Triggers are created
    with the send-trig ugen. Handler should be a fn which takes one
-   argument - the latest trigger value."
+   argument - the latest trigger value.
+
+   Consider using trig-id to create a unique trigger id
+
+    ;; create new id
+    (def uid (trig-id))
+
+    ;; define a synth which uses send-trig
+    (defsynth foo
+              [t-id 0]
+              (send-trig (impulse 10) t-id (sin-osc)))
+
+    ;; register a handler fn
+    (on-trigger uid
+                (fn [val] (println \"trig val:\" val))
+                ::debug)
+
+    ;; create a new instance of synth foo with trigger id as a
+    ;; param
+    (foo uid)"
   ([trig-id handler key]
      (add-handler on-event [:overtone :trigger trig-id] handler key))
   ([node trig-id handler key]

  "Registers a standard on-latest-event handler with key which will call
   handler when matching triggers are recieved. Triggers are created
   with the send-trig ugen. Handler should be a fn which takes one
   argument - the latest trigger value."
  ([trig-id handler key]
     (add-handler on-latest-event [:overtone :trigger trig-id] handler key))
  ([node trig-id handler key]

  "Returns a new globally unique id useful for feeding into send-trig
   and matching on the event stream.

   See on-trigger docstring for usage example."
  []
  (next-id ::trig-id))

