[html5lib] triple slash comment style

pkg/third_party/html5lib/lib/src/char_encodings.dart

-/** Decodes bytes using the correct name. See [decodeBytes]. */
+/// Decodes bytes using the correct name. See [decodeBytes].
 library char_encodings;
 
 import 'dart:collection';
 import 'package:utf/utf.dart';
 
 // TODO(jmesserly): this function is conspicuously absent from dart:utf.
-/**
- * Returns true if the [bytes] starts with a UTF-8 byte order mark.
- * Since UTF-8 doesn't have byte order, it's somewhat of a misnomer, but it is
- * used in HTML to detect the UTF-
- */
+/// Returns true if the [bytes] starts with a UTF-8 byte order mark.
+/// Since UTF-8 doesn't have byte order, it's somewhat of a misnomer, but it is
+/// used in HTML to detect the UTF-
 bool hasUtf8Bom(List<int> bytes, [int offset = 0, int length]) {
   int end = length != null ? offset + length : bytes.length;
   return (offset + 3) <= end &&
       bytes[offset] == 0xEF &&
       bytes[offset + 1] == 0xBB &&
       bytes[offset + 2] == 0xBF;
 }
 
 // TODO(jmesserly): it's unfortunate that this has to be one-shot on the entire
 // file, but dart:utf does not expose stream-based decoders yet.
-/**
- * Decodes the [bytes] with the provided [encoding] and returns an iterable for
- * the codepoints. Supports the major unicode encodings as well as ascii and
- * and windows-1252 encodings.
- */
+/// Decodes the [bytes] with the provided [encoding] and returns an iterable for
+/// the codepoints. Supports the major unicode encodings as well as ascii and
+/// and windows-1252 encodings.
 Iterable<int> decodeBytes(String encoding, List<int> bytes,
     [int offset = 0, int length,
     int replacementCodepoint = UNICODE_REPLACEMENT_CHARACTER_CODEPOINT]) {
   if (length == null) length = bytes.length;
   final replace = replacementCodepoint;
   switch (encoding) {
     case 'ascii':
       bytes = bytes.sublist(offset, offset + length);
       // TODO(jmesserly): this was taken from runtime/bin/string_stream.dart
       for (int byte in bytes) {
@@ skipping 33 matching lines @@
     case 'utf-32-le':
       return decodeUtf32leAsIterable(bytes, offset, length, true, replace);
 
     default:
       throw new ArgumentError('Encoding $encoding not supported');
   }
 }
 
 
 // TODO(jmesserly): use dart:utf once http://dartbug.com/6476 is fixed.
-/**
- * Returns the code points for the [input]. This works like [String.charCodes]
- * but it decodes UTF-16 surrogate pairs.
- */
+/// Returns the code points for the [input]. This works like [String.charCodes]
+/// but it decodes UTF-16 surrogate pairs.
 List<int> toCodepoints(String input) {
   var newCodes = <int>[];
   for (int i = 0; i < input.length; i++) {
     var c = input.codeUnitAt(i);
     if (0xD800 <= c && c <= 0xDBFF) {
       int next = i + 1;
       if (next < input.length) {
         var d = input.codeUnitAt(next);
         if (0xDC00 <= d && d <= 0xDFFF) {
           c = 0x10000 + ((c - 0xD800) << 10) + (d - 0xDC00);
           i = next;
         }
       }
     }
     newCodes.add(c);
   }
   return newCodes;
 }
 
 
-/**
- * Decodes [windows-1252](http://en.wikipedia.org/wiki/Windows-1252) bytes as an
- * iterable. Thus, the consumer can only convert as much of the input as needed.
- * Set the [replacementCharacter] to null to throw an [ArgumentError]
- * rather than replace the bad value.
- */
+/// Decodes [windows-1252](http://en.wikipedia.org/wiki/Windows-1252) bytes as
+/// an iterable. Thus, the consumer can only convert as much of the input as
+/// needed. Set the [replacementCharacter] to null to throw an [ArgumentError]
+/// rather than replace the bad value.
 IterableWindows1252Decoder decodeWindows1252AsIterable(List<int> bytes,
     [int offset = 0, int length,
     int replacementCodepoint = UNICODE_REPLACEMENT_CHARACTER_CODEPOINT]) {
   return new IterableWindows1252Decoder(bytes, offset, length,
       replacementCodepoint);
 }
 
 
-/**
- * Return type of [decodeWindows1252AsIterable] and variants. The Iterable type
- * provides an iterator on demand and the iterator will only translate bytes
- * as requested by the user of the iterator. (Note: results are not cached.)
- */
+/// Return type of [decodeWindows1252AsIterable] and variants. The Iterable type
+/// provides an iterator on demand and the iterator will only translate bytes
+/// as requested by the user of the iterator. (Note: results are not cached.)
 class IterableWindows1252Decoder extends IterableBase<int> {
   final List<int> bytes;
   final int offset;
   final int length;
   final int replacementCodepoint;
 
   IterableWindows1252Decoder(List<int> this.bytes, [int this.offset = 0,
       int this.length = null,
       int this.replacementCodepoint = UNICODE_REPLACEMENT_CHARACTER_CODEPOINT]);
 
   Windows1252Decoder get iterator =>
       new Windows1252Decoder(bytes, offset, length, replacementCodepoint);
 }
 
 
-/**
- * Provides an iterator of Unicode codepoints from windows-1252 encoded bytes.
- * The parameters can set an offset into a list of bytes (as int), limit the
- * length of the values to be decoded, and override the default Unicode
- * replacement character. Set the replacementCharacter to null to throw an
- * ArgumentError rather than replace the bad value. The return value
- * from this method can be used as an Iterable (e.g. in a for-loop).
- */
+/// Provides an iterator of Unicode codepoints from windows-1252 encoded bytes.
+/// The parameters can set an offset into a list of bytes (as int), limit the
+/// length of the values to be decoded, and override the default Unicode
+/// replacement character. Set the replacementCharacter to null to throw an
+/// ArgumentError rather than replace the bad value. The return value
+/// from this method can be used as an Iterable (e.g. in a for-loop).
 class Windows1252Decoder implements Iterator<int> {
   final int replacementCodepoint;
   final List<int> _bytes;
   int _offset;
   final int _length;
 
   Windows1252Decoder(List<int> bytes, [int offset = 0, int length,
       this.replacementCodepoint = UNICODE_REPLACEMENT_CHARACTER_CODEPOINT])
       : _bytes = bytes,
         _offset = offset - 1,
@@ skipping 46 matching lines @@
       case 0x9D:
         if (replacementCodepoint == null) {
           throw new ArgumentError(
               "Invalid windows-1252 code point $char at $_offset");
         }
         return replacementCodepoint;
     }
     return char;
   }
 }