RFR: 8294689: The SA transported_core.html file needs quite a bit of work

[Kevin Walls]

On Fri, 30 Sep 2022 23:30:41 GMT, Chris Plummer <cjplummer at openjdk.org> wrote:

> The main issues I set out to address are:
> 
> - legacy Solaris references can be removed
> - add help with dealing with Windows core files, most of important of which is use of PATH to find the dlls referenced by the core file.
> - add help with dealing with macOS core files, most of important of which is using JAVA_HOME or DYLD_LIBRARY_PATH to find the dlls referenced by the core file. 
> 
> However, in the end it turned out to be a pretty substantial restructuring and rewrite.
> 
> Here are links to the rendered new and old copies of the file:
> [new file](https://htmlpreview.github.io/?https://github.com/openjdk/jdk/blob/6778a202a855a534754c4b47a6cd99cb912869d3/src/jdk.hotspot.agent/doc/transported_core.html)
> [old file](https://htmlpreview.github.io/?https://github.com/openjdk/jdk/blob/master/src/jdk.hotspot.agent/doc/transported_core.html)

Looks good.  I just looked at SA_ALTROOT and see you can use it not only as a prefix, i.e. the name of a directory which contains a directory structure the same as the original machine.  But you can also use it as a directory which contains the files themselves, without directories.
So both ways you could possibly interpret the text will work.

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

Marked as reviewed by kevinw (Committer).

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