Taglets without content at end of JavaDoc comment
-------------------------------------------------
Key: QDOX-200
URL: http://jira.codehaus.org/browse/QDOX-200
Project: QDox
Issue Type: Bug
Components: Parser
Affects Versions: 1.10.1
Reporter: Sam Bernet
Priority: Minor
On parsing a Source-File with any JavaDoc containing a Taglet without content
before the closing comment QDox will throw a parser error {noformat}syntax
error @[x, y]{noformat}
This has been verified with JavaDoc comments on class, field and method level.
Example code:
{code}
/**
* Example Code QDox 1.10.1 can not parse
* @anytaglet*/
public class TestQDoxBug {
/** @anytaglet*/
int a;
/** @anytaglet*/
void m() { /* void */ }
}
{code}
A few things to note:
- I'm perfectly aware this is very bad style (especially when the original
author had done this with a @deprecated taglet :(), but I had to deal with this
problem in existing code and it took me quite some time to figure out, since
QDox seems to always get the line-numbers somewhat too high on this one (looks
like it's always signaling the error is on the start of the NEXT JavaDoc block)
- The problem is still around in the current snapshot version (from 2010-01-10)
Regards,
Sam Bernet
PS: Keep up the nice work!
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe from this list, please visit:
http://xircles.codehaus.org/manage_email
