> -----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
