Details
-
Type:
Improvement
-
Status:
Closed
-
Priority:
Minor
-
Resolution: Fixed
-
Affects Version/s: 1.4
-
Fix Version/s: 1.5
-
Component/s: None
-
Labels:None
-
Number of attachments :
Description
Using the latest 1.4 snapshot:
The method that parses a Javadoc tag up into named parameters uses a StringTokenizer to do the work. This causes an unnatural formatting restriction on the developers part.
@hibernate.class table = "Users"
The extra space around the '=' character causes the tokenizer to see three individual parameters for this tag instead of one. It sees no named parameters.
I don't believe named parameters are part of the Javadoc spec, but they are used a lot; particularly in nearly every XDoclet subtask. XDoclet does not consider whitespace around the equals sign to be a factor when determining named parameters.
Activity
I think we should support this, but I don't see it as critical so it's postponed to 1.5.
Aslak Hellesøy
added a comment - I think we should support this, but I don't see it as critical so it's postponed to 1.5. Aslak Hellesøy
made changes -
| Field | Original Value | New Value |
|---|---|---|
| Fix Version/s | 1.5 [ 10650 ] |
Mike Williams
made changes -
| Assignee | Mike Williams [ mdub ] |
I've re-written the tag-parameter parsing using StreamTokenizer rather than StringTokenizer. It should now be compatible with XDoclet/XJavadoc.
Mike Williams
added a comment - I've re-written the tag-parameter parsing using StreamTokenizer rather than StringTokenizer. It should now be compatible with XDoclet/XJavadoc. Mike Williams
made changes -
| Resolution | Fixed [ 1 ] | |
| Status | Open [ 1 ] | Resolved [ 5 ] |
Closed, in consultation with Jim.
Mike Williams
added a comment - Closed, in consultation with Jim. Mike Williams
made changes -
| Status | Resolved [ 5 ] | Closed [ 6 ] |
Aslak, we should probably maintain compat with xjavadoc, right? Can you easily sync up the name-parameter parsing code?