From 7ab38a5c3c38948729a1afc8db7eca081d9b2433 Mon Sep 17 00:00:00 2001
From: "Alex A. Naanou" <alex.nanou@gmail.com>
Date: Fri, 28 Oct 2022 18:21:22 +0300
Subject: [PATCH] more doc updates...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
---
 README.md | 29 +++++++++++++++++++++++++----
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 2381d8c..e1c12d3 100644
--- a/README.md
+++ b/README.md
@@ -2868,6 +2868,10 @@ Handlers can be bound to an eventful method via `.on(<method-name>, ...)`,
 unbound via `.off(<method-name>)`, 
 see: [`event.EventHandlerMixin`](#eventeventhandlermixin) for more info.
 
+```dnf
+<handler>(<event-name>, ...)
+```
+
 
 The event `<func>(..)` gets the `<handle-func>(..)` as first argument 
 followed by the arguments passed to `<method>(..)` when called.
@@ -2960,22 +2964,39 @@ https://github.com/flynx/object.js#mixin
 
 #### `<obj>.on(..)`
 
-<!-- XXX -->
+Bind a handler to an _event_ or an _eventful_ method.
+```dnf
+<obj>.on(<event-name>, <handler>)
+	-> <obj>
+```
 
 
 #### `<obj>.one(..)`
 
-<!-- XXX -->
+Like `<obj>.on(..)` but the `<handler>` will be called only once.
+```dnf
+<obj>.one(<event-name>, <handler>)
+	-> <obj>
+```
 
 
 #### `<obj>.off(..)`
 
-<!-- XXX -->
+Unbind `<handler>` from _event_.
+```dnf
+<obj>.off(<event-name>, <handler>)
+	-> <obj>
+```
 
 
 #### `<obj>.trigger(..)`
 
-<!-- XXX -->
+Trigger an _event_.
+```dnf
+<obj>.trigger(<event-name>)
+<obj>.trigger(<event-name>, ...)
+	-> <obj>
+```