On Fri, 7 Jul 2023 17:41:02 GMT, Brian Burkhalter <b...@openjdk.org> wrote:

>> src/java.base/share/classes/java/io/DataOutputStream.java line 44:
>> 
>>> 42:  * the underlying output stream, hence there is no guarantee as to
>>> 43:  * the details of how the bytes are written.
>>> 44:  *
>> 
>> I'd drop "merely".
>> 
>> I would not want to give any assurances about whether the bytes of an 
>> encoded primitive were written individually or as a group.  
>> For the primitive types the value is encoded and written as one or more 
>> bytes to the underlying stream.
>
>> I would not want to give any assurances about whether the bytes of an 
>> encoded primitive were written individually or as a group.
> 
> Would it be helpful to add further verbiage?
> 
> For example, the sequence of bytes comprising the primitive data type may be 
> written as more than one packet of bytes.

"packet" is network centric terminology.
Perhaps something like:  "may be written individually or in any grouping of 
bytes"

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

PR Review Comment: https://git.openjdk.org/jdk/pull/14791#discussion_r1256254810

Reply via email to