RFR: JDK-8242532 convert tests to use Text Blocks
Jonathan Gibbons
jonathan.gibbons at oracle.com
Fri May 1 21:13:58 UTC 2020
Please review a big, but conceptually simple, change to convert JavaDoc
tests to use text blocks where reasonable.
This is an "automated" change, albeit using a custom new utility program
written for this specific purpose. There are no manual edits to any
test files. There should be no functional change in any test file.
The conversion program scans source files looking for candidates to
convert into text blocks. Candidates are long strings containing '\n' or
'"' characters.
Some tests contain very long strings, that previously were manually
wrapped at arbitrary points in the string. The converter program wraps
these very long strings (> 240 characters) every 80 characters. The
fixed length of each "chunk" and trailing '\' helps provide a visual
distinctive block of text for the long line. Note, this algorithm
assumes there is no risk of breaking low-level Unicode sequences within
the strings in the test files.
-- Jon
JBS: https://bugs.openjdk.java.net/browse/JDK-8242532
Webrev: http://cr.openjdk.java.net/~jjg/8242532/webrev.01/
More information about the javadoc-dev
mailing list