RFR: 8350007: Add usage message to the javadoc executable [v5]
Nizar Benalla
nbenalla at openjdk.org
Mon Mar 10 12:58:17 UTC 2025
> This patch adds a new message when you run the `javadoc` executable with any arguments.
> Currently, unlike most other tools, running `javadoc` without any arguments does not show you how to use the tool or point you to use the `--help` option, this can be improved.
>
> Before change:
>
> W $ ./javadoc
> error: No modules, packages or classes specified.
> 1 error
>
>
> After change:
>
> W $ ./javadoc
> Usage:
> javadoc [options] [packagenames] [sourcefiles] [@files]
> For additional help on usage: javadoc --help
Nizar Benalla has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains eight additional commits since the last revision:
- review feedback: improve error message
- Merge branch 'master' into javadoc-usage-message
- update test
- keep the same return value and write to STDERR
- respond to feedback
- Merge branch 'master' into javadoc-usage-message
- update test with new usage message
- improve javadoc executable message
-------------
Changes:
- all: https://git.openjdk.org/jdk/pull/23618/files
- new: https://git.openjdk.org/jdk/pull/23618/files/d67e033b..1814c4b0
Webrevs:
- full: https://webrevs.openjdk.org/?repo=jdk&pr=23618&range=04
- incr: https://webrevs.openjdk.org/?repo=jdk&pr=23618&range=03-04
Stats: 39103 lines in 1148 files changed: 17535 ins; 15983 del; 5585 mod
Patch: https://git.openjdk.org/jdk/pull/23618.diff
Fetch: git fetch https://git.openjdk.org/jdk.git pull/23618/head:pull/23618
PR: https://git.openjdk.org/jdk/pull/23618
More information about the compiler-dev
mailing list