RFR: 8350007: Add usage message to the javadoc executable [v3]

Nizar Benalla nbenalla at openjdk.org
Thu Feb 20 16:25:33 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 four additional commits since the last revision:

 - 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/4572fe9a..3d83cbd5

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=23618&range=02
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=23618&range=01-02

  Stats: 8289 lines in 319 files changed: 5499 ins; 1706 del; 1084 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