tweaks + docs...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>

diff.js

@@ -32,6 +32,11 @@ var MIN_TEXT_LENGTH = 100
 //		- revise name -- this contains two parts:
 //			1. diff / patch and friends
 //			2. cmp and patterns
+//			open candidates:
+//				ig-diff
+//				cdiff
+//				pattern diff
+//
 //		  we need the name to be short and descriptive, possible 
 //		  candidates:
 //		  	- objdiff / object-diff
@@ -39,6 +44,8 @@ var MIN_TEXT_LENGTH = 100
 //		  	- compare
 //		- revise docs...
 //			...should be simpler to enter, maybe example-oriented intro
+//		- diff visualization -- for example see:
+//			https://www.npmjs.com/package/jsondiffpatch
 //
 //
 //---------------------------------------------------------------------

format.js

@@ -1,5 +1,8 @@
 /**********************************************************************
 * 
+* This module describes the diff format and provides basic verification.
+*
+* XXX EXPERIMENTAL...
 *
 *
 **********************************************************************/
@@ -31,6 +34,7 @@ var {
 
 var VALUE =
 module.VALUE = OR(
+	// XXX use these taken from .placeholders...
 	EMPTY,
 	NONE,
 	ANY)
@@ -161,7 +165,7 @@ module.DIFF_OBJECT = AND(
 			AT('diff', DIFF_FLAT)), 
 		AND(
 			AT('structure', 'tree'),
-			AT('diff', DIFF_TREE))) )
+			AT('diff', DIFF_TREE))))