From f3ebc4c9f4a7f048da689d0b85f2c6f3a02704a7 Mon Sep 17 00:00:00 2001
From: "Alex A. Naanou" <alex.nanou@gmail.com>
Date: Tue, 31 Dec 2019 19:47:25 +0300
Subject: [PATCH] docs...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
---
 ui (gen4)/features/filesystem.js | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/ui (gen4)/features/filesystem.js b/ui (gen4)/features/filesystem.js
index de261747..b678a20b 100755
--- a/ui (gen4)/features/filesystem.js	
+++ b/ui (gen4)/features/filesystem.js	
@@ -2445,25 +2445,29 @@ var FileSystemWriterUIActions = actions.Actions({
 	// XXX this needs feedback...
 	// XXX should this return a promise???
 	saveIndexHere: ['File/$Save',
-		function(){ 
-			if(this.location.path){ 
-				this.saveIndex() 
+		core.doc`Save changes...
 
-			} else {
-				this.browseExportIndex()
-			}
-		}],
+		NOTE: if .location is empty this will prompt user for save path by 
+			launching .browseExportIndex(..)
+		`,
+		function(){ 
+			this.location.path ? 
+				this.saveIndex() 
+				: this.browseExportIndex() }],
 	// XXX should this be a UI action???
 	// 		...at this point this depends on .saveIndexHere(..), thus 
 	// 		it is here...
 	// XXX should this return a promise???
 	saveFullIndex: ['File/Save ($full)',
+		core.doc`Save full state...
+
+		NOTE: for more info see: .saveIndexHere(..)`,
 		function(){
 			return this
 				.markChanged('all')
 				.saveIndexHere()}],
 	saveWithCommentDialog: ['File/Save with $comment...', 
-		'exportDialog: "save"'],
+		'exportDialog: "save" -- Save full state with a comment...'],
 
 
 	// Export dialog...