Fails when a fenced code block in a docs page has a line that starts with an HTML anchor (<a href=...>). That is what a Javadoc-style link looks like when it leaks into a code sample, for example <a href="...">@Request</a> above an annotated interface.
pages/.build-docs.py runs it in its Links stage.check-java-fences.py instead.python3 scripts/check-code-fences.py python3 scripts/check-code-fences.py --docs-root ~/git/apache/juneau-docs
| Option | Argument | Default | Meaning |
|---|---|---|---|
--docs-root | directory | parent of the scripts/ folder | The docs checkout whose pages/ tree (plus the *.mdx pages in src/pages/about/) is scanned. |
*.md under pages/, plus every *.mdx under src/pages/about/, and extracts its fenced blocks (backtick or tilde fences, indented or inside admonitions) with code_fences.iter_fences.<a ... href=.file:line: HTML anchor in code fence: <line> for each hit.Stdout only. Nothing is written.
| Code | Meaning |
|---|---|
| 0 | No such anchors found. |
| 1 | At least one anchor found. |
a are legitimate and ignored.check-java-fences.py, code_fences.py, build-docs.py