On Fri, 2003-03-07 at 17:03, Hani Suleiman wrote:
> I'm adding some new features and fixing some CMp mapping bugs in the 
> orion xdoclet module, and I'd like to ensure the xtags documentation is 
> updated accordingly too. However, I'm running into a snag where I can't 
> seem to find any docs on the xtags file, so I apologise in advance if 
> my question is answered already in some doc that I've missed...
> 
> How would I go about adding docs to orion specific attributes for tags 
> that are in other modules? For example, it is possible to specify an 
> orion query in ejb.finder:
> 
> @ejb.finder orion-query="blahblah"

Hani, have you seen the message from the last couple of weeks over in
xdoclet-devel  with subjects "xtags" and "Documentation of additions
tags not in own namespace?"

IMO, the documentation of these belongs in the modules' own xtags.xml,
so you'd have a second "ejb" namespace in there containins a definition
of the ejb.finder tag that only has the new parameter entries in it. 
That way you can have multiple modules all adding their own parameters
independently, and ideally tools will merge them together as required. 
However, there's been no confirmation yet as to whether XDocletGUI will
in fact do this, or whether it will cause problems and we'll have to
find another way around it.

FWIW, until I hear any differently I'm assuming the above way will be
okay, so that's how I've done it for the SunONE module.


Andrew.




-------------------------------------------------------
This SF.net email is sponsored by: Etnus, makers of TotalView, The debugger 
for complex code. Debugging C/C++ programs can leave you feeling lost and 
disoriented. TotalView can help you find your way. Available on major UNIX 
and Linux platforms. Try it free. www.etnus.com
_______________________________________________
xdoclet-user mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-user

Reply via email to