RFE for doclint

[sergey malenkov]

Sorry, but Thunderbird removed leading spaces in the second case. I meant
_ _ _ _ <pre>
_ _ _ _ first line
_ _ _ _ second line
_ _ _ _ </pre>
where the _ is a space character.

SAM

On 29.10.2013 13:15, sergey malenkov wrote:
> 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
>>
>>
>