java man page - incorrect delimeter between multiple classpath entries

Bug #2039295 reported by Pierre C. Dussault
6
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
Revision history for this message
Pierre C. Dussault (pcduss) wrote (last edit ):

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:
...
-Xbootclasspath/a:directories|zip|JAR-files

    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

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.