java man page - incorrect delimeter between multiple classpath entries
Bug #2039295 reported by
Pierre C. Dussault
This bug affects 1 person
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
openjdk-17 (Ubuntu) |
New
|
Undecided
|
Unassigned |
Bug Description
In the man page, the -cp or --classpath option specifies the use of semi-colons (;) as separator for multiple enteries for the class path. This is incorrect for Linux and Unix platforms which use the colon (:) as a delimeter for class path entries.
Oddly, the man page description later gives an example that correctly uses the colon (and not the semi-colon)
...
For example, if the directory mydir contains
a.jar and b.JAR, then the class path element mydir/* is expanded to A.jar:b.JAR
...
The initial description should accurately describe the separator as a colon (:) and not a semi-colon (;)
summary: |
- java man page - incorrect delimeter between multiple entries + java man page - incorrect delimeter between multiple classpath entries |
To post a comment you must log in.
The man page seems to be a copy of the one provided by Oracle with no seemingly apparent modifications.
I don't know if the team will want the man page to stay generic.
Users will have to refer to this notice and adapt appropriately when searching through the man page: /a:directories| zip|JAR- files
...
-Xbootclasspath
Specifies a list of directories, JAR files, and ZIP archives to append to the end of the default bootstrap class path.
Linux and macOS: Colons (:) separate entities in this list.
Windows: Semicolons (;) separate entities in this list.
...
The user needs to "guess correctly" that this same alternate convention is to be used for all options in Linux. However, this isn't explicitly said to apply to all options. It has to be guessed