From 20190b23272e66e24fbe433a663dab978fb6ba91 Mon Sep 17 00:00:00 2001 From: Baratali Izmailov Date: Thu, 12 May 2016 23:40:49 +0100 Subject: [PATCH] Issue #410: WritingJavadocChecks wiki-page. Link to github issue --- src/xdocs/writingjavadocchecks.xml.vm | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/src/xdocs/writingjavadocchecks.xml.vm b/src/xdocs/writingjavadocchecks.xml.vm index 11597baa6..585c143e9 100644 --- a/src/xdocs/writingjavadocchecks.xml.vm +++ b/src/xdocs/writingjavadocchecks.xml.vm @@ -75,8 +75,14 @@ public class MyClass {

- In Javadoc comment every whitespace matters, so parse tree contains whitespace nodes (WS javadoc token type). - So do CHAR javadoc token that presents single character. The only redundancy Javadoc tree has because of this is that TEXT node consists of CHAR and WS nodes which is useless, but it is implementation nuance. (In future we will try to resolve this). + In Javadoc comment every whitespace matters, so parse tree contains whitespace nodes + (WS javadoc token type). + So do CHAR javadoc token that presents single character. + The only redundancy Javadoc tree has because of this is that + TEXT node consists of + CHAR and + WS nodes which is useless, but it is implementation nuance. + (In future we will try to resolve this. See Github Issue #3170).