Document TypeDescriptor method operations

[jonathanpeppers]

Summary

• Documented all seven source-backed Java.Lang.Invoke.ITypeDescriptor.IOfMethod operations for changing and inspecting method descriptors.
• Kept the follow-up limited to Android API 34 TypeDescriptor.OfMethod members, with no overlap with the merged lookup, call-site, var-handle, or reference-kind documentation PRs.

Refs #201

Sources

• https://developer.android.com/reference/java/lang/invoke/TypeDescriptor.OfMethod
• https://developer.android.com/reference/java/lang/invoke/TypeDescriptor.OfMethod#changeParameterType(int,%20F)
• https://developer.android.com/reference/java/lang/invoke/TypeDescriptor.OfMethod#changeReturnType(F)
• https://developer.android.com/reference/java/lang/invoke/TypeDescriptor.OfMethod#dropParameterTypes(int,%20int)
• https://developer.android.com/reference/java/lang/invoke/TypeDescriptor.OfMethod#insertParameterTypes(int,%20F%5B%5D)
• https://developer.android.com/reference/java/lang/invoke/TypeDescriptor.OfMethod#parameterArray()
• https://developer.android.com/reference/java/lang/invoke/TypeDescriptor.OfMethod#parameterType(int)
• https://developer.android.com/reference/java/lang/invoke/TypeDescriptor.OfMethod#returnType()

Validation

• Parsed docs/xml/Java.Lang.Invoke/ITypeDescriptor+IOfMethod.xml with PowerShell's XML parser.
• Confirmed CRLF line endings with zero bare LF characters.
• Confirmed zero To be added. placeholders remain in the edited file; 420 remain in the partial Java.Lang.Invoke scope.
• Reviewed the full focused diff and ran git diff --check.

[dalexsoto]

InsertParameterTypes says descriptors are inserted before the parameter at pos, but API 34 permits pos == ParameterCount; in that case no parameter exists there and the descriptors are appended. Please say insertion starts at pos and explicitly document the append case: ITypeDescriptor+IOfMethod.xml.

[jonathanpeppers]

Addressed in 3f2c925. InsertParameterTypes now says insertion starts at pos and explicitly documents that pos == ParameterCount() appends the supplied descriptors because no parameter exists at that position.

[jonathanpeppers]

Addressed in 3f2c925: insertion starts at pos; when pos == ParameterCount(), the supplied descriptors are appended because no parameter exists at that position.

[Copilot]

Pull request overview

Adds detailed XML documentation for the Android API 34 Java.Lang.Invoke.ITypeDescriptor.IOfMethod (“TypeDescriptor.OfMethod”) operations so the generated .NET API docs no longer contain To be added. placeholders for these members.

Changes:

• Replaced placeholder <summary>, <param>, <returns>, and <remarks> text for seven ITypeDescriptor.IOfMethod members.
• Added concise behavioral descriptions for descriptor-transforming and descriptor-inspecting operations.

Suppressed comments (6)

docs/xml/Java.Lang.Invoke/ITypeDescriptor+IOfMethod.xml:125

• These member docs add new prose but omit the standard Android reference link + AOSP/CC BY attribution paragraphs used elsewhere in this file (e.g., ParameterCount/ParameterList). For consistency and licensing attribution, please add the reference link for changeReturnType(...) and the attribution para to this block.

        <remarks>
          <para>The returned descriptor has the same parameter types as this descriptor and uses <paramref name="newReturn" /> as its return type.</para>
        </remarks>

docs/xml/Java.Lang.Invoke/ITypeDescriptor+IOfMethod.xml:210

• These member docs add new prose but omit the standard Android reference link + AOSP/CC BY attribution paragraphs used elsewhere in this file (e.g., ParameterCount/ParameterList). For consistency and licensing attribution, please add the reference link for insertParameterTypes(...) and the attribution para to this block.

        <remarks>
          <para>Insertion starts at <paramref name="pos" />. When <paramref name="pos" /> equals <c>ParameterCount()</c>, the supplied field descriptors are appended because no parameter exists at that position.</para>
        </remarks>

docs/xml/Java.Lang.Invoke/ITypeDescriptor+IOfMethod.xml:248

• These member docs add new prose but omit the standard Android reference link + AOSP/CC BY attribution paragraphs used elsewhere in this file (e.g., ParameterCount/ParameterList). For consistency and licensing attribution, please add the reference link for parameterArray() and the attribution para to this block.

        <remarks>
          <para>The returned array describes the parameter types in declaration order.</para>
        </remarks>

docs/xml/Java.Lang.Invoke/ITypeDescriptor+IOfMethod.xml:369

• These member docs add new prose but omit the standard Android reference link + AOSP/CC BY attribution paragraphs used elsewhere in this file (e.g., ParameterCount/ParameterList). For consistency and licensing attribution, please add the reference link for parameterType(int) and the attribution para to this block.

        <remarks>
          <para>The returned descriptor describes the parameter at <paramref name="i" />.</para>
        </remarks>

docs/xml/Java.Lang.Invoke/ITypeDescriptor+IOfMethod.xml:401

• These member docs add new prose but omit the standard Android reference link + AOSP/CC BY attribution paragraphs used elsewhere in this file (e.g., ParameterCount/ParameterList). For consistency and licensing attribution, please add the reference link for returnType() and the attribution para to this block.

        <remarks>
          <para>The returned descriptor represents this method descriptor's return type.</para>
        </remarks>

docs/xml/Java.Lang.Invoke/ITypeDescriptor+IOfMethod.xml:162

• These member docs add new prose but omit the standard Android reference link + AOSP/CC BY attribution paragraphs used elsewhere in this file (e.g., ParameterCount/ParameterList). For consistency and licensing attribution, please add the reference link for dropParameterTypes(...) and the attribution para to this block.

        <remarks>
          <para>The removed range starts at <paramref name="start" /> and excludes <paramref name="end" />.</para>
        </remarks>

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[jonathanpeppers]

@dalexsoto review

[dalexsoto]

InsertParameterTypes now correctly documents insertion at pos and the append behavior when pos == ParameterCount(), with no remaining blocker.