Document Java.Awt.Font

[jonathanpeppers]

Closes #213

Sources

• Android Developers: java.awt.font.TextAttribute
• Android Developers: java.awt.font.NumericShaper
• Android Developers: java.awt.font.NumericShaper.Range
• OpenJDK NumericShaper source

Validation

• Parsed all five scoped XML files.
• Confirmed CRLF line endings for all scoped XML files.
• Confirmed zero To be added placeholders in Java.Awt.Font and ns-Java.Awt.Font.xml.
• Ran git diff --check.

[jonathanpeppers]

@dalexsoto review

[jonathanpeppers]

@dalexsoto review

[dalexsoto]

docs/xml/Java.Awt.Font/NumericShaper.xml references nonexistent managed member NumericShaper.Range.EUROPEAN. The binding exposes NumericShaper.Range.European; please use that name so the documented example compiles.

[jonathanpeppers]

@dalexsoto Fixed in 072a732: the managed API reference now uses NumericShaper.Range.European.

[jonathanpeppers]

@dalexsoto review

[Copilot]

Pull request overview

This PR adds/updates XML documentation for the Java.Awt.Font namespace, replacing remaining placeholders and improving API reference text for TextAttribute, NumericShaper, and related range types.

Changes:

• Replaced the namespace-level “To be added.” summary with a concrete description.
• Removed placeholder <value> elements across TextAttribute and added standard interop infrastructure docs where applicable.
• Added/updated summaries for Ranges, NumericShaper.Range members, and parameter documentation in NumericShaper.

Reviewed changes

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

Show a summary per file

File	Description
docs/xml/ns-Java.Awt.Font.xml	Adds a meaningful namespace summary.
docs/xml/Java.Awt.Font/TextAttribute.xml	Removes placeholders and documents interop infrastructure members.
docs/xml/Java.Awt.Font/Ranges.xml	Replaces placeholder summary with a concrete description of supported ranges.
docs/xml/Java.Awt.Font/NumericShaper+Range.xml	Fills in summaries for many range constants and infrastructure members.
docs/xml/Java.Awt.Font/NumericShaper.xml	Improves parameter docs (notably context) and retains reference links.

Suppressed comments (1)

docs/xml/Java.Awt.Font/NumericShaper.xml:1254

• The "Java documentation" link in this member's points to the 3-parameter overload of NumericShaper.shape, but this binding is the 4-parameter overload that includes a NumericShaper.Range context. This makes the reference link/signature misleading; update the href and displayed signature to match the Range overload.

        <param name="context">The context to which to convert the characters, such as <c>NumericShaper.Range.European</c>.</param>
        <summary>Converts the digits in the text that occur between start and
            start + count.</summary>
        <remarks>
          <para>

---

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

[dalexsoto]

The invalid managed member reference is fixed; no blocking issues remain.