> 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

Reply via email to