<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>

I can only assume it's a bug in Eclipse. It only happens with
@see
tags, it happens also for all 3 builtin code formatter settings.
There are some interesting bugs reported already in the neighbourhood, but I couldn't find this specific one. See for example a search for
@see
in the
Eclipse Bugzilla
.