Summary: | [formatter] <code> tag should not be considered as immutable | ||
---|---|---|---|
Product: | [Eclipse Project] JDT | Reporter: | Frederic Fusier <frederic_fusier> |
Component: | Core | Assignee: | JDT-Core-Inbox <jdt-core-inbox> |
Status: | CLOSED WONTFIX | QA Contact: | |
Severity: | normal | ||
Priority: | P5 | CC: | daniel_megert, Olivier_Thomann |
Version: | 3.4 | ||
Target Milestone: | --- | ||
Hardware: | PC | ||
OS: | Windows XP | ||
Whiteboard: | stalebug |
Description
Frederic Fusier
2008-04-30 05:19:47 EDT
Note that the new comments formatter behaves differently than 3.3 when <pre> section is written inside a <code> section. Although the 3.3 comments formatter considers <code> section as immutable it formats the text contains in the <pre> section. As an example of this difference, the following test case using Eclipse built-in + 'Maximum line width for comments' = 40: public class X01 { /** * <code><pre>public class X {}</pre></code> */ void foo() { } } is formatted in 3.3 as: public class X01 { /** * <code><pre> * public class X { * } * </pre></code> */ void foo() { } } and is unchanged in 3.4RC1 considering that <code> is an immutable section, hence does not format anything between the <code>...</code> tags. Note also that following test case: public class X02 { /** * Example of 'code' tag nested inside 'pre' tag: * <pre><code>public class X {}</code></pre> */ void foo() { } } is formatted as follow by the 3.4 formatter: public class X02 { /** * Example of 'code' tag nested * inside 'pre' tag: * * <pre> * <code>public class X {}</code> * </pre> */ void foo() { } } This seems to be wrong as: 1) the 3.3 formats it as: public class X02 { /** * Example of 'code' tag nested * inside 'pre' tag: * * <pre><code> * public class X { * } * </code></pre> */ void foo() { } } 2) Is generated by the javadoc tool as if there will be only a 'pre' tag In fact, as the <code> tag is not considered as immutable by the javadoc tool, in as soon as a 'pre' tag is present, it obfuscates the 'code' tag if there's one before or after it... This bug hasn't had any activity in quite some time. Maybe the problem got resolved, was a duplicate of something else, or became less pressing for some reason - or maybe it's still relevant but just hasn't been looked at yet. If you have further information on the current state of the bug, please add it. The information can be, for example, that the problem still occurs, that you still want the feature, that more information is needed, or that the bug is (for whatever reason) no longer relevant. -- The automated Eclipse Genie. |