javadoc Method Summary

I have the following javadoc code:

/**

* Calculates the exact value of the skewness which is defined by

*

* <pre>

*1 - 2 * p

* --

* _

*\/ n * p * (1 - p) </pre>

*/

In the Method Detail section this code looks very nice, but in the Method Summary every line wrappings has been removed and the code looks like:

// Calculates the exact value of the skewness which is defined by 1 - 2 * p -- _\/ n * p * (1 - p)

How can I enable the line wrappings in the Method Summary or how can I remove the Method Summary by default?

[672 byte] By [Ryidena] at [2007-10-2 7:57:39]
# 1
Add some tags.
aniseeda at 2007-7-16 21:48:13 > top of Java-index,Developer Tools,Java Compiler...
# 2
Seems to be OK, but how can I set up the spaces of the numerator? By adding one million times? Where is the purpose of the <pre> tag when I have done it?
Ryidena at 2007-7-16 21:48:13 > top of Java-index,Developer Tools,Java Compiler...
# 3
Seems to be OK, but how can I set up the spaces of the numerator? By adding nbsp one million times? Where is the purpose of the <pre> tag when I have done it?
Ryidena at 2007-7-16 21:48:13 > top of Java-index,Developer Tools,Java Compiler...
# 4

[nobr]I have changed the javadoc code to the version with br tags and nbsp's. Now the HTML of the method summary and method detail looks like the pre tag version in the method detail, but the javadoc code is horrible.

/**

* Calculates the exact value of the skewness which is defined by<br>

* <br>

* &nbsp &nbsp &nbsp &nbsp 1 - 2 * p<br>

* --<br>

* &nbsp_&nbsp <br>

* &nbsp &nbsp\/ n * p * (1 - p)

*/

(The nbsp's are without the ';' characters at the end, because this forum is going to encode the nbsp's into whitespaces)

This horrible javadoc code is only necessary, because the javadoc commmand ignores pre tags in the method summary.

From my opinion there should be done some improvements in the javadoc program.[/nobr]

Ryidena at 2007-7-16 21:48:13 > top of Java-index,Developer Tools,Java Compiler...
# 5
Is there any other solution for the problem for javadoc pre tags in the method summary?
Ryidena at 2007-7-16 21:48:13 > top of Java-index,Developer Tools,Java Compiler...
# 6
I would leave the definition of the formula as you originally had it in a <pre> block but put it into the second sentence so it doesn't form part of the summary at all.
ejpa at 2007-7-16 21:48:13 > top of Java-index,Developer Tools,Java Compiler...