RFR: 8290834: Improve potentially confusing documentation on collection of profiling information [v6]

[Julian Waters]

On Fri, 22 Jul 2022 18:17:26 GMT, Dean Long <dlong at openjdk.org> wrote:

>> Julian Waters has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   New changes
>
> src/hotspot/share/compiler/compilationPolicy.hpp line 47:
> 
>> 45:  * for the interpreter and ciMethod::ensure_method_data, ciMethod.cpp for C1), and interacts
>> 46:  * with C1 and C2 via the compiler interface. It is updated periodically as more profiling
>> 47:  * information is gathered, directly in the case of the interpreter and through ciMethodData
> 
> This is still a bit misleading.  The information flow between MethodData and ciMethodData is one-way.  Only MethodData are updated by the interpreter or generated code.  ciMethodData is just a read-only snapshot used during compilation.

Revised

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

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