RFR: 8152818: Javadoc must support module options supported by javac.

[Martin Buchholz]

Below is a script that successfully processes all of the jsr166 source
files, but ignores JDK sources and so all of the {@inheritDoc} are
left blank, which is a regression.

I couldn't find any way to get javadoc to warn me if the {@inheritDoc}
snippets could not be filled in (sort of a "linker error").  You would
think -Xdoclint:all would do that.  Seems like a BUG.

#!/bin/bash
set -eu
JDKSRC=/home/martin/ws/jdk9-dev
JDK=$JDKSRC/build/linux-x86_64-normal-server-release/images/jdk
DIR=bug1
rm -rf $DIR
cvs -Q -d ':pserver:anonymous:@gee.cs.oswego.edu/home/jsr166/jsr166'
checkout -d $DIR jsr166/src/main
cd $DIR

find -name '*.java' |
xargs perl -0777 -pi -e 's~sun\.(reflect|misc)~jdk.internal.$1~g'

exec $JDK/bin/javadoc \
  -d docs \
  -Xdoclint:all \
  -Xmodule:java.base \
  -Xdocrootparent http://docs.oracle.com/javase/9/docs \
  -tag 'jls:a:See <cite> The Java™ Language Specification</cite>:' \
  -tag 'implSpec:a:Implementation Requirements:' \
  -tag 'implNote:a:Implementation Note:' \
  $(find java -name '*.java')