reflow comments in Source/bindings/core/v8

third_party/WebKit/Source/bindings/core/v8/V8GCController.cpp

 /*
  * Copyright (C) 2009 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 117 matching lines @@
 
     if (classId == WrapperTypeInfo::NodeClassId) {
       ASSERT(V8Node::hasInstance(wrapper, m_isolate));
       Node* node = V8Node::toImpl(wrapper);
       if (node->hasEventListeners()) {
         v8::Persistent<v8::Object>::Cast(*value).MarkActive();
         return;
       }
       // FIXME: Remove the special handling for SVG elements.
       // We currently can't collect SVG Elements from minor gc, as we have
-      // strong references from SVG property tear-offs keeping context SVG element alive.
+      // strong references from SVG property tear-offs keeping context SVG
+      // element alive.
       if (node->isSVGElement()) {
         v8::Persistent<v8::Object>::Cast(*value).MarkActive();
         return;
       }
     }
   }
 
  private:
   v8::Isolate* m_isolate;
 };
@@ skipping 242 matching lines @@
     blameContext->Leave();
 
   ThreadState* currentThreadState = ThreadState::current();
   if (currentThreadState && !currentThreadState->isGCForbidden()) {
     // v8::kGCCallbackFlagForced forces a Blink heap garbage collection
     // when a garbage collection was forced from V8. This is either used
     // for tests that force GCs from JavaScript to verify that objects die
     // when expected.
     if (flags & v8::kGCCallbackFlagForced) {
       // This single GC is not enough for two reasons:
-      //   (1) The GC is not precise because the GC scans on-stack pointers conservatively.
-      //   (2) One GC is not enough to break a chain of persistent handles. It's possible that
-      //       some heap allocated objects own objects that contain persistent handles
-      //       pointing to other heap allocated objects. To break the chain, we need multiple GCs.
+      //   (1) The GC is not precise because the GC scans on-stack pointers
+      //       conservatively.
+      //   (2) One GC is not enough to break a chain of persistent handles. It's
+      //       possible that some heap allocated objects own objects that
+      //       contain persistent handles pointing to other heap allocated
+      //       objects. To break the chain, we need multiple GCs.
       //
-      // Regarding (1), we force a precise GC at the end of the current event loop. So if you want
-      // to collect all garbage, you need to wait until the next event loop.
-      // Regarding (2), it would be OK in practice to trigger only one GC per gcEpilogue, because
-      // GCController.collectAll() forces multiple V8's GC.
+      // Regarding (1), we force a precise GC at the end of the current event
+      // loop. So if you want to collect all garbage, you need to wait until the
+      // next event loop.  Regarding (2), it would be OK in practice to trigger
+      // only one GC per gcEpilogue, because GCController.collectAll() forces
+      // multiple V8's GC.
       currentThreadState->collectGarbage(BlinkGC::HeapPointersOnStack,
                                          BlinkGC::GCWithSweep,
                                          BlinkGC::ForcedGC);
 
       // Forces a precise GC at the end of the current event loop.
       RELEASE_ASSERT(!currentThreadState->isInGC());
       currentThreadState->setGCState(ThreadState::FullGCScheduled);
     }
 
     // v8::kGCCallbackFlagCollectAllAvailableGarbage is used when V8 handles
@@ skipping 113 matching lines @@
   double startTime = WTF::currentTimeMS();
   v8::HandleScope scope(isolate);
   PendingActivityVisitor visitor(isolate, executionContext);
   toIsolate(executionContext)->VisitHandlesWithClassIds(&visitor);
   scanPendingActivityHistogram.count(
       static_cast<int>(WTF::currentTimeMS() - startTime));
   return visitor.pendingActivityFound();
 }
 
 }  // namespace blink