RFR: 8335880: More troubleshooting tips around windows space in path [v3]

[Magnus Ihse Bursie]

On Tue, 16 Jul 2024 23:20:03 GMT, Chen Liang <liach at openjdk.org> wrote:

>> Context: https://mail.openjdk.org/pipermail/build-dev/2024-July/045586.html
>> 
>> People were confused on a few details around fixing windows space names, including:
>> 1. setshortname can report confusing error message when the directory is in use
>> 2. Many directories can have names set but only Microsoft Visual Studio and Windows Kits need them
>> 
>> Also adds some notes about `jdk` being the exploded image while `images/jdk` is the actual image.
>
> Chen Liang has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Update html

doc/building.md line 1816:

> 1814: The only directories required to have short paths are `Microsoft Visual Studio`
> 1815: and `Windows Kits`; the rest of the "contains space" warnings from `configure`
> 1816: can be ignored. You can choose any short name; once it is set, `configure`'s

What other directories are reported from configure? 

It does not seem correct to me to say that they can just be ignored -- either the directory is relevant for compilation, and then we need to have it without spaces, or it is not really used and then it should be removed, or made optional.

If  `Microsoft Visual Studio` and  `Windows Kits` are typical path-with-spaces that users can run into, we should perhaps add an additional check to configure for these. In fact, I think what we *should* do is to have configure print this help about `fsutil file setshortname` if it encounters a path with spaces that it cannot turn into a short name. That way, a complete copy/pastable command line can be generated for the user to run.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/20197#discussion_r1704063427