Document Linkify match options

[jonathanpeppers]

Refs #186

Sources

• Android Linkify reference: Linkify mask behavior and the Android 8.1-and-earlier WebView-update exception note.
• AOSP Linkify.java: ALL composition and Android deprecation/avoidance guidance for ALL and MAP_ADDRESSES.

Validation

• Parsed docs/xml/Android.Text.Util/MatchOptions.xml with PowerShell's XML parser.
• Confirmed 162 CRLF sequences and zero lone LF characters in the edited file.
• Ran git diff --check.
• Generated ECMA2Yaml preview and confirmed Android.Text.Util.MatchOptions.All and Android.Text.Util.MatchOptions.MapAddresses contain the essential warnings in their published YAML summary values.

[Copilot]

Pull request overview

This PR updates the XML documentation for Android.Text.Util.MatchOptions by replacing placeholder summaries with descriptive text for the Linkify-related flag values, aligning the docs with the Android Linkify reference.

Changes:

• Documented the EmailAddresses match option (bit-field flag).
• Documented the PhoneNumbers match option (bit-field flag).
• Documented the WebUrls match option (bit-field flag).

---

💡 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]

All and MapAddresses remain undocumented even though both are public flags with important deprecated behavior. All includes MapAddresses, whose upstream implementation has documented limitations and can throw on Android 8.1 and earlier, while the managed fields have no [Obsolete] warning. Please document their composition, deprecation, and avoidance guidance in publishing-supported content: MatchOptions.xml.

[jonathanpeppers]

@dalexsoto Addressed the requested documentation: All now states that it includes MapAddresses; both public flags include the Android deprecation and avoidance guidance; and the source-backed Android 8.1/API 27-and-earlier WebView-update exception is documented. No managed [Obsolete] metadata was added.

[jonathanpeppers]

@dalexsoto review

[dalexsoto]

The All and MapAddresses summaries now cover composition and basic status, but all deprecation, avoidance, WebView limitation, and Android 8.1 exception guidance is still placed in enum-field <remarks>, which ECMA2Yaml ignores. Please move the essential warnings into published member summaries or type-level remarks and verify the generated preview: MatchOptions.xml.

[jonathanpeppers]

@dalexsoto Addressed the publishing-surface feedback in commit 9aa5f432: moved the required deprecation, avoidance, WebView.findAddress(String) limitation, and Android 8.1/API 27-and-earlier exception guidance into the All and MapAddresses member summaries. I generated Android.Text.Util.MatchOptions.yml with ECMA2Yaml and verified both published YAML summary fields contain that guidance.