RFR: 8324573: HashMap::putAll add notes for conservative resizing [v7]

[Volker Simonis]

On Thu, 4 Apr 2024 22:18:16 GMT, Joshua Cao <duke at openjdk.org> wrote:

> I tried looking at the docs with `make docs-image`, but I can't test that the syntax/links are actually correct because `@implNote` does not actually show up in the web pages. As I understand from [the original proposal](https://mail.openjdk.org/pipermail/lambda-libs-spec-experts/2013-January/001211.html), `@implNote` is there to help to developer understand implementation, and is not intended to be exposed in the web docs.
> 
> This seems like information that would be useful to the consumer. So maybe we can consider moving this into the main comment block?

@caojoshua the `@implNote` should definitely appear in the public API documentation, if not something is wrong. See for example: https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Collections.html#method-detail

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

PR Comment: https://git.openjdk.org/jdk/pull/17544#issuecomment-2040160049