Nice work, Konstantin. I'm sure individual developers will take a 
closer look at "their part" of the doco as soon as they can read it in 
html. 

(This is actually possible today, but it's part of xdocletgui, so I'm 
sure many of us who don't deal with xdocletgui daily feel it's a bit 
too far away from where it should be).

I think we should have one xtags.xml file for each xdoclet module 
describing the tags. (Move the big xdoclet-tags.xml from xdocletgui, 
split it up and put pieces into xdoclet/modules/blabla/doc/xtags.xml). 
We can't handle this blob ;-) 

Then we should let the script that builds the modules also build their 
documentation using the xslt which is inside xdocletgui today. Also 
move this to xdoclet.

I think all the xtags.xml should be packaged with the xdoclet-
modules.jar. Then xdocletgui should read the xml from the xdoclet-
modules.jar file.

Here is a suggested structure for the meta info in xdoclet-modules.jar

META-INF/
   xdoclet.xml (will be generated by xdoclet prior to packaging)
   weblogic/
      xtags.xml (maintained by developers)
   jboss/
      xtags.xml
   jboss/
      xtags.xml

This means that xdoclet gui needs to access the xtag info from optional-
module.jar, and it will not be packaged inside xdocletgui.jar. The 
logic for reading the xtag info should probably be part of the xdoclet 
core (and not xdocletgui as it is today), because other components 
might need to access that info too.

What do you think about this? Let's discuss this (as wellas the new 
xdoclet module structure) on YM tonight. 18.00 - 20.00 GMT. I am 
aslak_hellesoy, and I'll send out an invitation to all developers that 
invite me as a friend or send me their yahoo id.

Cheers,
Aslak

----- Original Message -----
From: Konstantin Priblouda <[EMAIL PROTECTED]>
Date: Thursday, April 25, 2002 2:35 pm
Subject: [Xdoclet-devel] Tag descriptor ( XML )

> Hi guys, 
> 
> As many of you know, there is a work on
> xtags/xdocletgui. 
> 
> And there is XML descriptor describing tags, 
> their capabilities and applicability. 
> 
> Ideally it should become source to generate
> tag documentation. 
> 
> Yesterday I converted a lot of tag documentation into
> XML ( and there is xslt to transform thix xml into
> html ... )
> 
> So, please if you add new tags, update XML file.
> 
> And also please check what I did, because I do not
> know much about weblogic, bluestone, soap and other
> tags...
> 
> regards,
> 
> 
> 
> =====
> Konstantin Priblouda ( ko5tik )    Freelance Software developer
> < http://www.pribluda.de > < play java games -> http://www.yook.de >
> < render charts online -> http://www.pribluda.de/povray/ >
> 
> __________________________________________________
> Do You Yahoo!?
> Yahoo! Games - play chess, backgammon, pool and more
> http://games.yahoo.com/
> 
> _______________________________________________
> Xdoclet-devel mailing list
> [EMAIL PROTECTED]
> https://lists.sourceforge.net/lists/listinfo/xdoclet-devel
> 


_______________________________________________
Xdoclet-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-devel

Reply via email to