Document core Android.Text.Method transformations

[jonathanpeppers]

Sources

• https://developer.android.com/reference/android/text/method/SingleLineTransformationMethod
• https://developer.android.com/reference/android/text/method/HideReturnsTransformationMethod

Validation

• Parsed both changed XML files with PowerShell's XML parser.
• Confirmed CRLF-only line endings in both changed files.
• Ran git diff --check.

Refs #205

[Copilot]

Pull request overview

Updates Android API XML documentation in Android.Text.Method to replace “To be added.” placeholders with meaningful <returns> documentation for core transformation methods (per #205).

Changes:

• Filled <returns> docs for GetOriginal() in SingleLineTransformationMethod and HideReturnsTransformationMethod.
• Filled <returns> docs for GetReplacement() in SingleLineTransformationMethod and HideReturnsTransformationMethod.

Reviewed changes

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

File	Description
docs/xml/Android.Text.Method/SingleLineTransformationMethod.xml	Replaces placeholder <returns> docs for GetOriginal()/GetReplacement() with descriptive text.
docs/xml/Android.Text.Method/HideReturnsTransformationMethod.xml	Replaces placeholder <returns> docs for GetOriginal()/GetReplacement() with descriptive text.

Suppressed comments (2)

docs/xml/Android.Text.Method/HideReturnsTransformationMethod.xml:155

• The text should describe the method's return value (a char array) instead of restating the summary; make it explicit that this returns the replacement character.

        <returns>The character that \r is replaced with is \uFEFF.</returns>

docs/xml/Android.Text.Method/SingleLineTransformationMethod.xml:156

• The summary/remarks/returns contain grammatical errors ("replaced with is") and the should describe the returned char[]; update these lines so they clearly describe the replacement characters and use a consistent U+FEFF representation.

        <summary>The character \n is replaced with is space;
            the character \r is replaced with is FEFF (zero width space).</summary>
        <returns>The character \n is replaced with space; the character \r is replaced with FEFF (zero width space).</returns>

---

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

[jonathanpeppers]

@dalexsoto review

[dalexsoto]

The documented API behavior matches the current contracts; no blocking issues found.