Document OpenGL ES binding migrations

[jonathanpeppers]

Refs #281

Documents the deprecated managed OpenGL ES wrapper types with their binding-defined replacement interfaces, and documents the shared Android OpenGL ES marker interface. This is a partial increment; 1,923 scoped To be added. placeholders remain.

Sources

• Android API reference: GL
• Android API reference: GL10, GL11, GL11Ext, and GL11ExtensionPack
• Android Open Source Project GL.java verifies the marker-interface relationship where the Android reference has no narrative. The XML already contains the required AOSP attribution.
• The edited XML binding metadata supplies the explicit Obsolete replacement types.

Validation

• Parsed all five edited XML files with PowerShell's XML parser.
• Verified every edited file retains CRLF line endings with zero lone LF bytes.
• Ran git diff --check.
• Counted 1,923 remaining To be added. placeholders in docs/xml/Javax.Microedition.Khronos.Opengles.

[Copilot]

Pull request overview

This PR incrementally improves the XML reference documentation for Javax.Microedition.Khronos.Opengles by replacing several To be added. placeholders with migration guidance for deprecated managed OpenGL ES wrapper types, and by documenting the shared Android OpenGL ES marker/base interface.

Changes:

• Document IGL as the shared base/marker interface for Android OpenGL ES interfaces.
• Update GL10, GL11, GL11Ext, and GL11ExtensionPack type summaries to clearly direct users to the binding-defined IGL* replacement interfaces via <see cref="T:...">.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
docs/xml/Javax.Microedition.Khronos.Opengles/IGL.xml	Replaces placeholder summary with a concrete description of the shared OpenGL ES base interface.
docs/xml/Javax.Microedition.Khronos.Opengles/GL10.xml	Replaces placeholder summary with obsolete/replacement guidance pointing to IGL10.
docs/xml/Javax.Microedition.Khronos.Opengles/GL11.xml	Replaces placeholder summary with obsolete/replacement guidance pointing to IGL11.
docs/xml/Javax.Microedition.Khronos.Opengles/GL11Ext.xml	Replaces placeholder summary with obsolete/replacement guidance pointing to IGL11Ext.
docs/xml/Javax.Microedition.Khronos.Opengles/GL11ExtensionPack.xml	Replaces placeholder summary with obsolete/replacement guidance pointing to IGL11ExtensionPack.

---

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

[jonathanpeppers]

@dalexsoto review

[jonathanpeppers]

@dalexsoto review

[dalexsoto]

The OpenGL ES documentation matches the Khronos/AOSP contracts and managed metadata, with the accepted incremental placeholder scope preserved.