[polymer] switch comment style

pkg/polymer/lib/src/build/script_compactor.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.
 
-/** Transfomer that combines multiple dart script tags into a single one. */
+/// Transfomer that combines multiple dart script tags into a single one.
 library polymer.src.build.script_compactor;
 
 import 'dart:async';
 import 'dart:convert';
 
 import 'package:analyzer/src/generated/ast.dart';
 import 'package:analyzer/src/generated/error.dart';
 import 'package:analyzer/src/generated/parser.dart';
 import 'package:analyzer/src/generated/scanner.dart';
 import 'package:barback/barback.dart';
 import 'package:path/path.dart' as path;
 import 'package:source_maps/span.dart' show SourceFile;
 
 import 'code_extractor.dart'; // import just for documentation.
 import 'common.dart';
 
-/**
- * Combines Dart script tags into a single script tag, and creates a new Dart
- * file that calls the main function of each of the original script tags.
- *
- * This transformer assumes that all script tags point to external files. To
- * support script tags with inlined code, use this transformer after running
- * [InlineCodeExtractor] on an earlier phase.
- *
- * Internally, this transformer will convert each script tag into an import
- * statement to a library, and then uses `initPolymer` (see polymer.dart)  to
- * process `@initMethod` and `@CustomTag` annotations in those libraries.
- */
+/// Combines Dart script tags into a single script tag, and creates a new Dart
+/// file that calls the main function of each of the original script tags.
+///
+/// This transformer assumes that all script tags point to external files. To
+/// support script tags with inlined code, use this transformer after running
+/// [InlineCodeExtractor] on an earlier phase.
+///
+/// Internally, this transformer will convert each script tag into an import
+/// statement to a library, and then uses `initPolymer` (see polymer.dart)  to
+/// process `@initMethod` and `@CustomTag` annotations in those libraries.
 class ScriptCompactor extends Transformer with PolymerTransformer {
   final TransformOptions options;
 
   ScriptCompactor(this.options);
 
-  /** Only run on entry point .html files. */
+  /// Only run on entry point .html files.
   Future<bool> isPrimary(Asset input) =>
       new Future.value(options.isHtmlEntryPoint(input.id));
 
   Future apply(Transform transform) {
     var id = transform.primaryInput.id;
     var secondaryId = id.addExtension('.scriptUrls');
     var logger = transform.logger;
     return readPrimaryAsHtml(transform).then((document) {
       return transform.readInputAsString(secondaryId).then((libraryIds) {
         var libraries = (JSON.decode(libraryIds) as Iterable).map(
@@ skipping 66 matching lines @@
               ..writeln('}');
 
           transform.addOutput(new Asset.fromString(
                 bootstrapId, buffer.toString()));
           transform.addOutput(new Asset.fromString(id, document.outerHtml));
         });
       });
     });
   }
 
-  /**
-   * Computes the initializers of [dartLibrary]. That is, a closure that calls
-   * Polymer.register for each @CustomTag, and any public top-level methods
-   * labeled with @initMethod.
-   */
+  /// Computes the initializers of [dartLibrary]. That is, a closure that calls
+  /// Polymer.register for each @CustomTag, and any public top-level methods
+  /// labeled with @initMethod.
   Future<List<_Initializer>> _initializersOf(
       AssetId dartLibrary, Transform transform, TransformLogger logger) {
     var initializers = [];
     return transform.readInputAsString(dartLibrary).then((code) {
       var file = new SourceFile.text(_simpleUriForSource(dartLibrary), code);
       var unit = _parseCompilationUnit(code);
 
       return Future.forEach(unit.directives, (directive) {
         // Include anything from parts.
         if (directive is PartDirective) {
@@ skipping 23 matching lines @@
         }
         return initializers;
       });
     });
   }
 
   static String _simpleUriForSource(AssetId source) =>
       source.path.startsWith('lib/')
       ? 'package:${source.package}/${source.path.substring(4)}' : source.path;
 
-  /**
-   * Filter [exportedInitializers] according to [directive]'s show/hide
-   * combinators and add the result to [initializers].
-   */
+  /// Filter [exportedInitializers] according to [directive]'s show/hide
+  /// combinators and add the result to [initializers].
   // TODO(sigmund): call the analyzer's resolver instead?
   static _processExportDirective(ExportDirective directive,
       List<_Initializer> exportedInitializers,
       List<_Initializer> initializers) {
     for (var combinator in directive.combinators) {
       if (combinator is ShowCombinator) {
         var show = combinator.shownNames.map((n) => n.name).toSet();
         exportedInitializers.retainWhere((e) => show.contains(e.symbolName));
       } else if (combinator is HideCombinator) {
         var hide = combinator.hiddenNames.map((n) => n.name).toSet();
         exportedInitializers.removeWhere((e) => hide.contains(e.symbolName));
       }
     }
     initializers.addAll(exportedInitializers);
   }
 
-  /**
-   * Add an initializer to register [node] as a polymer element if it contains
-   * an appropriate [CustomTag] annotation.
-   */
+  /// Add an initializer to register [node] as a polymer element if it contains
+  /// an appropriate [CustomTag] annotation.
   static _processClassDeclaration(ClassDeclaration node,
       List<_Initializer> initializers, SourceFile file,
       TransformLogger logger) {
     for (var meta in node.metadata) {
       if (!_isCustomTagAnnotation(meta)) continue;
       var args = meta.arguments.arguments;
       if (args == null || args.length == 0) {
         logger.error('Missing argument in @CustomTag annotation',
             span: _getSpan(file, meta));
         continue;
       }
 
       var tagName = args[0].stringValue;
       var typeName = node.name.name;
       if (typeName.startsWith('_')) {
         logger.error('@CustomTag is no longer supported on private '
           'classes: $tagName', span: _getSpan(file, node.name));
         continue;
       }
       initializers.add(new _CustomTagInitializer(tagName, typeName));
     }
   }
 
-  /**  a method initializer for [function]. */
+  ///  a method initializer for [function].

[Siggi Cherem (dart-lang), 2014/02/25 23:32:45]

if you don't mind fixing - seems like a word was dropped here a while ago. add
"Add" ?

"Add a method ... "

[Jennifer Messerly, 2014/02/25 23:42:42]

good catch! done

   static _processFunctionDeclaration(FunctionDeclaration function,
       List<_Initializer> initializers, SourceFile file,
       TransformLogger logger) {
     var name = function.name.name;
     if (name.startsWith('_')) {
       logger.error('@initMethod is no longer supported on private '
         'functions: $name', span: _getSpan(file, function.name));
       return;
     }
     initializers.add(new _InitMethodInitializer(name));
   }
 }
 
-/** Parse [code] using analyzer. */
+/// Parse [code] using analyzer.
 CompilationUnit _parseCompilationUnit(String code) {
   var errorListener = new _ErrorCollector();
   var reader = new CharSequenceReader(code);
   var scanner = new Scanner(null, reader, errorListener);
   var token = scanner.tokenize();
   var parser = new Parser(null, errorListener);
   return parser.parseCompilationUnit(token);
 }
 
 class _ErrorCollector extends AnalysisErrorListener {
@@ skipping 30 matching lines @@
       "() => Polymer.register('$tagName', $prefix.$typeName)";
 }
 
 _getSpan(SourceFile file, ASTNode node) => file.span(node.offset, node.end);
 
 const MAIN_HEADER = """
 library app_bootstrap;
 
 import 'package:polymer/polymer.dart';
 """;