Added combined option to build process, and updated the readme.

Signed-off-by: Lanny McNie <lanny@gskinner.com>

Author: Lanny McNie

build/Gruntfile.js

@@ -35,6 +35,17 @@ module.exports = function (grunt) {
 					}
 				},
 
+				concat: {
+					options: {
+						separator: ''
+					},
+					build: {
+						files: {
+							'output/<%= pkg.name.toLowerCase() %>-<%= version %>.combined.js': getCombinedSource()
+						}
+					}
+				},
+
 				// Build docs using yuidoc
 				yuidoc: {
 					compile: {
@@ -130,7 +141,44 @@ module.exports = function (grunt) {
 		return config[name];
 	}
 
+	function getCombinedSource() {
+		var configs = [
+			{cwd: '', config:'config.json', source:'easel_source'}
+		];
+
+		return combineSource(configs);
+	}
+
+	function combineSource(configs) {
+		// Pull out all the source paths.
+		var sourcePaths = [];
+		for (var i=0;i<configs.length;i++) {
+			var o = configs[i];
+			var json = grunt.file.readJSON(path.resolve(o.cwd, o.config));
+			var sources = json[o.source];
+			sources.forEach(function(item, index, array) {
+				array[index] = path.resolve(o.cwd, item);
+			});
+			sourcePaths = sourcePaths.concat(sources);
+		}
+
+		// Remove duplicates (Like EventDispatcher)
+		var dups = {};
+		var clean = [];
+		for (i=0;i<sourcePaths.length;i++) {
+			var src = sourcePaths[i];
+			var cleanSrc = src.substr(src.lastIndexOf('src' + path.sep));
+			if  (dups[cleanSrc] == null) {
+				clean.push(src);
+				dups[cleanSrc] = true;
+			}
+		}
+
+		return clean;
+	}
+
 	// Load all the tasks we need
+	grunt.loadNpmTasks('grunt-contrib-concat');
 	grunt.loadNpmTasks('grunt-contrib-uglify');
 	grunt.loadNpmTasks('grunt-contrib-yuidoc');
 	grunt.loadNpmTasks('grunt-contrib-compress');
@@ -174,4 +222,13 @@ module.exports = function (grunt) {
 	grunt.registerTask('coreBuild', [
 		"updateversion", "uglify", "docs", "copy:src"
 	]);
+
+	/**
+	 * Task for exporting combined view.
+	 *
+	 */
+	grunt.registerTask('combine', 'Combine all source into a single, un-minified file.', [
+		"concat"
+	]);
+
 };

build/README.md

@@ -1,34 +1,30 @@
-## We use grunt (http://gruntjs.com/) to manage our build process.
-
-If you previously used an older process, you may want to clean up the node_modules and output folders.
+## EaselJS uses [Grunt](http://gruntjs.com/) to manage the build process.
 
 ## To use
 
 ### Install dependencies
 
 Node (0.10.x or greater is required):
 
-   # check the version
-   node -v
+	# check the version
+	node -v
 
-If your node is out of date, install the latest from:
-http://nodejs.org/
+If your node is out of date, install the latest from [NodeJS.org](http://nodejs.org/)
 
-After node is setup, install the other dependances:
+After node is setup, install the other dependencies:
 
-   # Install the grunt command line utility
-   sudo npm install grunt-cli -g
+	# Install the grunt command line utility
+	sudo npm install grunt-cli -g
 
-   # Install all the dependencies for this project.
-   npm install
+	# Install all the dependencies for this project.
+	npm install
 
 ### Setup
 
-You'll need to change the default settings to suit your work environment.
-We have 2 config files:
+You'll need to change the default settings to suit your work environment. We have 2 config files:
 
-* config.json - Is meant to be in git and pushed to all developers.
-* config.local.json - Is added to .gitignore and and only for your local setup (any settings in here will override those in config.json)
+* config.json: Meant to be in git and pushed to all developers.
+* config.local.json: Added to .gitignore and and only for your local setup (any settings in here will override those in config.json)
 
 Please adjust these settings to match your environment. All paths can either be relative from the build folder, or absolute paths.
 
@@ -37,28 +33,35 @@ Please adjust these settings to match your environment. All paths can either be
 ### Building
 To export a release build for this library run:
 
-   grunt build
+    grunt build
 
 This command will:
 
-* Update the version.js file(s).
+* Update the version.js file(s) with the current date and version number
 * Create the {PROJECT_NAME}-{VERSION}.min.js file
-* Compile the docs to config.docs_out_path
-* Create a zip file of the docs/
-* Copy the docs zip to ../docs
-* Copy the built js file to ../lib
-* Copy All examples from ../examples to config.examples_out_path
+* Compile the documentation to config.docs_out_path
+* Create a zip file of the documentation
+* Copy the documentation zip to ../docs
+* Copy the generated .js file to ../lib
+* Copy All examples from ../examples to config.examples_out_path (part of the overall build process)
+
+**NEXT version**
+
+The same process as above, but uses "NEXT" as the version. This is used to generate minified builds with the latest source between tags.
+
+	grunt next
 
-To build the NEXT version run:
+**Combined File**
 
-grunt next
+The same as the NEXT process, but will not minify the source code. All code formatting and comments are left intact.
 
-Does the exact same process as above but uses NEXT as the version.
+	grunt combine
 
 
 ### All commands
 
-grunt build -  Build everything based on the version in package.json
-grunt next - Build everything using the NEXT version.
-grunt docs - Build only the docs
-grunt uglify - Create the Easel and MovieClip min files. (Will use NEXT as the version)
+* grunt build -  Build everything based on the version in package.json
+* grunt next - Build everything using the NEXT version.
+* grunt combine - Build a NEXT version, but leave comments and formatting intact.
+* grunt docs - Build only the docs
+* grunt uglify - Create the Easel and MovieClip min files. (Will use NEXT as the version)

build/package.json

@@ -6,6 +6,7 @@
   "logo": "http://createjs.com/resources/SuiteIcons/EaselJS/docs-icon-EaselJS.png",
   "devDependencies": {
     "grunt": "~0.4.1",
+	"grunt-contrib-concat":"~0.3.0",
     "grunt-contrib-uglify": "~0.2.1",
     "grunt-contrib-yuidoc": "~0.4.0",
     "grunt-contrib-compress": "~0.5.0",