Description Frederic Fusier 2008-06-19 03:02:46 EDT

Since bug 51660 fix, tag names with special characters are considered as invalid by the compiler (e.g. @tag!name). While trying to fix bug 237051, I looked a little bit closer at javadoc tool behavior and it seems that this implementation was definitely wrong! In fact except for '"' and '\' characters, all other ones are accepted as soon as they are defined in a specific doclet or using the -tag option (see http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javadoc.html#javadocoptions).

So, the current implementation in JavadocParser.parseTag(int) to fix bug 51660 has bugs (and honestly is really awful... :-( ) which caused some troubles for the comment formatter (see bug 237051). These troubles were fixed in 3.4.1 only in the FormatterCommentParser to limit the impact of the changes but this finally must be rewritten for 3.5 to implement the correct behavior and fix all potential issues of the current implementation for all comment parsers...