<p>I'm using Eclipse 3.4 and have configured the Java code formatter with all of the options on the <em>Comments</em> tab enabled. The problem is that when I format a document comment that contains:</p>

<pre><code>* @see &lt;a href="test.html"&gt;test&lt;/a&gt;
</code></pre>

<p>the code formatter inserts a space in the closing HTML, breaking it:</p>

<pre><code>* @see &lt;a href="test.html"&gt;test&lt; /a&gt;
</code></pre>

<p>Why? How do I stop this happening?</p>

<p>This is not fixed by disabling any of the options on the <em>Comments</em> tab, such as <em>Format HTML tags</em>. The only work-around I found is to disable Javadoc formatting completely by disabling both the <em>Enable Javadoc comment formatting</em> and <em>Enable block comment formatting</em> options, which means I then have to format comment blocks manually.</p>

[{'answer_id': 45550, 'author': 'Bart Schuller', 'author_id': 4711, 'author_profile': 'https://Stackoverflow.com/users/4711', 'pm_score': 3, 'selected': True, 'text': '<p>I can only assume it\'s a bug in Eclipse. It only happens with <em>@see</em> tags, it happens also for all 3 builtin code formatter settings.</p>\n\n<p>There are some interesting bugs reported already in the neighbourhood, but I couldn\'t find this specific one. See for example a search for <em>@see</em> in the <a href="https://bugs.eclipse.org/bugs/buglist.cgi?query_format=specific&amp;order=relevance+desc&amp;bug_status=__all__&amp;product=JDT&amp;content=%40see" rel="nofollow noreferrer">Eclipse Bugzilla</a>.</p>\n'}, {'answer_id': 45574, 'author': 'Ishmaeel', 'author_id': 227, 'author_profile': 'https://Stackoverflow.com/users/227', 'pm_score': 1, 'selected': False, 'text': '<p>Strict XML specifications require that the self closing tags should have a space before the closing slash like so:</p>\n\n<pre><code>&lt;gcServer enabled="true" /&gt; &lt;!-- note the space just after "true" --&gt;\n</code></pre>\n\n<p>I can only assume, like Bart said, that there is a bug in Eclipse\'s reformatter that thinks the closing tag is actually a self-closing tag. Another idea: Can you verify that your <strong>a</strong> tags are balanced (i.e. no unclosed tags higher up in the document)?</p>\n'}, {'answer_id': 76196, 'author': 'flicken', 'author_id': 12880, 'author_profile': 'https://Stackoverflow.com/users/12880', 'pm_score': 1, 'selected': False, 'text': "<p>This could be a bug in Eclipse 3.4.  I'm using 3.3 (M20080221-1800), and do not observe this behavior. </p>\n"}]
['https://Stackoverflow.com/questions/45414', 'https://Stackoverflow.com', 'https://Stackoverflow.com/users/2670/']