updated docs and notes...

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

Viewer/Makefile

@@ -36,15 +36,15 @@
 #
 #
 ## To print full list of user make targets use:
-## 	$ make help
+## 	$$ make help
 ##
-##
+## In some cases making things directly starting from a clean directory
-## In some cases making things may fail on a clean directory, if this 
+## may either fail or use global version of a utility instead of the 
-## happens first build the environment and then try again:
+## version specified for the app, if this happens first build the 
-##	$ make dev
+## environment and then try again:
+##	$$ make dev
 ##	...
-##	$ make dist
+##	$$ make dist
-##
 ##
 ## Variables to control the build:
 ## 	APP_NAME	- Application name
@@ -70,46 +70,40 @@
 ## NOTE: cross compilation is at this time not supported, if you try it 
 ## 	and it works then 1) you got very lucky and 2) tell me about it =)
 ## 	...at least the node native packages (sharp) will likely either 
-## 	fail or	will get compiled to the wrong arch and not be used and 
+## 	fail or	will get compiled to the wrong arch and not be used, and 
 ##	some non-native packages may misbehave (though I'm not aware of 
 ##	any at this point, so report them if you encounter one).
 ##	This is complicated by the fact that most of ImageGrid.Viewer is
 ##	platform-agnostic and will run on almost anything and will simply 
 ##	try to ignore broken packages and features depending on them, so
 ##	check the console log for any odd load reports...
-##	...but note that cross-building and packaging is possible either
+##	...but note that cross-building and packaging is only possible 
-##	without the native modules or with them pre-built for the target
+##	either without the native modules or with them pre-built for the 
-##	platform.
+##	target platform, at this point.
 ##
 ##
 ## Examples:
 ##	# check if all dependencies are available...
-##	$ make check
+##	$$ make check
 ##
 ##	# make development environment...
-##	$ make dev
+##	$$ make dev
 ##
 ## 	# full build...
-## 	$ make clean dist
+## 	$$ make clean dist
 ##
 ##	# build in repack mode...
-##	$ BUILD_MODE=repack make dist
+##	$$ BUILD_MODE=repack make dist
 ##
 ## 	# build for darwin... (EXPERIMENTAL)
-## 	$ TARGET_OS=darwin make clean dist
+## 	$$ TARGET_OS=darwin make clean dist
 ##
 #
 #
 #----------------------------------------------------------------------
 #
 # ToDo:
-# 	- sync version numbers between:
+# 	- sync version numbers between with git tags (when used)
-# 		- git tags (currently not used)
-# 		- package.json
-# 			can't use only this because it can't be imported 
-# 			in browser directly...
-# 			...do we actually need the file:// version working?
-# 		- version.js
 # 	- app icons...
 # 	- add a cli-only build target...
 # 	- installers:
@@ -182,7 +176,6 @@ LESSC := $(NPX) lessc
 # 		   procs to access their paths (as is done below)
 # 		2) set path and launch a child make -- not sure how to 
 # 		   do this...
-#
 ELECTRON := $(NPX) electron
 ELECTRON_REBUILD := $(NPX) electron-rebuild
 ASAR := $(NPX) asar

Viewer/doc/MAKE

@@ -2,15 +2,15 @@
 ImageGrid.Viewer Makefile...
 
 To print full list of user make targets use:
-	 make help
+	$ make help
 
-
+In some cases making things directly starting from a clean directory
-In some cases making things may fail on a clean directory, if this 
+may either fail or use global version of a utility instead of the 
-happens first build the environment and then try again:
+version specified for the app, if this happens first build the 
-	 make dev
+environment and then try again:
+	$ make dev
 	...
-	 make dist
+	$ make dist
-
 
 Variables to control the build:
 	APP_NAME	- Application name
@@ -31,33 +31,33 @@ NOTE: to do a repack build call:
 NOTE: cross compilation is at this time not supported, if you try it 
 	and it works then 1) you got very lucky and 2) tell me about it =)
 	...at least the node native packages (sharp) will likely either 
-	fail or	will get compiled to the wrong arch and not be used and 
+	fail or	will get compiled to the wrong arch and not be used, and 
 	some non-native packages may misbehave (though I'm not aware of 
 	any at this point, so report them if you encounter one).
 	This is complicated by the fact that most of ImageGrid.Viewer is
 	platform-agnostic and will run on almost anything and will simply 
 	try to ignore broken packages and features depending on them, so
 	check the console log for any odd load reports...
-	...but note that cross-building and packaging is possible either
+	...but note that cross-building and packaging is only possible 
-	without the native modules or with them pre-built for the target
+	either without the native modules or with them pre-built for the 
-	platform.
+	target platform, at this point.
 
 
 Examples:
 	# check if all dependencies are available...
-	 make check
+	$ make check
 
 	# make development environment...
-	 make dev
+	$ make dev
 
 	# full build...
-	 make clean dist
+	$ make clean dist
 
 	# build in repack mode...
-	 BUILD_MODE=repack make dist
+	$ BUILD_MODE=repack make dist
 
 	# build for darwin... (EXPERIMENTAL)
-	 TARGET_OS=darwin make clean dist
+	$ TARGET_OS=darwin make clean dist
 
 
 Help and info:

Viewer/doc/NOTES

@@ -1,4 +1,11 @@
 
+Version numbers
+===============
+
+The app version number is automatically synced between package.json (primary)
+and version.js. All version changes should be made in the former.
+
+
 Debugging startup errors
 ========================