reflow comments in Source/bindings/core/v8

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

 /*
 * Copyright (C) 2009 Google Inc. All rights reserved.
 * Copyright (C) 2012 Ericsson AB. 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 377 matching lines @@
     v8::Local<v8::String> value) {
   if (value.IsEmpty() || value->IsNull() || value->IsUndefined())
     return String();
   return toCoreString(value);
 }
 
 inline AtomicString toCoreAtomicString(v8::Local<v8::String> value) {
   return v8StringToWebCoreString<AtomicString>(value, Externalize);
 }
 
-// This method will return a null String if the v8::Value does not contain a v8::String.
-// It will not call ToString() on the v8::Value. If you want ToString() to be called,
-// please use the TONATIVE_FOR_V8STRINGRESOURCE_*() macros instead.
+// This method will return a null String if the v8::Value does not contain a
+// v8::String.  It will not call ToString() on the v8::Value. If you want
+// ToString() to be called, please use the TONATIVE_FOR_V8STRINGRESOURCE_*()
+// macros instead.
 inline String toCoreStringWithUndefinedOrNullCheck(v8::Local<v8::Value> value) {
   if (value.IsEmpty() || !value->IsString())
     return String();
   return toCoreString(value.As<v8::String>());
 }
 
 // Convert a string to a V8 string.
 
 inline v8::Local<v8::String> v8String(v8::Isolate* isolate,
                                       const StringView& string) {
@@ skipping 123 matching lines @@
                                   IntegerConversionConfiguration,
                                   ExceptionState&);
 inline uint32_t toUInt32(v8::Isolate* isolate,
                          v8::Local<v8::Value> value,
                          IntegerConversionConfiguration configuration,
                          ExceptionState& exceptionState) {
   // Fast case. The value is already a 32-bit unsigned integer.
   if (LIKELY(value->IsUint32()))
     return value.As<v8::Uint32>()->Value();
 
-  // Fast case. The value is a 32-bit signed integer with NormalConversion configuration.
+  // Fast case. The value is a 32-bit signed integer with NormalConversion
+  // configuration.
   if (LIKELY(value->IsInt32() && configuration == NormalConversion))
     return value.As<v8::Int32>()->Value();
 
   return toUInt32Slow(isolate, value, configuration, exceptionState);
 }
 
 // Convert a value to a 64-bit signed integer. The conversion fails if the
 // value cannot be converted to a number or the range violated per WebIDL:
 // http://www.w3.org/TR/WebIDL/#es-long-long
 CORE_EXPORT int64_t toInt64Slow(v8::Isolate*,
                                 v8::Local<v8::Value>,
                                 IntegerConversionConfiguration,
                                 ExceptionState&);
 inline int64_t toInt64(v8::Isolate* isolate,
                        v8::Local<v8::Value> value,
                        IntegerConversionConfiguration configuration,
                        ExceptionState& exceptionState) {
-  // Clamping not supported for int64_t/long long int. See Source/wtf/MathExtras.h.
+  // Clamping not supported for int64_t/long long int. See
+  // Source/wtf/MathExtras.h.
   ASSERT(configuration != Clamp);
 
   // Fast case. The value is a 32-bit integer.
   if (LIKELY(value->IsInt32()))
     return value.As<v8::Int32>()->Value();
 
   return toInt64Slow(isolate, value, configuration, exceptionState);
 }
 
 // Convert a value to a 64-bit unsigned integer. The conversion fails if the
@@ skipping 44 matching lines @@
 // Convert a value to a single precision float, throwing on non-finite values.
 CORE_EXPORT float toRestrictedFloat(v8::Isolate*,
                                     v8::Local<v8::Value>,
                                     ExceptionState&);
 
 // Converts a value to a String, throwing if any code unit is outside 0-255.
 CORE_EXPORT String toByteString(v8::Isolate*,
                                 v8::Local<v8::Value>,
                                 ExceptionState&);
 
-// Converts a value to a String, replacing unmatched UTF-16 surrogates with replacement characters.
+// Converts a value to a String, replacing unmatched UTF-16 surrogates with
+// replacement characters.
 CORE_EXPORT String toUSVString(v8::Isolate*,
                                v8::Local<v8::Value>,
                                ExceptionState&);
 
 inline v8::Local<v8::Boolean> v8Boolean(bool value, v8::Isolate* isolate) {
   return value ? v8::True(isolate) : v8::False(isolate);
 }
 
 inline double toCoreDate(v8::Isolate* isolate,
                          v8::Local<v8::Value> object,
@@ skipping 186 matching lines @@
 CORE_EXPORT v8::MaybeLocal<v8::Object> getEsIterator(v8::Isolate*,
                                                      v8::Local<v8::Object>,
                                                      ExceptionState&);
 
 // Validates that the passed object is a sequence type per WebIDL spec
 // http://www.w3.org/TR/2012/CR-WebIDL-20120419/#es-sequence
 inline bool toV8Sequence(v8::Local<v8::Value> value,
                          uint32_t& length,
                          v8::Isolate* isolate,
                          ExceptionState& exceptionState) {
-  // Attempt converting to a sequence if the value is not already an array but is
-  // any kind of object except for a native Date object or a native RegExp object.
+  // Attempt converting to a sequence if the value is not already an array but
+  // is any kind of object except for a native Date object or a native RegExp
+  // object.
   ASSERT(!value->IsArray());
   // FIXME: Do we really need to special case Date and RegExp object?
   // https://www.w3.org/Bugs/Public/show_bug.cgi?id=22806
   if (!value->IsObject() || value->IsDate() || value->IsRegExp()) {
     // The caller is responsible for reporting a TypeError.
     return false;
   }
 
   v8::Local<v8::Object> object = v8::Local<v8::Object>::Cast(value);
   v8::Local<v8::String> lengthSymbol = v8AtomicString(isolate, "length");
 
-  // FIXME: The specification states that the length property should be used as fallback, if value
-  // is not a platform object that supports indexed properties. If it supports indexed properties,
-  // length should actually be one greater than value's maximum indexed property index.
+  // FIXME: The specification states that the length property should be used as
+  // fallback, if value is not a platform object that supports indexed
+  // properties. If it supports indexed properties, length should actually be
+  // one greater than value's maximum indexed property index.
   v8::TryCatch block(isolate);
   v8::Local<v8::Value> lengthValue;
   if (!v8Call(object->Get(isolate->GetCurrentContext(), lengthSymbol),
               lengthValue, block)) {
     exceptionState.rethrowV8Exception(block.Exception());
     return false;
   }
 
   if (lengthValue->IsUndefined() || lengthValue->IsNull()) {
     // The caller is responsible for reporting a TypeError.
@@ skipping 105 matching lines @@
 DOMWindow* toDOMWindow(v8::Isolate*, v8::Local<v8::Value>);
 DOMWindow* toDOMWindow(v8::Local<v8::Context>);
 LocalDOMWindow* enteredDOMWindow(v8::Isolate*);
 CORE_EXPORT LocalDOMWindow* currentDOMWindow(v8::Isolate*);
 CORE_EXPORT ExecutionContext* toExecutionContext(v8::Local<v8::Context>);
 CORE_EXPORT void registerToExecutionContextForModules(
     ExecutionContext* (*toExecutionContextForModules)(v8::Local<v8::Context>));
 CORE_EXPORT ExecutionContext* currentExecutionContext(v8::Isolate*);
 CORE_EXPORT ExecutionContext* enteredExecutionContext(v8::Isolate*);
 
-// Returns a V8 context associated with a ExecutionContext and a DOMWrapperWorld.
-// This method returns an empty context if there is no frame or the frame is already detached.
+// Returns a V8 context associated with a ExecutionContext and a
+// DOMWrapperWorld.  This method returns an empty context if there is no frame
+// or the frame is already detached.
 CORE_EXPORT v8::Local<v8::Context> toV8Context(ExecutionContext*,
                                                DOMWrapperWorld&);
 // Returns a V8 context associated with a Frame and a DOMWrapperWorld.
 // This method returns an empty context if the frame is already detached.
 CORE_EXPORT v8::Local<v8::Context> toV8Context(Frame*, DOMWrapperWorld&);
-// Like toV8Context but also returns the context if the frame is already detached.
+// Like toV8Context but also returns the context if the frame is already
+// detached.
 CORE_EXPORT v8::Local<v8::Context> toV8ContextEvenIfDetached(Frame*,
                                                              DOMWrapperWorld&);
 
 // Returns the frame object of the window object associated with
 // a context, if the window is currently being displayed in a Frame.
 CORE_EXPORT Frame* toFrameIfNotDetached(v8::Local<v8::Context>);
 
 CORE_EXPORT EventTarget* toEventTarget(v8::Isolate*, v8::Local<v8::Value>);
 
 // If 'storage' is non-null, it must be large enough to copy all bytes in the
@@ skipping 96 matching lines @@
                              const char** validValues,
                              size_t length,
                              const String& enumName,
                              ExceptionState&);
 CORE_EXPORT bool isValidEnum(const Vector<String>& values,
                              const char** validValues,
                              size_t length,
                              const String& enumName,
                              ExceptionState&);
 
-// These methods store hidden values into an array that is stored in the internal field of a DOM wrapper.
+// These methods store hidden values into an array that is stored in the
+// internal field of a DOM wrapper.
 bool addHiddenValueToArray(v8::Isolate*,
                            v8::Local<v8::Object>,
                            v8::Local<v8::Value>,
                            int cacheIndex);
 void removeHiddenValueFromArray(v8::Isolate*,
                                 v8::Local<v8::Object>,
                                 v8::Local<v8::Value>,
                                 int cacheIndex);
 CORE_EXPORT void moveEventListenerToNewWrapper(v8::Isolate*,
                                                v8::Local<v8::Object>,
@@ skipping 30 matching lines @@
 
 // Freeze a V8 object. The type of the first parameter and the return value is
 // intentionally v8::Value so that this function can wrap toV8().
 // If the argument isn't an object, this will crash.
 CORE_EXPORT v8::Local<v8::Value> freezeV8Object(v8::Local<v8::Value>,
                                                 v8::Isolate*);
 
 }  // namespace blink
 
 #endif  // V8Binding_h