On Wed, 16 Oct 2024 17:38:17 GMT, Eirik Bjørsnøs <[email protected]> wrote:
> The file separator is a secondary concern and could be moved to the end of
> the sentence:
>
> ```
> Where key java options include:
> --class-path <class path>
> a list of directories and JAR archives to search for class files,
> separated by ":"
> --module-path <module path>
> a list of directories and JAR archives to search for modules, separated
> by ":"
> ```
I agree with this comment. I also have another observation - it is not super
obvious that "a list of directiories ..." is a description for what a <class
path> or <module path> is. You kind of guess that being the case (what else can
it be?) but something like:
--class-path <class path>
where <class path> is a list of directories and JAR archives to search
for class files, separated by ":"
Seems more crystal clear?
(Btw, the reason I like moving `:` at the end is that you want users to quickly
graps what <class path> is - and this trick does that: "a class path is a list
of directories and jars" - whether they're `:` or `#!?` separated, that's a
second-order concern at this point (as we're still defining the term).
-------------
PR Comment: https://git.openjdk.org/jdk/pull/21411#issuecomment-2437510741
