Use Advanced Search to search the entire archive.
[jsr363-experts] Re: Javadoc formatting
- From: Werner Keil <
>
- To: "
" <
>
- Subject: [jsr363-experts] Re: Javadoc formatting
- Date: Wed, 17 Dec 2014 13:16:03 +0100
As we manually change these on a case by case basis (when updating a class)
we can also apply either of them.
On Wed, Dec 17, 2014 at 1:01 PM, Martin Desruisseaux <
>
wrote:
>
>
Le 17/12/14 19:11, Werner Keil a écrit :
>
> I changed [code] to <code> that's an official part of JavaDoc, why
>
> should we use <pre>?
>
The difference between <code> and <pre> is that the later put the code
>
in a block with new lines preserved, while the former put everything on
>
a single line in flow with the current text. Both are legitimate but
>
used for different purpose. In the particular case of [code], since they
>
were used for code example spanning many lines, <pre> seems closer to
>
the intend.
>
>
Martin
>
>