I would not use META-INF as directory name, because it could be confusing (these are templates for files that eventually come in META-INF, but are not needed at deployment). The Ant In Anger article (http://jakarta.apache.org/ant/ant_in_anger.html) defines a metadata directory to put all your metadata.
So I propose /xdoclet/modules/jboss/src/metadata/jboss-web-xtags.xml /xdoclet/modules/jboss/src/metadata/jboss-ejb-xtags.xml /xdoclet/modules/jboss/src/metadata/jboss-jmx-xtags.xml Mathias ----- Original Message ----- From: "Aslak Hellesoy" <[EMAIL PROTECTED]> To: "Ara Abrahamian" <[EMAIL PROTECTED]>; <[EMAIL PROTECTED]> Sent: Sunday, April 28, 2002 5:10 AM Subject: RE: [Xdoclet-devel] RE: Build > > > > -----Original Message----- > > From: Ara Abrahamian [mailto:[EMAIL PROTECTED]] > > Sent: 28. april 2002 13:05 > > To: Aslak_Hellesxy; [EMAIL PROTECTED] > > Subject: Re: [Xdoclet-devel] RE: Build > > > > > > Hi, > > > > > > > /xdoclet/modules/jboss/src/xdoclet/modules/jboss/ejb/resources/xtags.xml > > > > > /xdoclet/modules/jboss/src/xdoclet/modules/jboss/jmx/resources/xtags.xml > > > > > /xdoclet/modules/jboss/src/xdoclet/modules/jboss/web/resources/xtags.xml > > > > Then how do you know you should look at blabla/web/resources? It's not > > any more a predefined place like /meta-inf. > > > > Imho we can put it in src folder as you describe, but in the module jar > > file let's just put it under meta-inf but with a name like > > web-xtags.xml/ejb-xtags.xml and so on. xdocletgui then should look at > > meta-inf and load all these *-xtags.xml files. And after all you're > > quite used to first checking meta-intf forlder for metadata files, so > > it's more intuitive. > > > > That's a good idea. Perhaps we should just put them straight in the right > place then: > /xdoclet/modules/jboss/src/META-INF/jboss-web-xtags.xml > /xdoclet/modules/jboss/src/META-INF/jboss-ejb-xtags.xml > /xdoclet/modules/jboss/src/META-INF/jboss-jmx-xtags.xml > > All the modules will produce one jar file, but shouldn't we provide one > xdoclet-all-modules.jar too? So that users don't need to have tons of jar > files. Then we need to be sure that the various xtags files in the various > modules don't clash. We could do this by settling for a naming convention. > Proposal: > > vendor-[product]-[subproduct]-xtags.jar > > This would give: > jboss-ejb-xtags.xml > bea-wls-ejb-xtags.xml > castor-xtags.xml > > Does this sound reasonable, or should we forget about having a > xdoclet-all-modules.jar ? > > > > The xsl in xdocletgui can be applied to these xtags.xml files > > > wherever we > > > put them, and generate an HTML document for each of them. This > > > results in > > > more fragmented docs, and is better I think. We also need to make > > > some TOC > > > menu which will point to these HTML files. This should also be > > > automatic. > > > Any ideas about how to do that? I also suggest that the generated > > > HTML files > > > be put in a directory structure where they all reside in a different > > > directory. Then they can all be called doc.html or something, and we > > > needn't > > > worry about names. > > > > Anyway volunteering to implement xtags.xml+xslt->docs stuff (using > > dokbook for example)? > > > > If the xsl transforms to docbook format, we can generate a multitude of > formats from that (html, pdf, rtf...). I suppose there are standard > conversion tools from docbook to these formats available. -But I'm a little > afraid it might be too complicated and further delaying the release. -Unless > you know docbook and these docbook tools... > > > > I'm not 100% sure if we haven't broken any backwards compatibility > > > anywhere, > > > so perhaps we should version it 2.0.beta? > > > > Because from the end user's point of view nothing changed (all tags > > still work, all subtasks still work and are backward compatible) I > > beleive v1.2 is the correct version name. > > > > > L O G O S > > > > AFAIK the last logo I submitted was ok-ed by you/vincent/... I'll send > > it again. > > > > Well, I preferred the ones you submitted with color and "attribute oriented > programming" in it, but if the vote is closed, forget it ;-) > > > > New build scripts: Vincent > > > Move templates: Ara > > > Upgrade to Ant 1.5: Aslak > > > Make docs: ??? > > > Put back logos and make a poll session on SF: ??? > > > > - bugs > > > > Ara. > > > > __________________________________________________ > > Do You Yahoo!? > > Yahoo! Health - your guide to health and wellness > > http://health.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
