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