reflow comments in core/imagebitmap,core/html/track

third_party/WebKit/Source/core/html/track/vtt/VTTParser.cpp

 /*
  * Copyright (C) 2011 Google Inc.  All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 125 matching lines @@
         collectMetadataHeader(line);
 
         if (line.isEmpty()) {
           if (m_client && m_regionList.size())
             m_client->newRegionsParsed();
 
           m_state = Id;
           break;
         }
 
-        // Step 15 - Break out of header loop if the line could be a timestamp line.
+        // Step 15 - Break out of header loop if the line could be a timestamp
+        // line.
         if (line.contains("-->"))
           m_state = recoverCue(line);
 
         // Step 16 - Line is not the empty string and does not contain "-->".
         break;
 
       case Id:
-        // Steps 17 - 20 - Allow any number of line terminators, then initialize new cue values.
+        // Steps 17 - 20 - Allow any number of line terminators, then initialize
+        // new cue values.
         if (line.isEmpty())
           break;
 
         // Step 21 - Cue creation (start a new cue).
         resetCueValues();
 
-        // Steps 22 - 25 - Check if this line contains an optional identifier or timing data.
+        // Steps 22 - 25 - Check if this line contains an optional identifier or
+        // timing data.
         m_state = collectCueId(line);
         break;
 
       case TimingsAndSettings:
         // Steps 26 - 27 - Discard current cue if the line is empty.
         if (line.isEmpty()) {
           m_state = Id;
           break;
         }
 
         // Steps 28 - 29 - Collect cue timings and settings.
         m_state = collectTimingsAndSettings(line);
         break;
 
       case CueText:
-        // Steps 31 - 41 - Collect the cue text, create a cue, and add it to the output.
+        // Steps 31 - 41 - Collect the cue text, create a cue, and add it to the
+        // output.
         m_state = collectCueText(line);
         break;
 
       case BadCue:
-        // Steps 42 - 48 - Discard lines until an empty line or a potential timing line is seen.
+        // Steps 42 - 48 - Discard lines until an empty line or a potential
+        // timing line is seen.
         m_state = ignoreBadCue(line);
         break;
     }
   }
 }
 
 void VTTParser::flushPendingCue() {
   DCHECK(m_lineReader.isAtEndOfStream());
-  // If we're in the CueText state when we run out of data, we emit the pending cue.
+  // If we're in the CueText state when we run out of data, we emit the pending
+  // cue.
   if (m_state == CueText)
     createNewCue();
 }
 
 bool VTTParser::hasRequiredFileIdentifier(const String& line) {
   // WebVTT parser algorithm step 6:
   // If input is more than six characters long but the first six characters
   // do not exactly equal "WEBVTT", or the seventh character is not a U+0020
   // SPACE character, a U+0009 CHARACTER TABULATION (tab) character, or a
   // U+000A LINE FEED (LF) character, then abort these steps.
@@ skipping 11 matching lines @@
 }
 
 void VTTParser::collectMetadataHeader(const String& line) {
   // WebVTT header parsing (WebVTT parser algorithm step 12)
   DEFINE_STATIC_LOCAL(const AtomicString, regionHeaderName, ("Region"));
 
   // The only currently supported header is the "Region" header.
   if (!RuntimeEnabledFeatures::webVTTRegionsEnabled())
     return;
 
-  // Step 12.4 If line contains the character ":" (A U+003A COLON), then set metadata's
-  // name to the substring of line before the first ":" character and
+  // Step 12.4 If line contains the character ":" (A U+003A COLON), then set
+  // metadata's name to the substring of line before the first ":" character and
   // metadata's value to the substring after this character.
   size_t colonPosition = line.find(':');
   if (colonPosition == kNotFound)
     return;
 
   String headerName = line.substring(0, colonPosition);
 
   // Steps 12.5 If metadata's name equals "Region":
   if (headerName == regionHeaderName) {
     String headerValue = line.substring(colonPosition + 1);
-    // Steps 12.5.1 - 12.5.11 Region creation: Let region be a new text track region [...]
+    // Steps 12.5.1 - 12.5.11 Region creation: Let region be a new text track
+    // region [...]
     createNewRegion(headerValue);
   }
 }
 
 VTTParser::ParseState VTTParser::collectCueId(const String& line) {
   if (line.contains("-->"))
     return collectTimingsAndSettings(line);
   m_currentId = AtomicString(line);
   return TimingsAndSettings;
 }
 
 VTTParser::ParseState VTTParser::collectTimingsAndSettings(const String& line) {
   VTTScanner input(line);
 
-  // Collect WebVTT cue timings and settings. (5.3 WebVTT cue timings and settings parsing.)
-  // Steps 1 - 3 - Let input be the string being parsed and position be a pointer into input.
+  // Collect WebVTT cue timings and settings. (5.3 WebVTT cue timings and
+  // settings parsing.)
+  // Steps 1 - 3 - Let input be the string being parsed and position be a
+  // pointer into input.
   input.skipWhile<isASpace>();
 
-  // Steps 4 - 5 - Collect a WebVTT timestamp. If that fails, then abort and return failure. Otherwise, let cue's text track cue start time be the collected time.
+  // Steps 4 - 5 - Collect a WebVTT timestamp. If that fails, then abort and
+  // return failure. Otherwise, let cue's text track cue start time be the
+  // collected time.
   if (!collectTimeStamp(input, m_currentStartTime))
     return BadCue;
   input.skipWhile<isASpace>();
 
-  // Steps 6 - 9 - If the next three characters are not "-->", abort and return failure.
+  // Steps 6 - 9 - If the next three characters are not "-->", abort and return
+  // failure.
   if (!input.scan("-->"))
     return BadCue;
   input.skipWhile<isASpace>();
 
-  // Steps 10 - 11 - Collect a WebVTT timestamp. If that fails, then abort and return failure. Otherwise, let cue's text track cue end time be the collected time.
+  // Steps 10 - 11 - Collect a WebVTT timestamp. If that fails, then abort and
+  // return failure. Otherwise, let cue's text track cue end time be the
+  // collected time.
   if (!collectTimeStamp(input, m_currentEndTime))
     return BadCue;
   input.skipWhile<isASpace>();
 
-  // Step 12 - Parse the WebVTT settings for the cue (conducted in TextTrackCue).
+  // Step 12 - Parse the WebVTT settings for the cue (conducted in
+  // TextTrackCue).
   m_currentSettings = input.restOfInputAsString();
   return CueText;
 }
 
 VTTParser::ParseState VTTParser::collectCueText(const String& line) {
   // Step 34.
   if (line.isEmpty()) {
     createNewCue();
     return Id;
   }
@@ skipping 130 matching lines @@
 
   // Steps 5 - 7 - Collect a sequence of characters that are 0-9.
   // If not 2 characters or value is greater than 59, interpret as hours.
   int value1;
   unsigned value1Digits = input.scanDigits(value1);
   if (!value1Digits)
     return false;
   if (value1Digits != 2 || value1 > 59)
     mode = Hours;
 
-  // Steps 8 - 11 - Collect the next sequence of 0-9 after ':' (must be 2 chars).
+  // Steps 8 - 11 - Collect the next sequence of 0-9 after ':' (must be 2
+  // chars).
   int value2;
   if (!input.scan(':') || input.scanDigits(value2) != 2)
     return false;
 
   // Step 12 - Detect whether this timestamp includes hours.
   int value3;
   if (mode == Hours || input.match(':')) {
     if (!input.scan(':') || input.scanDigits(value3) != 2)
       return false;
   } else {
@@ skipping 127 matching lines @@
 }
 
 DEFINE_TRACE(VTTParser) {
   visitor->trace(m_document);
   visitor->trace(m_client);
   visitor->trace(m_cueList);
   visitor->trace(m_regionList);
 }
 
 }  // namespace blink