Reformat comments in core/html/parser

third_party/WebKit/Source/core/html/parser/HTMLTreeBuilder.cpp

 /*
  * Copyright (C) 2010 Google, Inc. All Rights Reserved.
  * Copyright (C) 2011, 2014 Apple 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:
  * 1. Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  * 2. Redistributions in binary form must reproduce the above copyright
@@ skipping 232 matching lines @@
                       fragment->document(),
                       parserContentPolicy,
                       options) {
   ASSERT(isMainThread());
   ASSERT(contextElement);
   m_tree.initFragmentParsing(fragment, contextElement);
   m_fragmentContext.init(fragment, contextElement);
 
   // Steps 4.2-4.6 of the HTML5 Fragment Case parsing algorithm:
   // http://www.whatwg.org/specs/web-apps/current-work/multipage/the-end.html#fragment-case
-  // For efficiency, we skip step 4.2 ("Let root be a new html element with no attributes")
-  // and instead use the DocumentFragment as a root node.
+  // For efficiency, we skip step 4.2 ("Let root be a new html element with no
+  // attributes") and instead use the DocumentFragment as a root node.
   m_tree.openElements()->pushRootNode(HTMLStackItem::create(
       fragment, HTMLStackItem::ItemForDocumentFragmentNode));
 
   if (isHTMLTemplateElement(*contextElement))
     m_templateInsertionModes.append(TemplateContentsMode);
 
   resetInsertionModeAppropriately();
 }
 
 HTMLTreeBuilder::~HTMLTreeBuilder() {}
@@ skipping 14 matching lines @@
 
 DEFINE_TRACE(HTMLTreeBuilder) {
   visitor->trace(m_fragmentContext);
   visitor->trace(m_tree);
   visitor->trace(m_parser);
   visitor->trace(m_scriptToProcess);
 }
 
 void HTMLTreeBuilder::detach() {
 #if ENABLE(ASSERT)
-  // This call makes little sense in fragment mode, but for
-  // consistency DocumentParser expects detach() to always be called
-  // before it's destroyed.
+  // This call makes little sense in fragment mode, but for consistency
+  // DocumentParser expects detach() to always be called before it's destroyed.
   m_isAttached = false;
 #endif
   // HTMLConstructionSite might be on the callstack when detach() is called
   // otherwise we'd just call m_tree.clear() here instead.
   m_tree.detach();
 }
 
 Element* HTMLTreeBuilder::takeScriptToProcess(
     TextPosition& scriptStartPosition) {
   ASSERT(m_scriptToProcess);
@@ skipping 31 matching lines @@
   m_tree.executeQueuedTasks();
   // We might be detached now.
 }
 
 void HTMLTreeBuilder::processToken(AtomicHTMLToken* token) {
   if (token->type() == HTMLToken::Character) {
     processCharacter(token);
     return;
   }
 
-  // Any non-character token needs to cause us to flush any pending text immediately.
-  // NOTE: flush() can cause any queued tasks to execute, possibly re-entering the parser.
+  // Any non-character token needs to cause us to flush any pending text
+  // immediately. NOTE: flush() can cause any queued tasks to execute, possibly
+  // re-entering the parser.
   m_tree.flush(FlushAlways);
   m_shouldSkipLeadingNewline = false;
 
   switch (token->type()) {
     case HTMLToken::Uninitialized:
     case HTMLToken::Character:
       ASSERT_NOT_REACHED();
       break;
     case HTMLToken::DOCTYPE:
       processDoctypeToken(token);
@@ skipping 23 matching lines @@
   if (m_insertionMode == InTableTextMode) {
     defaultForInTableText();
     processDoctypeToken(token);
     return;
   }
   parseError(token);
 }
 
 void HTMLTreeBuilder::processFakeStartTag(const QualifiedName& tagName,
                                           const Vector<Attribute>& attributes) {
-  // FIXME: We'll need a fancier conversion than just "localName" for SVG/MathML tags.
+  // FIXME: We'll need a fancier conversion than just "localName" for SVG/MathML
+  // tags.
   AtomicHTMLToken fakeToken(HTMLToken::StartTag, tagName.localName(),
                             attributes);
   processStartTag(&fakeToken);
 }
 
 void HTMLTreeBuilder::processFakeEndTag(const AtomicString& tagName) {
   AtomicHTMLToken fakeToken(HTMLToken::EndTag, tagName);
   processEndTag(&fakeToken);
 }
 
 void HTMLTreeBuilder::processFakeEndTag(const QualifiedName& tagName) {
-  // FIXME: We'll need a fancier conversion than just "localName" for SVG/MathML tags.
+  // FIXME: We'll need a fancier conversion than just "localName" for SVG/MathML
+  // tags.
   processFakeEndTag(tagName.localName());
 }
 
 void HTMLTreeBuilder::processFakePEndTagIfPInButtonScope() {
   if (!m_tree.openElements()->inButtonScope(pTag.localName()))
     return;
   AtomicHTMLToken endP(HTMLToken::EndTag, pTag.localName());
   processEndTag(&endP);
 }
 
@@ skipping 689 matching lines @@
       }
       if (!processColgroupEndTagForInColumnGroup()) {
         ASSERT(isParsingFragmentOrTemplateContents());
         return;
       }
       processStartTag(token);
       break;
     case InTableBodyMode:
       ASSERT(getInsertionMode() == InTableBodyMode);
       if (token->name() == trTag) {
-        m_tree.openElements()
-            ->popUntilTableBodyScopeMarker();  // How is there ever anything to pop?
+        // How is there ever anything to pop?
+        m_tree.openElements()->popUntilTableBodyScopeMarker();
         m_tree.insertHTMLElement(token);
         setInsertionMode(InRowMode);
         return;
       }
       if (isTableCellContextTag(token->name())) {
         parseError(token);
         processFakeStartTag(trTag);
         ASSERT(getInsertionMode() == InRowMode);
         processStartTag(token);
         return;
@@ skipping 245 matching lines @@
   m_tree.insertHTMLHtmlStartTagInBody(token);
 }
 
 bool HTMLTreeBuilder::processBodyEndTagForInBody(AtomicHTMLToken* token) {
   ASSERT(token->type() == HTMLToken::EndTag);
   ASSERT(token->name() == bodyTag);
   if (!m_tree.openElements()->inScope(bodyTag.localName())) {
     parseError(token);
     return false;
   }
-  DVLOG(1)
-      << "Not implmeneted.";  // Emit a more specific parse error based on stack contents.
+  // Emit a more specific parse error based on stack contents.
+  DVLOG(1) << "Not implmeneted.";
   setInsertionMode(AfterBodyMode);
   return true;
 }
 
 void HTMLTreeBuilder::processAnyOtherEndTagForInBody(AtomicHTMLToken* token) {
   ASSERT(token->type() == HTMLToken::EndTag);
   if (token->name() == menuitemTag)
     UseCounter::count(m_tree.currentNode()->document(),
                       UseCounter::MenuItemCloseTag);
   HTMLElementStack::ElementRecord* record = m_tree.openElements()->topRecord();
@@ skipping 29 matching lines @@
     Element* formattingElement =
         m_tree.activeFormattingElements()->closestElementInScopeWithName(
             token->name());
     // 4.a
     if (!formattingElement)
       return processAnyOtherEndTagForInBody(token);
     // 4.c
     if ((m_tree.openElements()->contains(formattingElement)) &&
         !m_tree.openElements()->inScope(formattingElement)) {
       parseError(token);
-      DVLOG(1)
-          << "Not implemented.";  // Check the stack of open elements for a more specific parse error.
+      // Check the stack of open elements for a more specific parse error.
+      DVLOG(1) << "Not implemented.";
       return;
     }
     // 4.b
     HTMLElementStack::ElementRecord* formattingElementRecord =
         m_tree.openElements()->find(formattingElement);
     if (!formattingElementRecord) {
       parseError(token);
       m_tree.activeFormattingElements()->remove(formattingElement);
       return;
     }
@@ skipping 19 matching lines @@
         m_tree.activeFormattingElements()->bookmarkFor(formattingElement);
     // 9.
     HTMLElementStack::ElementRecord* node = furthestBlock;
     HTMLElementStack::ElementRecord* nextNode = node->next();
     HTMLElementStack::ElementRecord* lastNode = furthestBlock;
     // 9.1, 9.2, 9.3 and 9.11 are covered by the for() loop.
     for (int i = 0; i < innerIterationLimit; ++i) {
       // 9.4
       node = nextNode;
       ASSERT(node);
-      nextNode =
-          node->next();  // Save node->next() for the next iteration in case node is deleted in 9.5.
+      // Save node->next() for the next iteration in case node is deleted in
+      // 9.5.
+      nextNode = node->next();
       // 9.5
       if (!m_tree.activeFormattingElements()->contains(node->element())) {
         m_tree.openElements()->remove(node->element());
         node = 0;
         continue;
       }
       // 9.6
       if (node == formattingElementRecord)
         break;
       // 9.7
@@ skipping 401 matching lines @@
       if (token->name() != headTag && token->name() != bodyTag &&
           token->name() != htmlTag && token->name() != brTag) {
         parseError(token);
         return;
       }
       defaultForBeforeHead();
     // Fall through.
     case InHeadMode:
       ASSERT(getInsertionMode() == InHeadMode);
       // FIXME: This case should be broken out into processEndTagForInHead,
-      // because other end tag cases now refer to it ("process the token for using the rules of the "in head" insertion mode").
-      // but because the logic falls through to AfterHeadMode, that gets a little messy.
+      // because other end tag cases now refer to it ("process the token for
+      // using the rules of the "in head" insertion mode"). but because the
+      // logic falls through to AfterHeadMode, that gets a little messy.
       if (token->name() == templateTag) {
         processTemplateEndTag(token);
         return;
       }
       if (token->name() == headTag) {
         m_tree.openElements()->popHTMLHeadElement();
         setInsertionMode(AfterHeadMode);
         return;
       }
       if (token->name() != bodyTag && token->name() != htmlTag &&
@@ skipping 106 matching lines @@
       if (token->name() != brTag) {
         parseError(token);
         return;
       }
       defaultForInHeadNoscript();
       processToken(token);
       break;
     case TextMode:
       if (token->name() == scriptTag &&
           m_tree.currentStackItem()->hasTagName(scriptTag)) {
-        // Pause ourselves so that parsing stops until the script can be processed by the caller.
+        // Pause ourselves so that parsing stops until the script can be
+        // processed by the caller.
         if (scriptingContentIsAllowed(m_tree.getParserContentPolicy()))
           m_scriptToProcess = m_tree.currentElement();
         m_tree.openElements()->pop();
         setInsertionMode(m_originalInsertionMode);
 
         if (m_parser->tokenizer()) {
-          // We must set the tokenizer's state to
-          // DataState explicitly if the tokenizer didn't have a chance to.
+          // We must set the tokenizer's state to DataState explicitly if the
+          // tokenizer didn't have a chance to.
           m_parser->tokenizer()->setState(HTMLTokenizer::DataState);
         }
         return;
       }
       m_tree.openElements()->pop();
       setInsertionMode(m_originalInsertionMode);
       break;
     case InFramesetMode:
       ASSERT(getInsertionMode() == InFramesetMode);
       if (token->name() == framesetTag) {
@@ skipping 332 matching lines @@
     // Fall through
     case InBodyMode:
     case InCellMode:
     case InCaptionMode:
     case InRowMode:
       ASSERT(getInsertionMode() == InBodyMode ||
              getInsertionMode() == InCellMode ||
              getInsertionMode() == InCaptionMode ||
              getInsertionMode() == InRowMode ||
              getInsertionMode() == TemplateContentsMode);
-      DVLOG(1)
-          << "Not implemented.";  // Emit parse error based on what elements are still open.
+      // Emit parse error based on what elements are still open.
+      DVLOG(1) << "Not implemented.";
       if (!m_templateInsertionModes.isEmpty() &&
           processEndOfFileForInTemplateContents(token))
         return;
       break;
     case AfterBodyMode:
     case AfterAfterBodyMode:
       ASSERT(getInsertionMode() == AfterBodyMode ||
              getInsertionMode() == AfterAfterBodyMode);
       break;
     case InHeadNoscriptMode:
@@ skipping 31 matching lines @@
       if (!m_templateInsertionModes.isEmpty() &&
           processEndOfFileForInTemplateContents(token))
         return;
       break;
     case InTableTextMode:
       defaultForInTableText();
       processEndOfFile(token);
       return;
     case TextMode:
       parseError(token);
-      if (m_tree.currentStackItem()->hasTagName(scriptTag))
-        DVLOG(1)
-            << "Not implemented.";  // mark the script element as "already started".
+      if (m_tree.currentStackItem()->hasTagName(scriptTag)) {
+        // Mark the script element as "already started".
+        DVLOG(1) << "Not implemented.";
+      }
       m_tree.openElements()->pop();
       ASSERT(m_originalInsertionMode != TextMode);
       setInsertionMode(m_originalInsertionMode);
       processEndOfFile(token);
       return;
     case TemplateContentsMode:
       if (processEndOfFileForInTemplateContents(token))
         return;
       break;
   }
@@ skipping 53 matching lines @@
 bool HTMLTreeBuilder::processStartTagForInHead(AtomicHTMLToken* token) {
   ASSERT(token->type() == HTMLToken::StartTag);
   if (token->name() == htmlTag) {
     processHtmlStartTagForInBody(token);
     return true;
   }
   if (token->name() == baseTag || token->name() == basefontTag ||
       token->name() == bgsoundTag || token->name() == commandTag ||
       token->name() == linkTag || token->name() == metaTag) {
     m_tree.insertSelfClosingHTMLElementDestroyingToken(token);
-    // Note: The custom processing for the <meta> tag is done in HTMLMetaElement::process().
+    // Note: The custom processing for the <meta> tag is done in
+    // HTMLMetaElement::process().
     return true;
   }
   if (token->name() == titleTag) {
     processGenericRCDATAStartTag(token);
     return true;
   }
   if (token->name() == noscriptTag) {
     if (m_options.scriptEnabled) {
       processGenericRawTextStartTag(token);
       return true;
@@ skipping 149 matching lines @@
         adjustSVGTagNameCase(token);
 
       if (token->name() == SVGNames::scriptTag &&
           m_tree.currentStackItem()->hasTagName(SVGNames::scriptTag)) {
         if (scriptingContentIsAllowed(m_tree.getParserContentPolicy()))
           m_scriptToProcess = m_tree.currentElement();
         m_tree.openElements()->pop();
         return;
       }
       if (!m_tree.currentStackItem()->isInHTMLNamespace()) {
-        // FIXME: This code just wants an Element* iterator, instead of an ElementRecord*
+        // FIXME: This code just wants an Element* iterator, instead of an
+        // ElementRecord*
         HTMLElementStack::ElementRecord* nodeRecord =
             m_tree.openElements()->topRecord();
         if (!nodeRecord->stackItem()->hasLocalName(token->name()))
           parseError(token);
         while (1) {
           if (nodeRecord->stackItem()->hasLocalName(token->name())) {
             m_tree.openElements()->popUntilPopped(nodeRecord->element());
             return;
           }
           nodeRecord = nodeRecord->next();
 
           if (nodeRecord->stackItem()->isInHTMLNamespace())
             break;
         }
       }
-      // Otherwise, process the token according to the rules given in the section corresponding to the current insertion mode in HTML content.
+      // Otherwise, process the token according to the rules given in the
+      // section corresponding to the current insertion mode in HTML content.
       processEndTag(token);
       break;
     }
     case HTMLToken::Comment:
       m_tree.insertComment(token);
       break;
     case HTMLToken::Character:
     case HTMLToken::EndOfFile:
       ASSERT_NOT_REACHED();
       break;
@@ skipping 41 matching lines @@
     DEFINE_STRINGIFY(AfterFramesetMode)
     DEFINE_STRINGIFY(AfterAfterBodyMode)
     DEFINE_STRINGIFY(AfterAfterFramesetMode)
 #undef DEFINE_STRINGIFY
   }
   return "<unknown>";
 }
 #endif
 
 }  // namespace blink