fix(@angular/cli): add more description

packages/@angular/cli/commands/build.ts

@@ -75,15 +75,18 @@ export const baseBuildCommandOptions: any = [
   },
   {
     name: 'i18n-file',
-     type: String
+    type: String,
+    description: 'Localization file to use for i18n.'
   },
   {
     name: 'i18n-format',
-     type: String
+    type: String,
+    description: 'Format of the localization file specified with --i18n-file.'
   },
   {
     name: 'locale',
-     type: String
+    type: String,
+    description: 'Locale to use for i18n.'
   },
   {
     name: 'extract-css',

packages/@angular/cli/commands/completion.ts

@@ -36,7 +36,7 @@ export interface CompletionCommandOptions {
   all?: boolean;
   bash?: boolean;
   zsh?: boolean;
-};
+}
 
 const commandsToIgnore = [
   'destroy',
@@ -51,9 +51,27 @@ const CompletionCommand = Command.extend({
   description: 'Adds autocomplete functionality to `ng` commands and subcommands.',
   works: 'everywhere',
   availableOptions: [
-    { name: 'all',   type: Boolean, default: true,  aliases: ['a'] },
+    {
-    { name: 'bash',  type: Boolean, default: false, aliases: ['b'] },
+      name: 'all',
-    { name: 'zsh',   type: Boolean, default: false, aliases: ['z'] }
+      type: Boolean,
+      default: true,
+      aliases: ['a'],
+      description: 'Generate a completion script compatible with both bash and zsh.'
+    },
+    {
+      name: 'bash',
+      type: Boolean,
+      default: false,
+      aliases: ['b']
+      description: 'Generate a completion script for bash.'
+    },
+    {
+      name: 'zsh',
+      type: Boolean,
+      default: false,
+      aliases: ['z']
+      description: 'Generate a completion script for zsh.'
+    }
   ],
 
   run: function (commandOptions: CompletionCommandOptions) {

packages/@angular/cli/commands/e2e.ts

@@ -21,22 +21,26 @@ const E2eCommand = Command.extend({
   aliases: ['e'],
   description: 'Run e2e tests in existing project.',
   works: 'insideProject',
-  availableOptions: overrideOptions(
+  availableOptions: overrideOptions([
-    baseServeCommandOptions.concat([
+    ...baseServeCommandOptions,
     {
       name: 'config',
       type: String,
       aliases: ['c'],
-        description: oneLine`Use a specific config file.
+      description: oneLine`
-          Defaults to the protractor config file in angular-cli.json.`
+        Use a specific config file.
+        Defaults to the protractor config file in angular-cli.json.
+      `
     },
     {
       name: 'specs',
       type: Array,
       default: [],
       aliases: ['sp'],
-        description: oneLine`Override specs in the protractor config.
+      description: oneLine`
-          Can send in multiple specs by repeating flag (ng e2e --specs=spec1.ts --specs=spec2.ts).`
+        Override specs in the protractor config.
+        Can send in multiple specs by repeating flag (ng e2e --specs=spec1.ts --specs=spec2.ts).
+      `
     },
     {
       name: 'element-explorer',
@@ -57,18 +61,23 @@ const E2eCommand = Command.extend({
       type: Boolean,
       default: true,
       aliases: ['s'],
-        description: oneLine`Compile and Serve the app.
+      description: oneLine`
-          All non-reload related serve options are also available (e.g. --port=4400).`
+        Compile and Serve the app.
+        All non-reload related serve options are also available (e.g. --port=4400).
+      `
     }
-    ]), [
+  ], [
-      { name: 'port', default: 0 },
+    {
+      name: 'port',
+      default: 0,
+      description: 'The port to use to serve the application.'
+    },
     {
       name: 'watch',
       default: false,
       description: 'Run build when files change.'
     },
-    ]
+  ]),
-  ),
   run: function (commandOptions: E2eTaskOptions) {
     const E2eTask = require('../tasks/e2e').E2eTask;
     this.project.ngConfig = this.project.ngConfig || CliConfig.fromProject();

packages/@angular/cli/commands/eject.ts

@@ -6,7 +6,11 @@ const Command = require('../ember-cli/lib/models/command');
 // defaults for BuildOptions
 export const baseEjectCommandOptions: any = [
   ...baseBuildCommandOptions,
-  { name: 'force', 'type': Boolean },
+  {
+    name: 'force',
+    type: Boolean,
+    description: 'Overwrite any webpack.config.js and npm scripts already existing.'
+  },
   {
     name: 'app',
     type: String,

packages/@angular/cli/commands/get.ts

@@ -15,7 +15,12 @@ const GetCommand = Command.extend({
   works: 'everywhere',
 
   availableOptions: [
-    { name: 'global', type: Boolean, 'default': false }
+    {
+      name: 'global',
+      type: Boolean,
+      'default': false,
+      description: 'Get the value in the global configuration (in your home directory).'
+    }
   ],
 
   run: function (commandOptions: GetOptions, rawArgs: string[]): Promise<void> {

packages/@angular/cli/commands/lint.ts

@@ -1,5 +1,8 @@
+import {oneLine} from 'common-tags';
+
 const Command = require('../ember-cli/lib/models/command');
 
+
 export interface LintCommandOptions {
   fix?: boolean;
   format?: string;
@@ -12,9 +15,27 @@ export default Command.extend({
   description: 'Lints code in existing project.',
   works: 'insideProject',
   availableOptions: [
-    { name: 'fix', type: Boolean, default: false },
+    {
-    { name: 'force', type: Boolean, default: false },
+      name: 'fix',
-    { name: 'format', alias: 't', type: String, default: 'prose' }
+      type: Boolean,
+      default: false,
+      description: 'Fixes linting errors (may overwrite linted files).'
+    },
+    {
+      name: 'force',
+      type: Boolean,
+      default: false,
+      description: 'Succeeds even if there was linting errors.'
+    },
+    {
+      name: 'format',
+      alias: 't',
+      type: String,
+      default: 'prose',
+      description: oneLine`
+        Output format (prose, json, stylish, verbose, pmd, msbuild, checkstyle, vso, fileslist).
+      `
+    }
   ],
   run: function (commandOptions: LintCommandOptions) {
     const LintTask = require('../tasks/lint').default;

packages/@angular/cli/commands/new.ts

@@ -71,7 +71,8 @@ const NewCommand = Command.extend({
       name: 'skip-commit',
       type: Boolean,
       default: false,
-      aliases: ['sc']
+      aliases: ['sc'],
+      description: 'Skip committing the first commit to git.'
     },
     {
       name: 'directory',

packages/@angular/cli/commands/serve.ts

@@ -29,9 +29,15 @@ export interface ServeTaskOptions extends BuildOptions {
 }
 
 // Expose options unrelated to live-reload to other commands that need to run serve
-export const baseServeCommandOptions: any = overrideOptions(
+export const baseServeCommandOptions: any = overrideOptions([
-  baseBuildCommandOptions.concat([
+  ...baseBuildCommandOptions,
-    { name: 'port', type: Number, default: defaultPort, aliases: ['p'] },
+  {
+    name: 'port',
+    type: Number,
+    default: defaultPort,
+    aliases: ['p'],
+    description: 'Port to listen to for serving.'
+  },
   {
     name: 'host',
     type: String,
@@ -39,10 +45,30 @@ export const baseServeCommandOptions: any = overrideOptions(
     aliases: ['H'],
     description: `Listens only on ${defaultHost} by default.`
   },
-    { name: 'proxy-config', type: 'Path', aliases: ['pc'] },
+  {
-    { name: 'ssl', type: Boolean, default: defaultSsl },
+    name: 'proxy-config',
-    { name: 'ssl-key', type: String, default: defaultSslKey },
+    type: 'Path',
-    { name: 'ssl-cert', type: String, default: defaultSslCert },
+    aliases: ['pc'],
+    description: 'Proxy configuration file.'
+  },
+  {
+    name: 'ssl',
+    type: Boolean,
+    default: defaultSsl,
+    description: 'Serve using HTTPS.'
+  },
+  {
+    name: 'ssl-key',
+    type: String,
+    default: defaultSslKey,
+    description: 'SSL key to use for serving HTTPS.'
+  },
+  {
+    name: 'ssl-cert',
+    type: String,
+    default: defaultSslCert,
+    description: 'SSL certificate to use for serving HTTPS.'
+  },
   {
     name: 'open',
     type: Boolean,
@@ -50,7 +76,13 @@ export const baseServeCommandOptions: any = overrideOptions(
     aliases: ['o'],
     description: 'Opens the url in default browser.',
   },
-    { name: 'live-reload', type: Boolean, default: true, aliases: ['lr'] },
+  {
+    name: 'live-reload',
+    type: Boolean,
+    default: true,
+    aliases: ['lr'],
+    description: 'Whether to reload the page on change, using live-reload.'
+  },
   {
     name: 'live-reload-client',
     type: String,
@@ -62,10 +94,13 @@ export const baseServeCommandOptions: any = overrideOptions(
     default: false,
     description: 'Enable hot module replacement.',
   }
-  ]), [
+], [
-    { name: 'watch', default: true }
+  {
-  ]
+    name: 'watch',
-);
+    default: true,
+    description: 'Rebuild on change.'
+  }
+]);
 
 const ServeCommand = Command.extend({
   name: 'serve',

packages/@angular/cli/commands/set.ts

@@ -1,4 +1,4 @@
-import {CliConfig} from '../models/config';
+\import {CliConfig} from '../models/config';
 
 const SilentError = require('silent-error');
 const Command = require('../ember-cli/lib/models/command');
@@ -15,7 +15,13 @@ const SetCommand = Command.extend({
   works: 'everywhere',
 
   availableOptions: [
-    { name: 'global', type: Boolean, 'default': false, aliases: ['g'] },
+    {
+      name: 'global',
+      type: Boolean,
+      'default': false,
+      aliases: ['g'],
+      description: 'Set the value in the global configuration rather than in your project\'s.'
+    },
   ],
 
   asBoolean: function (raw: string): boolean {

packages/@angular/cli/commands/xi18n.ts

@@ -15,7 +15,8 @@ const Xi18nCommand = Command.extend({
       name: 'i18n-format',
       type: String,
       default: 'xlf',
-      aliases: ['f', {'xmb': 'xmb'}, {'xlf': 'xlf'}, {'xliff': 'xlf'}]
+      aliases: ['f', {'xmb': 'xmb'}, {'xlf': 'xlf'}, {'xliff': 'xlf'}],
+      description: 'Output format for the generated file.'
     },
     {
       name: 'output-path',