Merge branch 'master' of github.com:flynx/pWiki

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

experiments/outline-editor/editor.js

@@ -1,6 +1,7 @@
 /**********************************************************************
 * 
 *
+* XXX need better general/arch docs...
 *
 **********************************************************************/
 
@@ -163,6 +164,58 @@ var getText = function(elem){
 
 //---------------------------------------------------------------------
 // Plugins...
+//
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//
+// 	var somePlugin = {
+// 		__proto__: plugin,
+//
+// 		XXX
+// 	}
+//
+// 	.encode(<str>)
+// 		-> <str>
+//
+//	.__setup__(<editor>)
+//		-> <this>
+//
+//
+// 	.__parse_code__(<string>, <editor>, <elem>)
+// 		-> <string>
+//
+//
+// 	.__pre_parse__(<string>, <editor>, <elem>)
+// 		-> <string>
+//
+// 	.__parse__(<string>, <editor>, <elem>)
+// 		-> <string>
+//
+// 	.__post_parse__(<string>, <editor>, <elem>)
+// 		-> <string>
+//
+//
+//	.__parse_attrs__(<attrs>, <editor>, <elem>)
+//		-> <attrs>
+//
+//	.__change__()
+//
+//	.__editedview__()
+//	.__editedcode__()
+//
+//	.__click__()
+//	.__focusin__()
+//	.__focusout__()
+//	.__keydown__()
+//	.__keyup__()
+//
+//
+// NOTE: new extension methods can be defined/called in plugins via 
+// 		the .runPlugins(..) method.
+// 		
+//
+//
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//
 
 // general helpers and utils...
 var plugin = {