On Thu, 2003-03-27 at 22:46, Sean wrote: > > You know, you have the ability to answer this for yourself :-) > > As you can see form > > http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/xdoclet/xdoclet > > I don't really know how xdoclet runs under the hood. I would however like > to learn.
It's not too hard to figure out. Everything's split up by modules below xdoclet/modules/, so have a look through the source files for whatever module you're interested in. The .xdt files are the templates that are used to generate the output files, and are run by the SubTask descendants (either once for each of the matching files in your fileset, like the EJB interface subtasks, or once only for all the files, like the deployment descriptor subtask). They look kind of like JSPs. The various template tags (<XDtFoo:bar bub="yip">) are documented at http://xdoclet.org/templates/index.html Each namespace (the bit after the "XDt") has a corresponding tag handler, usually named something similar ("FooTagsHandler"), containing a public method for each tag and probably various other methods too that help do the work. Look through various template files, you'll soon get the hang of what the most commonly used template tags are for. ifHas(Class/Method)Tag appears a lot, checking for the existence of a particular @tag on the current class or method and including its body or not accordingly, (class/method)TagValue to include the value of an @tag's parameter, forAll(Methods or Classes) to loop through stuff, etc. > I like xdoclet, but I do find myself constantly frustrated with it. > > What does this file do? just define tags for type checking? That particular file (jboss_xml.xdt) is the template file for producing the JBoss-specific deployment descriptor jboss.xml (the similarity in the template file's name is intentional). It's run by JBossSubTask, which has various config parameters available (the various fields/getters/setters). The execute() method in that particular subtask is a bit more complicated than most, to take account of the various supported versions and the different files that get generated for each of those versions. Hope this helps, Andrew. ------------------------------------------------------- This SF.net email is sponsored by: The Definitive IT and Networking Event. Be There! NetWorld+Interop Las Vegas 2003 -- Register today! http://ads.sourceforge.net/cgi-bin/redirect.pl?keyn0001en _______________________________________________ xdoclet-user mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/xdoclet-user
