Skip to content

[fix-finder] Add XML documentation to SupportsGLTextureAttribute #12233

Description

@github-actions

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

  • SupportsGLTextureAttribute, its constructor, and its Name property have /// XML doc comments.
  • No code, signatures, or behavior changed.
  • All tests pass
  • No new warnings introduced

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 ·

  • expires on Aug 1, 2026, 2:25 AM UTC

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions