Deprecate unused Map/Set FromArray factory methods

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 2990 matching lines @@
   /**
    * Creates a new empty Map.
    */
   static Local<Map> New(Isolate* isolate);
 
   /**
    * Creates a new Map containing the elements of array, which must be formatted
    * in the same manner as the array returned from AsArray().
    * Guaranteed to be side-effect free if the array contains no holes.
    */
-  static V8_WARN_UNUSED_RESULT MaybeLocal<Map> FromArray(Local<Context> context,
-                                                         Local<Array> array);
+  static V8_WARN_UNUSED_RESULT V8_DEPRECATE_SOON(

[jochen (gone - plz use gerrit), 2015/07/15 13:35:37]

can you mark them as V8_DEPRECATED() right away?

+      "Use mutation methods instead",
+      MaybeLocal<Map> FromArray(Local<Context> context, Local<Array> array));
 
   V8_INLINE static Map* Cast(Value* obj);
 
  private:
   Map();
   static void CheckCast(Value* obj);
 };
 
 
 /**
@@ skipping 17 matching lines @@
 
   /**
    * Creates a new empty Set.
    */
   static Local<Set> New(Isolate* isolate);
 
   /**
    * Creates a new Set containing the items in array.
    * Guaranteed to be side-effect free if the array contains no holes.
    */
-  static V8_WARN_UNUSED_RESULT MaybeLocal<Set> FromArray(Local<Context> context,
-                                                         Local<Array> array);
+  static V8_WARN_UNUSED_RESULT V8_DEPRECATE_SOON(
+      "Use mutation methods instead",
+      MaybeLocal<Set> FromArray(Local<Context> context, Local<Array> array));
 
   V8_INLINE static Set* Cast(Value* obj);
 
  private:
   Set();
   static void CheckCast(Value* obj);
 };
 
 
 template<typename T>
@@ skipping 5280 matching lines @@
  */
 
 
 }  // namespace v8
 
 
 #undef TYPE_CHECK
 
 
 #endif  // V8_H_