> Please review these changes to correct the handling of leading and trailing > indented code blocks in a doc comment. > > There are two separate issues here: one for leading indented code blocks and > one for trailing indented code blocks. > > 1. Leading indented code blocks: the code to detect the first sentence of a > doc comment is modified to detect whether the comment begins with an indented > code block. If it does, the first sentence is deemed to be empty, and the > body of the doc comment begins with the code block. > 2. Trailing indented code blocks: the content of the indented code block is > marked as significant by updating `lastNonWhite`, which will cause the > content to be recorded (not dropped) if the code block is followed by EOF. > > For both cases, simple `DocTree` AST-level tests are provided, as well as > full `JavadocTester` tests, that test the end-user view of the generated docs.
Jonathan Gibbons has updated the pull request incrementally with one additional commit since the last revision: fix typo, reported in review comment ------------- Changes: - all: https://git.openjdk.org/jdk/pull/20956/files - new: https://git.openjdk.org/jdk/pull/20956/files/9942aa01..363a4e06 Webrevs: - full: https://webrevs.openjdk.org/?repo=jdk&pr=20956&range=02 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=20956&range=01-02 Stats: 1 line in 1 file changed: 0 ins; 0 del; 1 mod Patch: https://git.openjdk.org/jdk/pull/20956.diff Fetch: git fetch https://git.openjdk.org/jdk.git pull/20956/head:pull/20956 PR: https://git.openjdk.org/jdk/pull/20956