RFE for doclint

[sergey malenkov]

There is 2 cases: NO empty line and ONE empty line.
User agents have traditionally rendered paragraphs with white space 
before and after:
http://www.w3.org/TR/html401/struct/text.html#h-9.3.5

The reason of is the location of </pre>.
http://www.w3.org/TR/html401/struct/text.html#h-9.3.4

Seems it is a bug in the javadoc tool.  It generates non-empty line
if the closing tag is located on the new line in javadoc.

The following code is rendered OK:
<pre>one line</pre>

The following code is rendered OK:
<pre>
first line
second line
</pre>

The following code adds additional line:
<pre>
first line
second line
</pre>

Thanks,
SAM

On 29.10.2013 12:36, Sergey Bylokhov wrote:
> On 28.10.2013 23:13, Jonathan Gibbons wrote:
>> On 10/28/2013 10:56 AM, Sergey Bylokhov wrote:
>>> Hello.
>>> I have a question about additional feature in doclint:
>>>  - Do we have a plan to deprecate @exception? Probably doclint can 
>>> highlight it?
>>>  - In our documentation we have inconsistent code for code snippets. 
>>> Sometimes we have two empty lines after the code[1], or one line[2] 
>>> or both cases[3]. It depend how <pre> tag is closed, but is it 
>>> possible to highlight this by the doclint to unify them? Do we have 
>>> a good example how it should look?
>>>
>>> [1] http://docs.oracle.com/javase/6/docs/api/java/lang/String.html
>>> [2] 
>>> http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html#clone%28%29
>>> [3] http://docs.oracle.com/javase/6/docs/api/java/lang/Comparable.html
>>>
>>
>> There are no plans to deprecate @exception at this point, but I think 
>> it would be an excellent task for someone to run find/grep over the 
>> repos to find and cleanup inconsistent use of @throws and @exception
>>
>> Currently, doclint is primarily focussed on reporting issues that 
>> give rise to issues in the generated HTML, such as those reported by 
>> the standard "tidy" program.I note all your examples are for Java 6. 
>> Do you have any examples of bad output in the latest JDK 8 docs?
> Same things in jdk 8.
> Two lines after the code:
>     http://download.java.net/jdk8/docs/api/java/lang/String.html
> One line:
> http://download.java.net/jdk8/docs/api/java/lang/Object.html#clone--
> Both:
> http://download.java.net/jdk8/docs/api/java/lang/Comparable.html
>>
>> -- Jon
>
>