[api] Add documentation for PropertyCallbackInfo.

include/v8.h

 // Copyright 2012 the V8 project authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 /** \mainpage V8 API Reference Guide
  *
  * V8 is Google's open source JavaScript engine.
  *
  * This set of documents provides reference material generated from the
  * V8 header file, include/v8.h.
@@ skipping 3218 matching lines @@
 };
 
 
 /**
  * The information passed to a property callback about the context
  * of the property access.
  */
 template<typename T>
 class PropertyCallbackInfo {
  public:
+  /**
+   * \return The isolate of the property access.
+   */
   V8_INLINE Isolate* GetIsolate() const;
+
+  /**
+   * \return The data set in the configuration, i.e., in
+   * `NamedPropertyHandlerConfiguration` or
+   * `IndexedPropertyHandlerConfiguration.`
+   */
   V8_INLINE Local<Value> Data() const;
+
+  /**
+   * \return The receiver, i.e., the object on which the property access was
+   * intercepted.

[jochen (gone - plz use gerrit), 2016/08/23 12:43:26]

Not sure I understand.

so assuming you have x and x's prototype is y, and y has an interceptor. then
This() would be x, but Holder() would be y.

[Franzi, 2016/08/23 13:11:01]

Done.

+   * In `x.a`, the receiver is `x`.
+   */
   V8_INLINE Local<Object> This() const;
+
+  /**
+   * \return The object that is the target property, i.e., in `x.a`, the
+   * holder is `a`.

[jochen (gone - plz use gerrit), 2016/08/23 12:43:26]

see above

[Franzi, 2016/08/23 13:11:01]

Done.

+   */
   V8_INLINE Local<Object> Holder() const;
+
+  /**
+   * \return The return value of the callback.
+   * Can be used to define the return value by calling Set().
+   * \code
+   * info.GetReturnValue().Set(...)
+   * \endcode
+   */
   V8_INLINE ReturnValue<T> GetReturnValue() const;
+
+  /**
+   * \return True, if the intercepted function should
+   * throw if an error occurs. Usually, `true` corresponds to `'use strict.'`
+   */
   V8_INLINE bool ShouldThrowOnError() const;
+
   // This shouldn't be public, but the arm compiler needs it.
   static const int kArgsLength = 7;
 
  protected:
   friend class MacroAssembler;
   friend class internal::PropertyCallbackArguments;
   friend class internal::CustomArguments<PropertyCallbackInfo>;
   static const int kShouldThrowOnErrorIndex = 0;
   static const int kHolderIndex = 1;
   static const int kIsolateIndex = 2;
@@ skipping 5731 matching lines @@
  */
 
 
 }  // namespace v8
 
 
 #undef TYPE_CHECK
 
 
 #endif  // INCLUDE_V8_H_