Unclear docs regarding escaping of Windows paths.

Thorsten Schöning tschoening at am-soft.de
Mon Jan 7 11:46:33 UTC 2019


Guten Tag Jonathan Gibbons,
am Freitag, 4. Januar 2019 um 00:19 schrieben Sie:

> The change that you noted in the URIs is just a side-effect of internal
> changes in the way that the documentation was generated. We removed the
> documentation for the old implementation from 9, and it is a bug that we
> did not get to update it with a reference to the new syntax, as 
> described for the Java launcher in [1].

Do you take care of creating a bug adding such a reference? [1] make
some points a lot more clear and is actually what I hoped to find. So
thanks for that.

> Please also note that the handling of command-line arguments is 
> different from the handling of the contents of argument files.[...]

My link is explicitly mentioning argument files:

> Examples
> Single Argument File[...]
> Two Argument Files

https://docs.oracle.com/en/java/javase/11/javadoc/javadoc-command.html#GUID-EFE927BC-DB00-4876-808C-ED23E1AAEF7D

And the example for Windows contains the following:

> -overview \java\jdk9\docs\api\overview-summary.html
> -sourcepath \java\

Which uses unescaped backslashs and should be a bug as per your linked
[1]. Am I wrong or do you take care of that as well or should I add
some bug somewhere or ...?

Mit freundlichen Grüßen,

Thorsten Schöning

-- 
Thorsten Schöning       E-Mail: Thorsten.Schoening at AM-SoFT.de
AM-SoFT IT-Systeme      http://www.AM-SoFT.de/

Telefon...........05151-  9468- 55
Fax...............05151-  9468- 88
Mobil..............0178-8 9468- 04

AM-SoFT GmbH IT-Systeme, Brandenburger Str. 7c, 31789 Hameln
AG Hannover HRB 207 694 - Geschäftsführer: Andreas Muchow



More information about the javadoc-dev mailing list