Document Apache HTTP implementation I/O

[jonathanpeppers]

Closes #286

Documents every API member in Org.Apache.Http.Impl.IO, including managed interop members, with behavior-oriented summaries and parameter/return guidance. The namespace contains no remaining placeholders.

Sources

• Android Open Source Project: Apache HTTP implementation I/O sources
• Android 6.0 Apache HTTP client removal guidance

Validation

• Parsed all 18 scoped XML files successfully.
• Confirmed CRLF line endings across the scoped files.
• Confirmed no To be added., TODO, or TBD placeholders remain in the scoped namespace.
• Ran git diff --check successfully.

[Copilot]

Pull request overview

This PR removes remaining placeholder XML documentation in Org.Apache.Http.Impl.IO by adding behavior-oriented summaries plus parameter/return guidance across the namespace, using AOSP source links as the primary reference.

Changes:

• Replaced To be added. placeholders with concrete summaries/remarks and member-level parameter/return documentation.
• Updated documentation links from Android reference pages to AOSP source pages for the affected types.
• Added a meaningful namespace summary in ns-Org.Apache.Http.Impl.IO.xml.

Reviewed changes

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

Show a summary per file

File	Description
docs/xml/Org.Apache.Http.Impl.IO/SocketOutputBuffer.xml	Adds type/member docs for socket-bound session output buffering.
docs/xml/Org.Apache.Http.Impl.IO/SocketInputBuffer.xml	Adds type/member docs for socket-bound session input buffering.
docs/xml/Org.Apache.Http.Impl.IO/IdentityOutputStream.xml	Documents identity-transfer output stream behavior and members.
docs/xml/Org.Apache.Http.Impl.IO/IdentityInputStream.xml	Documents identity-transfer input stream behavior and members.
docs/xml/Org.Apache.Http.Impl.IO/HttpTransportMetricsImpl.xml	Documents default transport metrics implementation.
docs/xml/Org.Apache.Http.Impl.IO/HttpResponseWriter.xml	Documents response writer construction and status-line writing.
docs/xml/Org.Apache.Http.Impl.IO/HttpResponseParser.xml	Documents response parser construction and status-line parsing.
docs/xml/Org.Apache.Http.Impl.IO/HttpRequestWriter.xml	Documents request writer construction and request-line writing.
docs/xml/Org.Apache.Http.Impl.IO/HttpRequestParser.xml	Documents request parser construction and request-line parsing.
docs/xml/Org.Apache.Http.Impl.IO/ContentLengthOutputStream.xml	Documents content-length-limited output stream behavior and members.
docs/xml/Org.Apache.Http.Impl.IO/ContentLengthInputStream.xml	Documents content-length-limited input stream behavior and members.
docs/xml/Org.Apache.Http.Impl.IO/ChunkedOutputStream.xml	Documents chunked-transfer output stream behavior and members.
docs/xml/Org.Apache.Http.Impl.IO/ChunkedInputStream.xml	Documents chunked-transfer input stream behavior and members (incl. trailers).
docs/xml/Org.Apache.Http.Impl.IO/AbstractSessionOutputBuffer.xml	Documents base session output buffering APIs and metrics.
docs/xml/Org.Apache.Http.Impl.IO/AbstractSessionInputBuffer.xml	Documents base session input buffering APIs and metrics.
docs/xml/Org.Apache.Http.Impl.IO/AbstractMessageWriter.xml	Documents base message-writer behavior and properties.
docs/xml/Org.Apache.Http.Impl.IO/AbstractMessageParser.xml	Documents base message-parser behavior and parsing helpers.
docs/xml/ns-Org.Apache.Http.Impl.IO.xml	Adds a namespace-level summary describing the API surface.

Suppressed comments (2)

docs/xml/Org.Apache.Http.Impl.IO/ContentLengthOutputStream.xml:208

• The Write(int b) overload takes a single byte value (as an int), but the parameter docs describe a byte buffer.

        <param name="b">The buffer containing bytes to write.</param>

docs/xml/Org.Apache.Http.Impl.IO/AbstractMessageWriter.xml:348

• This type writes start lines; the parameter docs should say the message is written (not read).

        <param name="message">The HTTP message to read or write.</param>

---

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

[jonathanpeppers]

@dalexsoto review