The attached patch partially fixes bug 652303.
It fixes it for @see tags. However, it doesn't fix it
for @link and @linkplain tags, although the test case
has been implemented for those, too.
The patch makes some important changes in the javadoc
parsing code from the javadoc checks. Maybe some of
this code should be (a) moved to a better place and (b)
extended to be able to parse @link tags.