RFR: 8288493: Document JDK specific system properties in jdk.httpserver [v5]

[Daniel Fuchs]

On Thu, 20 Oct 2022 12:17:35 GMT, Michael McMahon <michaelm at openjdk.org> wrote:

>> No. That property should probably be deprecated since there is a more modern (ServiceLoader based) alternative implemented. But you could refer to the `@uses com.sun.net.httpserver.spi.HttpServerProvider` service.
>
> I don't mind leaving it out for now. It's of less general interest than the others, but is documented in the SPI apidocs.

Good point. But if we wanted to document this property here, I think it would deserve a separate paragraph, before we start talking about properties, that talks about the SPI and explain how to provide an implementation - where the canonical way (providing an implementation of the provider that the ServiceLoader loads) would be documented first. As you say, that property is already documented in the SPI, and it's probably better to only document it at the place where we explain  how the SPI is loaded.

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

PR: https://git.openjdk.org/jdk/pull/10766