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

Metadata

Metadata

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions