The following comment has been added to this issue:
Author: Michael Pichler
Created: Mon, 28 Jul 2003 8:40 AM
Body:
I stand corrected.
http://java.sun.com/j2se/1.4.1/docs/tooldocs/solaris/javadoc.html#documentationcomments
says:
Placement of comments - Documentation comments are recognized only when placed
immediately before class, interface, constructor, method, or field declarations [...]
Thus the xjavadoc behavior is perfectly legal (even though not 100 % identical with
javadoc 1.4 behavior).
---------------------------------------------------------------------
View the issue:
http://opensource.atlassian.com/projects/xdoclet/secure/ViewIssue.jspa?key=XJD-32
Here is an overview of the issue:
---------------------------------------------------------------------
Key: XJD-32
Summary: Java-comment breaks down Javadoc-comment
Type: Bug
Status: Assigned
Priority: Minor
Time Spent: Unknown
Remaining: Unknown
Project: XJavaDoc
Components:
Parser
Assignee: xdoclet-devel (Use for new issues)
Reporter: Michael Pichler
Created: Mon, 28 Jul 2003 7:53 AM
Updated: Mon, 28 Jul 2003 7:53 AM
Environment: xdoclet 1.2
Description:
When upgrading to xdoclet 1.2 we have noticed that javadoc comments (/**...*/)
containing xdoclet tags are ignored when there is an ordinary comment (//) between the
javadoc comment and the method declaration. This did work with xdoclet 1.1 and javadoc
1.4.
Example:
public interface Foo
{
/**
* Find bar.
*
* @hw.foo-method
*/
// <FIXXME author="user" desc="Add a baz parameter">
// blah blah
public Bar find(int depth, Object mode) throws FooException;
// </FIXXME>
}
---------------------------------------------------------------------
JIRA INFORMATION:
This message is automatically generated by JIRA.
If you think it was sent incorrectly contact one of the administrators:
http://opensource.atlassian.com/projects/xdoclet/secure/Administrators.jspa
If you want more information on JIRA, or have a bug to report see:
http://www.atlassian.com/software/jira
-------------------------------------------------------
This SF.Net email sponsored by: Free pre-built ASP.NET sites including
Data Reports, E-commerce, Portals, and Forums are available now.
Download today and enter to win an XBOX or Visual Studio .NET.
http://aspnet.click-url.com/go/psa00100003ave/direct;at.aspnet_072303_01/01
_______________________________________________
xdoclet-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-devel
