reflow comments in Source/bindings/core/v8

third_party/WebKit/Source/bindings/core/v8/ScriptState.h

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef ScriptState_h
 #define ScriptState_h
 
 #include "bindings/core/v8/ScopedPersistent.h"
 #include "bindings/core/v8/V8PerContextData.h"
 #include "core/CoreExport.h"
@@ skipping 14 matching lines @@
 // ScriptState is destroyed when v8::Context is garbage-collected and
 // all V8 proxy objects that have references to the ScriptState are destructed.
 class CORE_EXPORT ScriptState : public RefCounted<ScriptState> {
   WTF_MAKE_NONCOPYABLE(ScriptState);
 
  public:
   class Scope {
     STACK_ALLOCATED();
 
    public:
-    // You need to make sure that scriptState->context() is not empty before creating a Scope.
+    // You need to make sure that scriptState->context() is not empty before
+    // creating a Scope.
     explicit Scope(ScriptState* scriptState)
         : m_handleScope(scriptState->isolate()),
           m_context(scriptState->context()) {
       ASSERT(scriptState->contextIsValid());
       m_context->Enter();
     }
 
     ~Scope() { m_context->Exit(); }
 
    private:
@@ skipping 81 matching lines @@
   ScriptValue getFromExtrasExports(const char* name);
 
  protected:
   ScriptState(v8::Local<v8::Context>, PassRefPtr<DOMWrapperWorld>);
 
  private:
   v8::Isolate* m_isolate;
   // This persistent handle is weak.
   ScopedPersistent<v8::Context> m_context;
 
-  // This RefPtr doesn't cause a cycle because all persistent handles that DOMWrapperWorld holds are weak.
+  // This RefPtr doesn't cause a cycle because all persistent handles that
+  // DOMWrapperWorld holds are weak.
   RefPtr<DOMWrapperWorld> m_world;
 
   // This std::unique_ptr causes a cycle:
-  // V8PerContextData --(Persistent)--> v8::Context --(RefPtr)--> ScriptState --(std::unique_ptr)--> V8PerContextData
-  // So you must explicitly clear the std::unique_ptr by calling disposePerContextData()
-  // once you no longer need V8PerContextData. Otherwise, the v8::Context will leak.
+  // V8PerContextData --(Persistent)--> v8::Context --(RefPtr)--> ScriptState
+  //     --(std::unique_ptr)--> V8PerContextData
+  // So you must explicitly clear the std::unique_ptr by calling
+  // disposePerContextData() once you no longer need V8PerContextData.
+  // Otherwise, the v8::Context will leak.
   std::unique_ptr<V8PerContextData> m_perContextData;
 
 #if ENABLE(ASSERT)
   bool m_globalObjectDetached;
 #endif
 };
 
-// ScriptStateProtectingContext keeps the context associated with the ScriptState alive.
-// You need to call clear() once you no longer need the context. Otherwise, the context will leak.
+// ScriptStateProtectingContext keeps the context associated with the
+// ScriptState alive.  You need to call clear() once you no longer need the
+// context. Otherwise, the context will leak.
 class ScriptStateProtectingContext {
   WTF_MAKE_NONCOPYABLE(ScriptStateProtectingContext);
   USING_FAST_MALLOC(ScriptStateProtectingContext);
 
  public:
   ScriptStateProtectingContext(ScriptState* scriptState)
       : m_scriptState(scriptState) {
     if (m_scriptState)
       m_context.set(m_scriptState->isolate(), m_scriptState->context());
   }
 
   ScriptState* operator->() const { return m_scriptState.get(); }
   ScriptState* get() const { return m_scriptState.get(); }
   void clear() {
     m_scriptState = nullptr;
     m_context.clear();
   }
 
  private:
   RefPtr<ScriptState> m_scriptState;
   ScopedPersistent<v8::Context> m_context;
 };
 
 }  // namespace blink
 
 #endif  // ScriptState_h