On Tue, 2004-03-23 at 18:08, Curry, Jim wrote:
> First, thanks to Andrew Stevens for answering my post and motivating
> me to flounder around a little more till I stumbled across a fix. I
> use a source code formatter called Jalopy. One of its features is if
> you surround a block of code with //J- and //J+ it will not attempt to
> format that block. Apparently having //J- and //J+ around the class
> level comment was enough to confuse the sunone support into almost
> doing nothing. Once I removed the //J- and //J+ everything worked
> great.
Hmm... you never had those in the sample code you posted ;-)
If you must use it, I suggest you put the closing one after the class
declaration line i.e.
//J-
/** My comment
* @ejb.bean ...
*/
public abstract class MyBean implements SessionBean {
// J+
The javadoc specs/docs say the class/method/etc. comments should
*immediately* precede the relevant declaration, and the grammar used by
XJavadoc goes along with this. If you put anything (other than white
space) between the comment and declaration, it won't recognise it as a
javadoc comment. I guess there's a good case to be argued for ignoring
additional non-javadoc comments, but that's not how the current parser
behaves.
A similar common mistake is to put the class-level comment before the
package or import statements rather than directly before the class
statement. That doesn't work either...
It's not just the sunone module that would be confused by this, the ejb
module would do the same. You were probably just lucky that its default
values matched what you had (e.g. you wanted a Stateless session bean,
not a Stateful one, and it could guess the name by stripping off the
"Bean" part of the classname).
Andrew.
-------------------------------------------------------
This SF.Net email is sponsored by: IBM Linux Tutorials
Free Linux tutorial presented by Daniel Robbins, President and CEO of
GenToo technologies. Learn everything from fundamentals to system
administration.http://ads.osdn.com/?ad_id=1470&alloc_id=3638&op=click
_______________________________________________
xdoclet-user mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-user
