reflow comments in core/frame

third_party/WebKit/Source/core/frame/Location.h

 /*
  * Copyright (C) 2008, 2010 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 25 matching lines @@
 #include "core/frame/DOMWindowProperty.h"
 #include "wtf/text/WTFString.h"
 
 namespace blink {
 
 class LocalDOMWindow;
 class ExceptionState;
 class Frame;
 class KURL;
 
-// This class corresponds to the JS Location API, which is the only DOM API besides Window that is operable
-// in a RemoteFrame. Rather than making DOMWindowProperty support RemoteFrames and generating a lot
-// code churn, Location is implemented as a one-off with some custom lifetime management code. Namely,
-// it needs a manual call to reset() from DOMWindow::reset() to ensure it doesn't retain a stale Frame pointer.
+// This class corresponds to the JS Location API, which is the only DOM API
+// besides Window that is operable in a RemoteFrame. Rather than making
+// DOMWindowProperty support RemoteFrames and generating a lot code churn,
+// Location is implemented as a one-off with some custom lifetime management
+// code. Namely, it needs a manual call to reset() from DOMWindow::reset() to
+// ensure it doesn't retain a stale Frame pointer.
 class CORE_EXPORT Location final : public GarbageCollected<Location>,
                                    public ScriptWrappable {
   DEFINE_WRAPPERTYPEINFO();
 
  public:
   static Location* create(Frame* frame) { return new Location(frame); }
 
   Frame* frame() const { return m_frame.get(); }
   void reset() { m_frame = nullptr; }
 
@@ skipping 45 matching lines @@
   String search() const;
   void setHash(LocalDOMWindow* currentWindow,
                LocalDOMWindow* enteredWindow,
                const String&,
                ExceptionState&);
   String hash() const;
   String origin() const;
 
   DOMStringList* ancestorOrigins() const;
 
-  // Just return the |this| object the way the normal valueOf function on the Object prototype would.
-  // The valueOf function is only added to make sure that it cannot be overwritten on location
-  // objects, since that would provide a hook to change the string conversion behavior of location objects.
+  // Just return the |this| object the way the normal valueOf function on the
+  // Object prototype would.  The valueOf function is only added to make sure
+  // that it cannot be overwritten on location objects, since that would provide
+  // a hook to change the string conversion behavior of location objects.
   ScriptValue valueOf(const ScriptValue& thisObject) { return thisObject; }
 
   DECLARE_VIRTUAL_TRACE();
 
  private:
   explicit Location(Frame*);
 
   enum class SetLocation { Normal, ReplaceThisFrame };
   void setLocation(const String&,
                    LocalDOMWindow* currentWindow,
                    LocalDOMWindow* enteredWindow,
                    ExceptionState* = nullptr,
                    SetLocation = SetLocation::Normal);
 
   const KURL& url() const;
 
   Member<Frame> m_frame;
 };
 
 }  // namespace blink
 
 #endif  // Location_h