Adding comment and moving index.ts for tasks to gulpfile.ts. It was confusing

Author: hansl

gulpfile.js

@@ -1,7 +1,12 @@
 'use strict';
-const path = require('path');
+/**
+ * Load the TypeScript compiler, then load the TypeScript gulpfile which simply loads all
+ * the tasks. The tasks are really inside tools/gulp/tasks.
+ */
 
+const path = require('path');
 
+// Register TS compilation.
 require('ts-node').register({
   project: path.join(__dirname, 'tools/gulp')
 });

tools/gulp/gulpfile.ts

@@ -1 +1,10 @@
-import './tasks';
+import './tasks/ci';
+import './tasks/clean';
+import './tasks/components';
+import './tasks/default';
+import './tasks/development';
+import './tasks/e2e';
+import './tasks/lint';
+import './tasks/release';
+import './tasks/serve';
+import './tasks/spec';

tools/gulp/tasks/ci.ts

@@ -2,7 +2,7 @@ import {task} from 'gulp';
 
 
 task('ci:lint', ['ci:forbidden-identifiers', 'lint']);
-task('ci:test', ['test:single-run'], function() { process.exit(0); });
+task('ci:test', ['test:single-run']);
 task('ci:e2e', ['e2e']);
 task('ci:extract-metadata', [':build:components:ngc']);
 task('ci:forbidden-identifiers', function() {

tools/gulp/tasks/e2e.ts

@@ -32,6 +32,9 @@ task('build:e2eapp', buildAppTask('e2eapp'));
 
 task(':test:protractor:setup', execNodeTask('protractor', 'webdriver-manager', ['update']));
 task(':test:protractor', execNodeTask('protractor', [PROTRACTOR_CONFIG_PATH]));
+// This task is used because, in some cases, protractor will block and not exit the process,
+// causing Travis to timeout. This task should always be used in a synchronous sequence as
+// the last step.
 task(':e2e:done', () => process.exit(0));
 
 let stopE2eServer: () => void = null;