src/java.base/share/classes/java/lang/Object.java

@@ -1,7 +1,7 @@
  /*
-  * Copyright (c) 1994, 2019, Oracle and/or its affiliates. All rights reserved.
+  * Copyright (c) 1994, 2020, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this

@@ -38,10 +38,12 @@
   */
  public class Object {
  
      /**
       * Constructs a new object.
+      * @apiNote {@link IdentityObject#newIdentity new IdentityObject.newIdentity()}
+      * should be used instead of {@code new Object()}.
       */
      @HotSpotIntrinsicCandidate
      public Object() {}
  
      /**