> So it seems that putting all of them into @ejb:bean
> ( common ones ) does not eliminate need for
> @ejb:session @ejb:entity & @ejb:messsage-driven
They have some common params and maybe a lot of uncommon params.
Ejb:bean is a better name and 3 distinct names is redundant.
> What about following idea:
>
> We determine what kind of bean is it by inheritance
> ( implementing of certain interface )
>
> What is wrong , if we follow DTD names in class level
> tags
> ( say, @ejb:name @ejb:description @ejb:small-icon etc.
> )?
>
> This would be nice to migrating people, it would not
> be
> more verbose than tag with a lot of parameters,
> and it would be aesy to understand for all -
> just look in dtd.
It's been discussed a lot :-)
If we flatten everything to just parameters with no grouping then we
have a namespace with a lot of names. It'll be like a C project where
you have 200 flat functions, while our approach is like having 20
classes each class having its own functions. Better categorization.
BTW, rarely people use all those params and they can put them in
separate lines.
Whole these scenarios were discussed during past 2 weeks and we came up
to compromise over all these issues.
I agree with you that it's better to have param names that are more
close to dtd, but some of them are long, and verbose. For example, in
dtd we have env-entry-name in env-entry element. Should we also declare
it like this: @env-entry env-entry-name="blabla" or @env-entry
name="blabla"? The second format is better, for sure you know name param
is env-entry-name.
And we should even copy dtd descriptions to our docs. I did exactly that
for webdoclet.
> All the tags where just a string value is expected
> would be single param, and those like ejb-ref would
> use name/param values
>
> We can also wrap references to such class tags with
> <XDoclet:requireTag>
> <foobar>bazbang</foobar>
> </XDoclet:requireTag>
>
> which would bomb to user if he did not specified
> this tag required by dtd?
If you put error="bomb message" for classTagValue it will explode on
user.
Ara.
_________________________________________________________
Do You Yahoo!?
Get your free @yahoo.com address at http://mail.yahoo.com
_______________________________________________
Xdoclet-devel mailing list
[EMAIL PROTECTED]
http://lists.sourceforge.net/lists/listinfo/xdoclet-devel
