From c5c09aaed9bed6978c6553176eab9049a2c72f7f Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sat, 15 Aug 2026 11:41:26 -0500 Subject: [PATCH 1/2] Document Java runtime namespace Refs #185 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/xml/ns-Java.Lang.Runtimes.xml | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/xml/ns-Java.Lang.Runtimes.xml b/docs/xml/ns-Java.Lang.Runtimes.xml index f5d4d2f03..9a347f96a 100644 --- a/docs/xml/ns-Java.Lang.Runtimes.xml +++ b/docs/xml/ns-Java.Lang.Runtimes.xml @@ -1,6 +1,10 @@ - To be added. - To be added. + Provides access to the Java runtime environment. + + + represents the runtime environment for the current Java application. + + From ca5968099e861cd36f993f52ab801dc1c759326a Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sat, 15 Aug 2026 11:53:07 -0500 Subject: [PATCH 2/2] Document Java runtime bootstrap APIs Refs #185 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/xml/Java.Lang.Runtimes/ObjectMethods.xml | 73 ++++++++++++------ .../Java.Lang.Runtimes/SwitchBootstraps.xml | 76 ++++++++++++------- docs/xml/ns-Java.Lang.Runtimes.xml | 4 +- 3 files changed, 100 insertions(+), 53 deletions(-) diff --git a/docs/xml/Java.Lang.Runtimes/ObjectMethods.xml b/docs/xml/Java.Lang.Runtimes/ObjectMethods.xml index c5afdbb2f..7df071c7a 100644 --- a/docs/xml/Java.Lang.Runtimes/ObjectMethods.xml +++ b/docs/xml/Java.Lang.Runtimes/ObjectMethods.xml @@ -26,8 +26,23 @@ - To be added. - To be added. + Provides bootstrap methods for state-driven implementations of core object methods. + + + Java compilers can use these methods to implement equals, hashCode, and toString for record classes. + + + + Java documentation for java.lang.runtime.ObjectMethods. + + + + Portions of this page are modifications based on work created and shared by the + Android Open Source Project + and used according to terms described in the + Creative Commons 2.5 Attribution License. + + @@ -45,10 +60,10 @@ - To be added. - To be added. - To be added. - To be added. + A containing a Java Native Interface (JNI) object reference. + A indicating how to handle . + A constructor used when creating managed representations of JNI objects; called by the runtime. + @@ -97,15 +112,27 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + A lookup context. This parameter is ignored. + The name of the method to generate: equals, hashCode, or toString. + The descriptor for the method or dynamic constant being linked. + The record class that declares the record components. + A semicolon-separated list of component names, or an empty string when there are no components. + Method handles for the component accessor methods. + Generates core object methods for a record class from its component names and accessors. + A call site for an invokedynamic call site, or a method handle for a dynamic constant-pool entry. + + + + Java documentation for java.lang.runtime.ObjectMethods.bootstrap. + + + + Portions of this page are modifications based on work created and shared by the + Android Open Source Project + and used according to terms described in the + Creative Commons 2.5 Attribution License. + + @@ -132,9 +159,9 @@ Java.Interop.JniPeerMembers - To be added. - To be added. - To be added. + Gets the JNI metadata used to invoke members of this Java peer. + The JNI peer members for ObjectMethods. + @@ -161,9 +188,8 @@ System.IntPtr - To be added. - To be added. - To be added. + This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. + @@ -190,9 +216,8 @@ System.Type - To be added. - To be added. - To be added. + This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. + diff --git a/docs/xml/Java.Lang.Runtimes/SwitchBootstraps.xml b/docs/xml/Java.Lang.Runtimes/SwitchBootstraps.xml index f89bbdca9..73bf6356d 100644 --- a/docs/xml/Java.Lang.Runtimes/SwitchBootstraps.xml +++ b/docs/xml/Java.Lang.Runtimes/SwitchBootstraps.xml @@ -62,10 +62,10 @@ - To be added. - To be added. - To be added. - To be added. + A containing a Java Native Interface (JNI) object reference. + A indicating how to handle . + A constructor used when creating managed representations of JNI objects; called by the runtime. + @@ -109,13 +109,25 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The lookup context with the caller's accessibility privileges. + Unused. + The call site invocation type with an enum parameter, an int parameter, and an int return type. + The case labels, represented by constants or instances. + Links an invokedynamic call site that switches on an enum target. + A call site that returns the index of the first matching label. + + + + Java documentation for java.lang.runtime.SwitchBootstraps.enumSwitch. + + + + Portions of this page are modifications based on work created and shared by the + Android Open Source Project + and used according to terms described in the + Creative Commons 2.5 Attribution License. + + @@ -142,9 +154,9 @@ Java.Interop.JniPeerMembers - To be added. - To be added. - To be added. + Gets the JNI metadata used to invoke members of this Java peer. + The JNI peer members for SwitchBootstraps. + @@ -171,9 +183,8 @@ System.IntPtr - To be added. - To be added. - To be added. + This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. + @@ -200,9 +211,8 @@ System.Type - To be added. - To be added. - To be added. + This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. + @@ -246,13 +256,25 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The lookup context with the caller's accessibility privileges. + Unused. + The call site invocation type with a reference-type parameter, an int parameter, and an int return type. + The case labels, represented by , , , or enum-description values. + Links an invokedynamic call site that switches on a reference-type target. + A call site that returns the index of the first matching label. + + + + Java documentation for java.lang.runtime.SwitchBootstraps.typeSwitch. + + + + Portions of this page are modifications based on work created and shared by the + Android Open Source Project + and used according to terms described in the + Creative Commons 2.5 Attribution License. + + diff --git a/docs/xml/ns-Java.Lang.Runtimes.xml b/docs/xml/ns-Java.Lang.Runtimes.xml index 9a347f96a..6943eaad8 100644 --- a/docs/xml/ns-Java.Lang.Runtimes.xml +++ b/docs/xml/ns-Java.Lang.Runtimes.xml @@ -1,9 +1,9 @@ - Provides access to the Java runtime environment. + Provides bootstrap methods for Java language features. - represents the runtime environment for the current Java application. + This namespace contains bootstrap APIs for record-object methods and switch statement call sites.