Document Org.W3c.Dom.LS APIs

[jonathanpeppers]

Closes #292

Summary

• Documents the Org.W3c.Dom.LS namespace and its remaining input, parser, serializer, exception, and task-wrapper API documentation.
• Replaces all 50 To be added placeholders present in this checkout's editable namespace XML files. (docs/xml/index.xml was not modified.)

Sources

• Android API reference: org.w3c.dom.ls
• Java SE 17 API: org.w3c.dom.ls
• The .NET task-wrapper descriptions are limited to the corresponding documented parser and serializer operations. No AOSP-only source gaps were required.

Validation

• Parsed all 14 scoped XML files with PowerShell's XML parser.
• Confirmed CRLF line endings are preserved in all scoped files.
• Ran git diff --check.
• Confirmed the diff is limited to Org.W3c.Dom.LS XML and ns-Org.W3c.Dom.LS.xml.
• Confirmed zero remaining To be added placeholders in the editable scoped XML files.

[Copilot]

Pull request overview

This PR completes XML documentation for the Org.W3c.Dom.LS namespace by replacing remaining To be added placeholders with meaningful summaries, parameter descriptions, return/value text, and namespace/type descriptions, aligning these docs with the rest of the repository’s Android API reference-style XML documentation.

Changes:

• Documented Org.W3c.Dom.LS namespace summary (ns-Org.W3c.Dom.LS.xml).
• Filled in missing constructor/property docs for LSException and key API surface docs across parser/serializer types.
• Added/expanded extension-method documentation for async parser and serializer task wrappers.

Reviewed changes

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

Show a summary per file

File	Description
docs/xml/Org.W3c.Dom.LS/LSException.xml	Replaces placeholders with constructor/property documentation (including error code/message semantics).
docs/xml/Org.W3c.Dom.LS/ILSSerializerExtensions.xml	Documents async serializer extension methods (params/summary/returns).
docs/xml/Org.W3c.Dom.LS/ILSSerializer.xml	Documents serializer properties (DOM config, newline sequence).
docs/xml/Org.W3c.Dom.LS/ILSParserFilter.xml	Documents WhatToShow value description.
docs/xml/Org.W3c.Dom.LS/ILSParserExtensions.xml	Documents async parser extension methods (params/summary/returns).
docs/xml/Org.W3c.Dom.LS/ILSParser.xml	Documents parser properties (Async, Busy, DomConfig, Filter).
docs/xml/Org.W3c.Dom.LS/ILSInput.xml	Documents input source properties (streams, URIs, identifiers, encoding, etc.).
docs/xml/Org.W3c.Dom.LS/DOMImplementationLS.xml	Documents the type’s purpose as a factory for Load/Save objects.
docs/xml/ns-Org.W3c.Dom.LS.xml	Adds a namespace-level summary describing the Load/Save API purpose.

---

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

[jonathanpeppers]

@dalexsoto review

[dalexsoto]

Two DOM LS contracts remain inaccurate:

• DOMImplementationLS exposes only obsolete parser-mode constants; factory methods belong to IDOMImplementationLS.
• ParseAsync/ParseURIAsync merely wrap the underlying calls and can yield null for native asynchronous parsers; their Tasks do not necessarily represent parse completion.

Please correct the constants-holder summary and document the nullable wrapper behavior.

[jonathanpeppers]

Addressed the requested DOM LS contract corrections in 9cfc86c: DOMImplementationLS is documented only as the obsolete parser-mode constants holder, and ParseAsync/ParseURIAsync now state that native asynchronous parsers yield
ull and that task completion does not indicate parse completion.

[dalexsoto]

DOMImplementationLS and the async parser wrappers now accurately describe the managed constants-holder, nullable results, and native completion semantics.