JDK-8296420 : javac has long lines in its command-line help
  • Type: Bug
  • Component: tools
  • Sub-Component: javac
  • Priority: P3
  • Status: New
  • Resolution: Unresolved
  • Submitted: 2022-11-04
  • Updated: 2022-11-04
Description
There are some long lines in the javac command-line help.
Suggested max length is 80 characters.
For the longest lines in `javac --help`, it should be enough to insert `\n` characters.

 $ ./build/macosx-aarch64/images/jdk/bin/javac --help | bash ../../my.utils/src/bin/my.show-line-length.sh | sort --numeric -r 
 133 Provide source compatibility with the specified Java SE release. Supported releases: 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20
 133 Generate class files suitable for the specified Java SE release. Supported releases: 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20
 111 Compile for the specified Java SE release. Supported releases: 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20
  93 Enable preview language features. To be used in conjunction with either -source or --release.
  78 Specify whether or not to generate class files for implicitly referenced files
  77 Names of the annotation processors to run; bypasses default discovery process
  77 -verbose                     Output messages about what the compiler is doing
  76 -encoding <encoding>         Specify character encoding used by source files
  74 Root modules to resolve in addition to the initial modules, or all modules
  74 -s <directory>               Specify where to place generated source files
  73 -endorseddirs <dirs>         Override location of endorsed standards path
  73 -d <directory>               Specify where to place generated class files
  71 -J<flag>                     Pass <flag> directly to the runtime system


 $ ./build/macosx-aarch64/images/jdk/bin/javac --help-extra | bash ../../my.utils/src/bin/my.show-line-length.sh | sort --numeric -r
 108 Specify which file to read when both a source file and class file are found for an implicitly compiled class
  97 Fallback target module for files created by annotation processors, if none specified or inferred.
  82 to additional modules, or to all unnamed modules if <other-module> is ALL-UNNAMED.
  80 expands to all sub-packages of the given package. Each <package> can be prefixed
  75 where <group> is one of accessibility, html, missing, reference, or syntax,
  75 Enable or disable checks in specific packages. Each <package> is either the
  74 qualified name of a package or a package name prefix followed by .*, which
  74 Specify additional modules to be considered as required by a given module.
  73 Print information about which annotations a processor is asked to process
  73 -Djava.endorsed.dirs=<dirs>  Override location of endorsed standards path
  72 -Xmaxwarns <number>          Set the maximum number of warnings to print

Comments
Here's a small script to show line lengths while read line ; do printf "%4d %s\n" $(expr $(wc -c <<< "$line") - 1) "$line" done
04-11-2022