Document Apache HTTP SSL APIs

[jonathanpeppers]

Summary

• Documented source-backed APIs in Org.Apache.Http.Conn.Ssl.
• Corrected Apache HttpComponents attribution to the Apache Software Foundation and Apache License 2.0.
• Left generated *Async binding wrappers undocumented because no authoritative Android or published binding source describes their behavior.

Refs #304

Sources

• Android API reference: org.apache.http.conn.ssl
• Android 4.4.4 Apache HttpComponents SSL source
• Apache License, Version 2.0

Validation

• Parsed all six changed XML files.
• Confirmed CRLF line endings are preserved.
• Ran git diff --check.
• Confirmed the diff is limited to docs/xml/Org.Apache.Http.Conn.Ssl.
• Scoped To be added count: 73 before, 16 after; the remaining placeholders are the unsupported generated *Async wrappers.

[Copilot]

Pull request overview

Updates the generated XML documentation for the Org.Apache.Http.Conn.Ssl namespace to replace placeholder docs with source-backed descriptions and to align attribution with Apache HttpComponents / Apache License 2.0.

Changes:

• Replaced To be added placeholders with summaries/params/returns for key SSL/hostname-verification APIs.
• Updated attribution text to reference the Apache Software Foundation and Apache License 2.0.
• Added brief documentation for several binding infrastructure members (e.g., JniPeerMembers).

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
docs/xml/Org.Apache.Http.Conn.Ssl/StrictHostnameVerifier.xml	Fills in missing member documentation and updates attribution text.
docs/xml/Org.Apache.Http.Conn.Ssl/SSLSocketFactory.xml	Documents constructor parameters/returns, updates attribution text.
docs/xml/Org.Apache.Http.Conn.Ssl/IX509HostnameVerifier.xml	Adds missing parameter/return documentation and updates attribution text.
docs/xml/Org.Apache.Http.Conn.Ssl/BrowserCompatHostnameVerifier.xml	Adds missing method/return documentation and updates attribution text.
docs/xml/Org.Apache.Http.Conn.Ssl/AllowAllHostnameVerifier.xml	Adds missing method/return documentation and updates attribution text.
docs/xml/Org.Apache.Http.Conn.Ssl/AbstractVerifier.xml	Adds missing helper/method documentation and updates attribution text.

---

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

[jonathanpeppers]

@dalexsoto review

[dalexsoto]

ConnectSocketAsync is newly documented as returning an unconnected SSL socket, but it wraps ConnectSocket, which connects and verifies the socket before returning it. This also contradicts the accepted scope of leaving generated *Async wrappers undocumented. Please restore this wrapper's return documentation to To be added.

[jonathanpeppers]

Addressed the requested change in 6bf9e33: restored \ConnectSocketAsync's generated <returns>To be added.\ documentation without changing the documented synchronous API scope. The six changed XML files pass XML/ECMA structure validation, CRLF validation, and \git diff --check.

[dalexsoto]

The SSL contracts now match the Apache implementation, and the generated async-wrapper scope is consistently preserved.