documented component

tools/testing/dart/test_options.dart

Index: tools/testing/dart/test_options.dart
diff --git a/tools/testing/dart/test_options.dart b/tools/testing/dart/test_options.dart
index f4e99989966c4c61f7be61d8952553a6682fc80a..000eda8f71a7d8ab6e5dadf3e53b8a070e1b9906 100644
--- a/tools/testing/dart/test_options.dart
+++ b/tools/testing/dart/test_options.dart
@@ -61,7 +61,39 @@ is 'dart file.dart' and you specify special command
               'debug'),
           new _TestOptionSpecification(
               'component',
-              'The component to test against',
+              '''

[Siggi Cherem (dart-lang), 2012/03/05 18:28:33]

Let's keep the old header too, it still helps to define what 'component' means.

[mattsh, 2012/03/05 18:41:43]

OK, added summary description of this flag now.

+
+   vm: Run dart code on the standalone dart vm.
+
+   frog: Compile dart code by running frog on the standalone dart vm, and
+       run the resulting javascript on D8.
+
+   leg: Compile dart code by running leg on the standalone dart vm, and
+       run the resulting javascript on D8.
+
+   frogsh: Compile dart code by running frog on node.js, and run the
+       resulting javascript on the same instance of node.js.
+
+   dartium: Run dart code in a type="application/dart" script tag in a
+       dartium build of DumpRenderTree.
+
+   chromium: Obsolete, not used, will be removed.
+
+   frogium: Compile dart code by running frog on the standalone dart vm,
+       and run the resulting javascript in a javascript script tag in
+       a dartium build of DumpRenderTree.
+
+   legium: Compile dart code by running leg on the standalone dart vm,
+       and run the resulting javascript in a javascript script tag in
+       a dartium build of DumpRenderTree.
+
+   webdriver: Compile dart code by running frog on the standalone dart vm,
+       and then run the resulting javascript in the browser that is specified
+       by the --browser switch (e.g. chrome, safari, ff, etc.).
+
+   dartc: Run dart code through the dartc static analyzer (does not
+       execute dart code).
+''',
               ['-c', '--component'],
               ['most', 'vm', 'dartc', 'frog', 'frogsh', 'leg',
                'dartium', 'chromium', 'frogium', 'legium', 'webdriver'],