diff --git a/src/java.base/share/classes/java/lang/doc-files/ValueBased.html b/src/java.base/share/classes/java/lang/doc-files/ValueBased.html index cbd554662dd..fe720a37be7 100644 --- a/src/java.base/share/classes/java/lang/doc-files/ValueBased.html +++ b/src/java.base/share/classes/java/lang/doc-files/ValueBased.html @@ -1,11 +1,35 @@ + Value-based Classes -

Value-based Classes

+

{@index "Value-based Classes"}

Some classes, such as java.util.Optional and java.time.LocalDateTime, are value-based. Instances of a @@ -23,7 +47,7 @@ value-based class:
  • are considered equal solely based on equals(), not based on reference equality (==);
  • do not have accessible constructors, but are instead instantiated - through factory methods which make no committment as to the identity + through factory methods which make no commitment as to the identity of returned instances;
  • are freely substitutable when equal, meaning that interchanging any two instances x and y that are equal