RFR: 8300792: Refactor examples in java.net.http to use @snippet

Daniel Fuchs dfuchs at openjdk.org
Tue Feb 21 17:08:26 UTC 2023


On Tue, 21 Feb 2023 15:53:37 GMT, Darragh Clarke <duke at openjdk.org> wrote:

> Refactored instances of `@code` to instead use `@snippet`.
> 
> I also spent some time looking into using external snippets to reference the existing files `JavadocExamples` and `WebSocketExample` though ultimately thought it was better to keep the docs pretty much as they had been with only a few small changes to formatting.

Have you tried to `make docs`? I get compilation errors when I try...


HttpResponse.java:230: error: unexpected content
     * {@snippet :   HttpRequest request = HttpRequest.newBuilder()
...

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

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


More information about the net-dev mailing list