Dart2js option to dump info about compilation

sdk/lib/_internal/compiler/implementation/dart2js.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 library dart2js.cmdline;
 
 import 'dart:async'
     show Future, EventSink;
 import 'dart:io'
     show exit, File, FileMode, Platform, RandomAccessFile;
@@ skipping 264 matching lines @@
     new OptionHandler(r'--help|/\?|/h', (_) => wantHelp = true),
     new OptionHandler('--package-root=.+|-p.+', setPackageRoot),
     new OptionHandler('--analyze-all', passThrough),
     new OptionHandler('--analyze-only', setAnalyzeOnly),
     new OptionHandler('--analyze-signatures-only', passThrough),
     new OptionHandler('--disable-native-live-type-analysis', passThrough),
     new OptionHandler('--categories=.*', setCategories),
     new OptionHandler('--global-js-name=.*', checkGlobalName),
     new OptionHandler('--disable-type-inference', passThrough),
     new OptionHandler('--terse', passThrough),
+    new OptionHandler('--dump-info', passThrough),
     new OptionHandler('--disallow-unsafe-eval',
                       (_) => hasDisallowUnsafeEval = true),
     new OptionHandler('-D.+=.*', addInEnvironment),
 
     // The following two options must come last.
     new OptionHandler('-.*', (String argument) {
       helpAndFail('Error: Unknown option "$argument".');
     }),
     new OptionHandler('.*', (String argument) {
       arguments.add(nativeToUriPath(argument));
@@ skipping 64 matching lines @@
         uri = out;
         sourceMapFileName =
             sourceMapOut.path.substring(sourceMapOut.path.lastIndexOf('/') + 1);
       } else if (extension == 'precompiled.js') {
         uri = computePrecompiledUri();
         diagnosticHandler.info(
             "File ($uri) is compatible with header"
             " \"Content-Security-Policy: script-src 'self'\"");
       } else if (extension == 'js.map' || extension == 'dart.map') {
         uri = sourceMapOut;
+      } else if (extension == 'info.html') {
+        String outName = out.path.substring(out.path.lastIndexOf('/') + 1);
+        uri = out.resolve('${outName}.$extension');
       } else {
         fail('Error: Unknown extension: $extension');
       }
     } else {
       uri = out.resolve('$name.$extension');
     }
 
     if (uri.scheme != 'file') {
       fail('Error: Unhandled scheme ${uri.scheme} in $uri.');
     }
@@ skipping 190 matching lines @@
     A comma separated list of allowed library categories.  The default
     is "Client".  Possible categories can be seen by providing an
     unsupported category, for example, --categories=help.  To enable
     all categories, use --categories=all.
 
   --global-js-name=<name>
     By default, dart2js generates JavaScript output that uses a global
     variable named "$".  The name of this global can be overridden
     with this option.  The name must match the regular expression "\$[a-z]*".
 
+  --dump-info
+    Given this option dart2js generates a out.info.html file with information

[ahe, 2013/11/27 18:01:31]

"Given this option dart2js ..." is redundant.

[sigurdm, 2013/11/29 10:39:37]

Done.

[sigurdm, 2013/11/29 10:39:37]

Done.

+    about the generated code.
+
 '''.trim());
 }
 
 void helpAndExit(bool wantHelp, bool wantVersion, bool verbose) {
   if (wantVersion) {
     var version = (BUILD_ID == null)
         ? '<non-SDK build>'
         : BUILD_ID;
     print('Dart-to-JavaScript compiler (dart2js) version: $version');
   }
@@ skipping 37 matching lines @@
     }
   }
 
   try {
     return compilerMain(arguments).catchError(onError);
   } catch (exception, trace) {
     onError(exception, trace);
     return new Future.value();
   }
 }