On Mon, 26 Aug 2024 12:01:42 GMT, Nizar Benalla <nbena...@openjdk.org> wrote:
>> Could I please get a review for this small clenup? I updated the `--help` >> command output to match that of `man javadoc`. >> >> I also noticed that `--help-extended` was renamed to `--help-extra` at some >> point but doc-comment was not changed, so I changed it. >> I could create a separate issue for it if needed, just to keep a record of >> it. >> >> The new `javadoc --help` output is the following >> >> >> javadoc --help >> Usage: >> javadoc [options] [packagenames] [sourcefiles] [@files] >> where options include: >> @<file> Read options and filenames from file >> --add-modules <module>(,<module>)* >> Root modules to resolve in addition to the initial modules, >> or all modules on the module path if <module> is >> ALL-MODULE-PATH. >> -bootclasspath <path> >> Override location of platform class files used for >> non-modular >> releases >> -breakiterator >> Compute first sentence with BreakIterator >> --class-path <path>, -classpath <path>, -cp <path> >> Specify where to find user class files >> -doclet <class> >> Generate output via alternate doclet >> -docletpath <path> >> Specify where to find doclet class files >> --enable-preview >> Enable preview language features. To be used in >> conjunction with >> either -source or --release. >> -encoding <name> >> Source file encoding name >> -exclude <pkglist> >> Specify a list of packages to exclude >> --expand-requires (transitive|all) >> Instructs the tool to expand the set of modules to be >> documented. By default, only the modules given explicitly >> on >> the command line will be documented. A value of >> "transitive" >> will additionally include all "requires transitive" >> dependencies of those modules. A value of "all" will >> include >> all dependencies of those modules. >> -extdirs <dirlist> >> Override location of installed extensions >> --help, -help, -?, -h >> Display command-line options and exit >> --help-extra, -X >> Print a synopsis of nonstandard options and exit >> -J<flag> Pass <flag> directly to the runtime system >> --limit-modules <module>(,<module>)* >> Limit the u... > > 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 five additional > commits since the last revision: > > - Merge remote-tracking branch 'upstream/master' into javadoc-help > - change back "Doclet" to "doclet" > - - replace backticks with single quotes > - drop use of underscores > - capitalize first letter for "doclet" > - Merge remote-tracking branch 'upstream/master' into javadoc-help > - improve javadoc help output > > small clenup, --help-extended was renamed to --help-extra at some point > but doc-comment was not changed Thank you for the reviews. I did notice that some options had short but more informative descriptions in the man page vs the --help option. ------------- PR Comment: https://git.openjdk.org/jdk/pull/20618#issuecomment-2314844550