fix: Support java-17 version of the javadoc for doc generator

[lanseg]

Breaks backwards compatibility because of the HTML differences in javadoc generated by java-11 and java-17.

[sebr72]

Please add test to ensure the generated javadoc is similar in Java 17 to java 11.

[lanseg]

Code to compare java-11 docs and java-17 docs.

rm -rf compare
mkdir -p compare/imgs

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64/
git checkout java-17
../gradlew clean
../gradlew :docs:buildDocs
cp -rfv build/site compare/site-17

export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64/
git checkout master
../gradlew clean
../gradlew :docs:buildDocs
cp -rfv build/site compare/site-11

for i in `find compare/site-17 -iname '*html' | grep -v javadoc`
do
    google-chrome --headless --screenshot="`pwd`/compare/imgs/`basename $i`-17.png" --window-size=1920,5000 $i
done

for i in `find compare/site-11 -iname '*html' | grep -v javadoc`
do
    google-chrome --headless --screenshot="`pwd`/compare/imgs/`basename $i`-11.png" --window-size=1920,5000 $i
done

for i in `find compare/imgs | grep -o ^.*html | sort | uniq`
do
    PSNR=`compare -metric PSNR -compose src $i-11.png $i-17.png $i-diff.png 2>&1`
    printf "DIFF %8s %25s %25s\n" $PSNR "$i-11.png" "$i-17.png"
done | tee compare/result.txt