RFR: 8347348: Clarify that the HTTP server in jdk.httpserver module is not a full featured server [v3]

[Michael McMahon]

On Tue, 11 Feb 2025 12:00:34 GMT, Jaikiran Pai <jpai at openjdk.org> wrote:

>> Can I please get a review of this doc-only change which clarifies the purpose of the HTTP server that's provided in the JDK's `jdk.httpserver` module? This should help avoid any confusion on the purpose of the server.
>
> Jaikiran Pai has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains four additional commits since the last revision:
> 
>  - split the doc into "@apiNote" and "@implNote"
>  - merge latest from master branch
>  - Brian's inputs
>  - 8347348: Clarify that the HTTP server in jdk.httpserver module is not a full featured server

I think the wording reflects the right intent with respect to the SPI and the default implementation.

-------------

Marked as reviewed by michaelm (Reviewer).

PR Review: https://git.openjdk.org/jdk/pull/23004#pullrequestreview-2640330443