Problem
The public, user-facing Android.App.SupportsGLTextureAttribute in Mono.Android.dll has no XML documentation. This attribute maps to the Android manifest <supports-gl-texture> element, so developers see no IntelliSense/API-doc guidance when consuming it. This is a purely additive, comment-only fix.
Location
- File(s):
src/Mono.Android/Android.App/SupportsGLTextureAttribute.cs
- Line(s): 9, 11, 16 (class, constructor,
Name property)
Current Code
public sealed partial class SupportsGLTextureAttribute : Attribute
{
public SupportsGLTextureAttribute (string name)
{
Name = name;
}
public string Name {get; private set;}
}
Suggested Fix
Add /// XML documentation to the class, constructor, and Name property. Follow the existing style used elsewhere in src/Mono.Android/ (single-line <summary> where practical). Do not change any code, formatting of members, or behavior. Example:
/// <summary>
/// Declares a single GL texture compression format that the application supports,
/// generating a <c><supports-gl-texture></c> element in the Android manifest.
/// </summary>
/// <remarks>
/// See the Android documentation for
/// <see href="(developer.android.com/redacted)
/// </remarks>
public sealed partial class SupportsGLTextureAttribute : Attribute
{
/// <summary>
/// Initializes a new instance of the <see cref="SupportsGLTextureAttribute" /> class.
/// </summary>
/// <param name="name">The GL texture compression format the application supports, for example <c>GL_OES_compressed_ETC1_RGB8_texture</c>.</param>
public SupportsGLTextureAttribute (string name)
{
Name = name;
}
/// <summary>
/// Gets the GL texture compression format the application supports, for example <c>GL_OES_compressed_ETC1_RGB8_texture</c>.
/// </summary>
public string Name {get; private set;}
}
Guidelines
- Follow dotnet/android formatting: tabs, space before
(, preserve existing member alignment.
- Only add
/// comments — do not alter any executable code or member signatures.
- Reference the official Android [
<supports-gl-texture>]((developer.android.com/redacted) documentation.
Acceptance Criteria
Fix-finder metadata
- Script:
04-missing-xml-docs
- Score:
30/30 (actionability: 10, safety: 10, scope: 10)
Generated by Nightly Fix Finder · 68.4 AIC · ⌖ 17.2 AIC · ⊞ 9.4K · ◷
Problem
The public, user-facing
Android.App.SupportsGLTextureAttributeinMono.Android.dllhas no XML documentation. This attribute maps to the Android manifest<supports-gl-texture>element, so developers see no IntelliSense/API-doc guidance when consuming it. This is a purely additive, comment-only fix.Location
src/Mono.Android/Android.App/SupportsGLTextureAttribute.csNameproperty)Current Code
Suggested Fix
Add
///XML documentation to the class, constructor, andNameproperty. Follow the existing style used elsewhere insrc/Mono.Android/(single-line<summary>where practical). Do not change any code, formatting of members, or behavior. Example:Guidelines
(, preserve existing member alignment.///comments — do not alter any executable code or member signatures.<supports-gl-texture>]((developer.android.com/redacted) documentation.Acceptance Criteria
SupportsGLTextureAttribute, its constructor, and itsNameproperty have///XML doc comments.Fix-finder metadata
04-missing-xml-docs30/30(actionability: 10, safety: 10, scope: 10)