On Mon, 7 Jul 2025 08:31:10 GMT, Daniel Fuchs <dfu...@openjdk.org> wrote:
>> src/java.net.http/share/classes/java/net/http/HttpRequest.java line 739: >> >>> 737: * @param channel a file channel >>> 738: * @param offset the offset of the first byte >>> 739: * @param length the number of bytes to use >> >> I'd suggest to say something like: >>> the number of bytes to send >> >> or >>> the number of bytes to read from the file channel > > It might be also useful to specify what happens if length is zero or > negative. Either here or in the `@throws` below if an exception is going to > be thrown. 1. Improved the wording as suggested in 0eda56f18a2 2. There is already a `@throws IndexOutOfBoundsException` warning against invalid bounds specification ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/26155#discussion_r2189486769