cloud-fan commented on PR #55605:
URL: https://github.com/apache/spark/pull/55605#issuecomment-4346466089
### End-to-end test result
Validated on earlier branch commit `a2bbe807909` with three deliberately
broken `{@link}` references planted across one Java source and one Scala source
(later reverted). The Documentation generation CI job ran and produced this log:
**Doc gen status: FAILURE** ✅ (broken refs are fatal)
**Per-file diagnostics — all 4 visible:**
```
[warn] /__w/spark/spark/core/target/java/org/apache/spark/Partition.java:3:
error: reference not found
[warn] /__w/spark/spark/core/target/java/org/apache/spark/Partition.java:5:
error: reference not found
[warn]
/__w/spark/spark/sql/catalyst/src/main/java/org/apache/spark/sql/vectorized/ColumnarMap.java:26:
error: reference not found
[warn]
/__w/spark/spark/sql/catalyst/src/main/java/org/apache/spark/sql/vectorized/ColumnarMap.java:27:
error: reference not found
```
The Scala plant `[[Partition.index]]` (with the wrong `.` separator) was
correctly translated by genjavadoc into a stub `{@link Partition.index}`, and
javadoc surfaced the resolution failure on the stub path
`core/target/java/org/apache/spark/Partition.java` — exactly the failure mode
#55581's AGENTS.md note documents.
**Log composition:**
| Pattern | Count |
| --- | ---: |
| Total lines | **3,977** |
| `Loading source file` | 1 (a wrapped `Unexpected javac output: Loading
source file ...` from sbt — different prefix, unfilterable) |
| `[parsing started]` / `[parsing completed]` | 0 |
| `[loading X.class]` | 0 |
| `Generating *.html` | 0 |
| `no comment` / `no @param` / `no @return` / `no @throws` | 0 each |
| Final summary | `4 errors / 2,408 warnings.` (default 100 cap on warning
printing) |
**Reduction journey:**
| State | Log lines | Vs baseline |
| --- | ---: | ---: |
| #55581's full flag set (`-Xmaxerrs 999999 -Xmaxwarns 999999 -verbose`) |
77K | baseline |
| + `-Xdoclint:all -Xdoclint:-missing` | 22K | -71% |
| + drop `-Xmaxwarns 999999` | 18K | -77% |
| + post-filter `-verbose` progress lines | **3,977** | **-95%** |
The current CI run on this PR's clean state (no plants) is expected to pass.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
