Re: [Xdoclet-user] gripes about the named-parameter syntax

[Dmitri C. <di...@bi...>]

my two bob inline:

On 31 Jul 2001, Mike Williams wrote:
> However, I don't agree with the move to named-parameters in all the XDoclet
> tags.  For instance, the change from
> 
>   @ejb:finder Collection findAll()
> 
> to
> 
>   @ejb:finder return="Collection" signature="findAll()"
> 
> To me, the new syntax seems unnecessarily verbose, and makes my beans more
> difficult to read.
perhaps @ejb:finder signature="Collection findAll()" would be
better?  just a suggestion, as there is no reason why at a xdoclet level
the return type would be required alone...

> And the new syntax for declaring beans is REALLY verbose:
> 
>   @ejb:entity name="bank/Account" persistent="CMP" jndi-name="ejb/bank/Account"
> 
Firstly, does this not work on multilines?  I haven't tried, but assumed
it did... and if it doesn't I'm sure we can make it (o:  Secondly, I think
the problem that this fixes is where it is hard to know where one comment
ends and a non-tag comment starts (I know this is a contrieved example,
but):

/**
 * Some ejb, these are my comments...
 * @ejb:entity bank/Account
 * oh, I've put more comments here - god knows why... maybe I'm commenting
 * the ejbdoclet tags...
 */ 

Thats (I think ) the motivation behind the change...

cheers
dim