8131664: Javadoc for PrintStream is now incorrect
Brian Burkhalter
brian.burkhalter at oracle.com
Mon Jul 15 20:55:53 UTC 2019
Hi Lance,
> On Jul 15, 2019, at 1:33 PM, Lance Andersen <lance.andersen at oracle.com> wrote:
>
> Is there an existing CSR or are you waiting for the review to complete here?
The latter.
> Overall, I think it is OK.
>
> The existing autoflush wording looks like it could use some wordsmithing at some point (as I know we do this a little differently in some of the APIs )
>
> - “A boolean” not sure we need to state this as it is obvious from the declaration.
It looks like here one could change "A boolean; if true,” to simply “Whether”.
> - Some places in the JDK, we say True if XXXX; false otherwise. I am not sure how many APIs after the really early ones start with “if true…”
>
> Anyways, something to consider for a future todo list I guess :-)
Might be worth doing. I’ll after any other comments come in.
Thanks,
Brian
More information about the core-libs-dev
mailing list