From d80aca31fbecd3b19aebd41eeeac74b29e99a038 Mon Sep 17 00:00:00 2001
From: "Alex A. Naanou" <alex.nanou@gmail.com>
Date: Sat, 30 May 2020 01:17:13 +0300
Subject: [PATCH] docs...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
---
 README.md | 14 ++++++++++++--
 object.js | 27 ++++++++++++++++++---------
 2 files changed, 30 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index a7b75b4..a23a0cc 100755
--- a/README.md
+++ b/README.md
@@ -522,8 +522,7 @@ one of the following:
 
 Special case: get callable implementations
 ```
-sources(<object>, '__call__')
-sources(<object>, '__call__', <callback>)
+sources(<object>, '__call__', ..)
 	-> <list>
 ```
 
@@ -563,6 +562,17 @@ callback(<descriptor>, <source>)
 	-> <value>
 ```
 
+
+Special case: get callable implementations
+```
+values(<object>, '__call__', ..)
+	-> <list>
+```
+
+This will return the callable objects themselves or the value of `.__call__`.
+
+
+
 See [`sources(..)`](#sources) for docs on `callback(..)` and special cases.
 
 ### `parent(..)`
diff --git a/object.js b/object.js
index baada08..85c9a8d 100755
--- a/object.js
+++ b/object.js
@@ -155,6 +155,12 @@ module.STOP =
 // 		-> list
 // 		-> []
 // 		
+// 	Get callables or objects defining .__call__ (special-case)
+// 	sources(obj, '__call__')
+// 	sources(obj, '__call__', callback)
+// 		-> list
+// 		-> []
+// 		
 // 	callback(obj)
 // 		-> STOP
 // 		-> ..
@@ -172,7 +178,7 @@ module.STOP =
 // 						NOTE: an ampty array will effectively omit the 
 // 							triggering object from the results.
 // 	- other			- return a value instead of the triggering object.
-// 		
+//
 //
 // NOTE: this gos up the prototype chain, not caring about any role (
 // 		instance/class or instance/prototype) bounderies and depends 
@@ -181,11 +187,6 @@ module.STOP =
 // 		for any overloading in the instance, though this approach is 
 // 		not very reusable....
 // NOTE: this will not trigger any props...
-//
-// XXX document the '__call__' special case...
-// 		- '__call__' gets either the callable prototype or .__call__(..)
-// 		- priority...
-// 		- 
 var sources =
 module.sources =
 function(obj, name, callback){
@@ -229,9 +230,12 @@ function(obj, name, callback){
 // 		-> ..
 // 		
 //
-// NOTE: for more docs on the callback(..) see sources(..)
+// Special case: name is given as '__call__'
+// 		This will return either the value the object if it is callable 
+// 		or the value of .__call__ attribute...
 //
-// XXX document the '__call__' cpecial case...
+//
+// NOTE: for more docs on the callback(..) see sources(..)
 var values =
 module.values =
 function(obj, name, callback, props){
@@ -266,6 +270,11 @@ function(obj, name, callback, props){
 // 		-> value
 // 		-> undefined
 //
+// 	Get parent callable or .__call__ value (special-case)
+// 	parent(proto, '__call__')
+// 		-> value
+// 		-> undefined
+//
 // 	Get parent method...
 // 	parent(method, this)
 // 		-> meth
@@ -633,7 +642,7 @@ function(context, constructor, ...args){
 							// 		parent...
 							Reflect.apply(
 								constructor.prototype, obj, [this, ...arguments])
-						// .__call__(..)
+						// .__call__(..) or fail semi-gracefully...
 						: constructor.prototype.__call__
 							.call(obj, this, ...arguments)) },
 				constructor)