docs and notes...

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

ui (gen4)/features/examples.js

@@ -21,10 +21,23 @@ var ExampleActions = actions.Actions({
 		// XXX stuff for togglers...
 	},
 
+	// NOTE: the path / short doc is optional but it is not recommended 
+	// 		to to omit it unless defining a non-root action...
+	// XXX should an action be able to overload the doc???
+	// 		...the intuitive thing to do here is make the doc "write-once"
+	// 		i.e. once defined it can't be overwritten...
 	exampleAction: ['- Test/',
 		function(){
 			// XXX
 		}],
+	exampleActionFull: ['- Test/',
+		core.doc`Example full action long documentation string
+		`,
+		// action attributes...
+		{},
+		function(){
+			// XXX
+		}],
 
 	// a normal method...
 	exampleMethod: function(){
@@ -43,7 +56,7 @@ var ExampleActions = actions.Actions({
 
 	// promise handling...
 	//
-	// also see corresponding WidgetTest.handlers
+	// also see corresponding Example.handlers
 	exampleSyncAction: ['- Test/',
 		//{await: true},
 		function(t){
@@ -59,6 +72,7 @@ var ExampleActions = actions.Actions({
 
 	// Togglers...
 	//
+	// XXX ...
 	exampleToggler: ['- Test/',
 		function(){
 		}],
@@ -129,15 +143,22 @@ module.Example = core.ImageGridFeatures.Feature({
 	title: '',
 	doc: '',
 
-	// XXX
 	tag: 'action-examples',
 	depends: [
-		// XXX
 	],
 
 	actions: ExampleActions, 
 
-	handlers: [],
+	// XXX make this not applicable in production...
+
+	handlers: [
+		['exampleAsyncAction.pre exampleSyncAction.pre',
+			function(){
+				console.log('PRE')
+				return function(){
+					console.log('POST') } 
+			}],
+	],
 })
 
 

ui (gen4)/features/ui-widgets.js

@@ -2655,12 +2655,6 @@ module.WidgetTest = core.ImageGridFeatures.Feature({
 	actions: WidgetTestActions,
 
 	handlers: [
-		['asyncAction.pre syncAction.pre',
-			function(){
-				console.log('PRE')
-				return function(){
-					console.log('POST') } 
-			}],
 	],
 })