Bean reference documentation fails to build with JavaSyntaxError

[ato]

Unfortunately the Python javalang parser only supports Java 8 and so is failing on some of the newer syntax. Perhaps we could switch to using a doclet to extract the API documentation.

Error parsing ../engine/src/main/java/org/archive/crawler/util/BdbUriUniqFilter.java JavaSyntaxError('')
Error parsing ../engine/src/main/java/org/archive/crawler/reporting/CrawlerLoggerModule.java JavaSyntaxError('')
Error parsing ../modules/src/main/java/org/archive/modules/fetcher/FetchDNS.java JavaSyntaxError('')
Error parsing ../modules/src/main/java/org/archive/modules/fetcher/FetchHTTP2.java JavaSyntaxError('')
Error parsing ../modules/src/main/java/org/archive/modules/writer/WARCWriterChainProcessor.java JavaSyntaxError('')
reading sources... [ 42%] configuring-jobs
/home/docs/checkouts/readthedocs.org/user_builds/heritrix/checkouts/latest/docs/configuring-jobs.rst:97: WARNING: Inline emphasis start-string without end-string.

...

Exception occurred:
  File "/home/docs/checkouts/readthedocs.org/user_builds/heritrix/envs/latest/lib/python3.12/site-packages/javalang/parser.py", line 118, in illegal
    raise JavaSyntaxError(description, at)
javalang.parser.JavaSyntaxError