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

third_party/WebKit/Source/core/html/track/TextTrack.cpp

 /*
  * Copyright (C) 2011 Google Inc.  All rights reserved.
  * Copyright (C) 2011, 2012, 2013 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:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
@@ skipping 117 matching lines @@
 }
 
 bool TextTrack::isVisualKind() const {
   return kind() == subtitlesKeyword() || kind() == captionsKeyword();
 }
 
 void TextTrack::setMode(const AtomicString& mode) {
   DCHECK(mode == disabledKeyword() || mode == hiddenKeyword() ||
          mode == showingKeyword());
 
-  // On setting, if the new value isn't equal to what the attribute would currently
-  // return, the new value must be processed as follows ...
+  // On setting, if the new value isn't equal to what the attribute would
+  // currently return, the new value must be processed as follows ...
   if (m_mode == mode)
     return;
 
   if (m_cues && cueTimeline()) {
     // If mode changes to disabled, remove this track's cues from the client
     // because they will no longer be accessible from the cues() function.
     if (mode == disabledKeyword())
       cueTimeline()->removeCues(this, m_cues.get());
     else if (mode != showingKeyword())
       cueTimeline()->hideCues(this, m_cues.get());
@@ skipping 41 matching lines @@
     newCue->setTrack(this);
     cues->add(newCue);
   }
 
   if (cueTimeline() && mode() != disabledKeyword())
     cueTimeline()->addCues(this, cues);
 }
 
 TextTrackCueList* TextTrack::activeCues() {
   // 4.8.10.12.5 If the text track mode ... is not the text track disabled mode,
-  // then the activeCues attribute must return a live TextTrackCueList object ...
+  // then the activeCues attribute must return a live TextTrackCueList object
   // ... whose active flag was set when the script started, in text track cue
-  // order. Otherwise, it must return null. When an object is returned, the
-  // same object must be returned each time.
+  // order. Otherwise, it must return null. When an object is returned, the same
+  // object must be returned each time.
   // http://www.whatwg.org/specs/web-apps/current-work/#dom-texttrack-activecues
   if (!m_cues || m_mode == disabledKeyword())
     return nullptr;
 
   if (!m_activeCues)
     m_activeCues = TextTrackCueList::create();
 
   m_cues->collectActiveCues(*m_activeCues);
   return m_activeCues;
 }
 
 void TextTrack::addCue(TextTrackCue* cue) {
   DCHECK(cue);
 
   // TODO(93143): Add spec-compliant behavior for negative time values.
   if (std::isnan(cue->startTime()) || std::isnan(cue->endTime()) ||
       cue->startTime() < 0 || cue->endTime() < 0)
     return;
 
   // https://html.spec.whatwg.org/multipage/embedded-content.html#dom-texttrack-addcue
 
-  // The addCue(cue) method of TextTrack objects, when invoked, must run the following steps:
+  // The addCue(cue) method of TextTrack objects, when invoked, must run the
+  // following steps:
 
-  // (Steps 1 and 2 - pertaining to association of rendering rules - are not implemented.)
+  // (Steps 1 and 2 - pertaining to association of rendering rules - are not
+  // implemented.)
 
   // 3. If the given cue is in a text track list of cues, then remove cue
   // from that text track list of cues.
   if (TextTrack* cueTrack = cue->track())
     cueTrack->removeCue(cue, ASSERT_NO_EXCEPTION);
 
-  // 4. Add cue to the method's TextTrack object's text track's text track list of cues.
+  // 4. Add cue to the method's TextTrack object's text track's text track list
+  // of cues.
   cue->setTrack(this);
   ensureTextTrackCueList()->add(cue);
 
   if (cueTimeline() && m_mode != disabledKeyword())
     cueTimeline()->addCue(this, cue);
 }
 
 void TextTrack::removeCue(TextTrackCue* cue, ExceptionState& exceptionState) {
   DCHECK(cue);
 
   // https://html.spec.whatwg.org/multipage/embedded-content.html#dom-texttrack-removecue
 
-  // The removeCue(cue) method of TextTrack objects, when invoked, must run the following steps:
+  // The removeCue(cue) method of TextTrack objects, when invoked, must run the
+  // following steps:
 
   // 1. If the given cue is not currently listed in the method's TextTrack
-  // object's text track's text track list of cues, then throw a NotFoundError exception.
+  // object's text track's text track list of cues, then throw a NotFoundError
+  // exception.
   if (cue->track() != this) {
     exceptionState.throwDOMException(
         NotFoundError,
         "The specified cue is not listed in the TextTrack's list of cues.");
     return;
   }
 
   // cue->track() == this implies that cue is in this track's list of cues,
   // so this track should have a list of cues and the cue being removed
   // should be in it.
   DCHECK(m_cues);
 
-  // 2. Remove cue from the method's TextTrack object's text track's text track list of cues.
+  // 2. Remove cue from the method's TextTrack object's text track's text track
+  // list of cues.
   bool wasRemoved = m_cues->remove(cue);
   DCHECK(wasRemoved);
 
   // If the cue is active, a timeline needs to be available.
   DCHECK(!cue->isActive() || cueTimeline());
 
   cue->setTrack(0);
 
   if (cueTimeline())
     cueTimeline()->removeCue(this, cue);
@@ skipping 64 matching lines @@
   if (!m_regions || !m_regions->remove(region)) {
     exceptionState.throwDOMException(InvalidStateError,
                                      "Failed to remove the specified region.");
     return;
   }
 
   region->setTrack(0);
 }
 
 void TextTrack::cueWillChange(TextTrackCue* cue) {
-  // The cue may need to be repositioned in the media element's interval tree, may need to
-  // be re-rendered, etc, so remove it before the modification...
+  // The cue may need to be repositioned in the media element's interval tree,
+  // may need to be re-rendered, etc, so remove it before the modification...
   if (cueTimeline())
     cueTimeline()->removeCue(this, cue);
 }
 
 void TextTrack::cueDidChange(TextTrackCue* cue) {
   // This method is called through cue->track(), which should imply that this
   // track has a list of cues.
   DCHECK(m_cues && cue->track() == this);
 
   // Make sure the TextTrackCueList order is up to date.
@@ skipping 25 matching lines @@
 void TextTrack::invalidateTrackIndex() {
   m_trackIndex = invalidTrackIndex;
   m_renderedTrackIndex = invalidTrackIndex;
 }
 
 bool TextTrack::isRendered() const {
   return m_mode == showingKeyword() && isVisualKind();
 }
 
 bool TextTrack::canBeRendered() const {
-  // A track can be displayed when it's of kind captions or subtitles and hasn't failed to load.
+  // A track can be displayed when it's of kind captions or subtitles and hasn't
+  // failed to load.
   return getReadinessState() != FailedToLoad && isVisualKind();
 }
 
 TextTrackCueList* TextTrack::ensureTextTrackCueList() {
   if (!m_cues)
     m_cues = TextTrackCueList::create();
 
   return m_cues.get();
 }
 
@@ skipping 34 matching lines @@
   visitor->trace(m_regions);
   visitor->trace(m_trackList);
   TrackBase::trace(visitor);
   EventTargetWithInlineData::trace(visitor);
 }
 
 DEFINE_TRACE_WRAPPERS(TextTrack) {
   visitor->traceWrappers(m_cues);
 }
 }  // namespace blink