Okay, there's been more negative comments than positive about the files generated by last night's build, so I'm not releasing those ones. Here's the comments so we can discuss them (votes, please!)
> - We can't release it without samples being part of the > xdoclet-1.2.0.tar and xdoclet-1.2.0.zip bundles. Please correct the > build.xml if it doesn't copy samples to target. I agree, it should have the jars, docs and samples (and nothing else). By the way, why does these files end up with both an activity-log.xml /and/ and an activity-log.html? > - I don't find any uses for xdoclet-lib-1.2.0.tar and > xdoclet-lib-1.2.0.zip. Remove them. They're a bare-bones copy of the various modules' jars. Generally I agree, there's not much point in not including the docs etc. I was a bit surprised just how big a difference that makes, though, especially to the zip (880K vs 2Meg!) > - What's xdoclet-translate-1.2.0.zip for? It only has English > Messages.proeprties files in it. Remove it. It's a base locale jar for translators to download and use for localisation. This way, it keeps it small, only includes the bits they need and they don't need to worry about building from source etc. Just download, unzip and load it up in a resource bundle editor. Then, when/if they send back a translated set, I'd put the equivalent translated jar into the downloads for the version as a locale-specific language pack (just needs to be added to the classpath for the resource bundles to pick up the messages for the locale). It's debatable whether we need to generate one for the beta (I've already found a bunch of other stuff in need of i18n), but useful for the final version IMO. > And Andrew can you change the xdoclet-all to xdoclet-src? I'm afraid ppl > will rush to download *the bigger the all version* and flood us with > many how-should-I-build-it questions. It's not really a source archive, though, it still includes all the jars, generated docs, samples output etc. I reckon those shouldn't be included (the archive contains everything needed to rebuild them). > You may also want to name the > other version xdoclet-bin, but don't forget to include the samples in it > too! That's very important. Agreed. Konstantin said Re: the XTags.xml problem > Hi guys, I nabbed the problem and fixed it. > Logic in tag family which gets tag description by > name is unsuitable for situations where there are > multiple tags with same name > ( ok, it was never planned for it ) > > For now I dropped usage of getTag(string name ) > and just iterate over all of them and check whether > they are applicable. > > Shall I commit it so it makes into release? Commit it anyway, I tagged all the files before building, and have a clean version as of that point. Only question is whether to also include the fix when I redo the builds? Also, I noticed a couple of CVS update messages for a fix/improvement to XDoc.getFirstSentence(); should that be included too? > We need version numbers for xjavadoc! I didn't tag/release xjavadoc & xdocletgui separately 'cos last time I asked the reply was "Make a big bundle for now. Later we may decide to make them separate bundles." It wouldn't be too hard to do it, though. What version should be? 1.0, 1.0-beta, or what? Also, once the xjavadoc.jar's built, should we be versioning (i.e. checking in) the xjavadoc.jar that xdoclet's being built against somewhere in the xdoclet CVS? There's stuff in xdoclet's build script that uses the latest source if it's available, but nothing to copy it in from e.g. /lib if the xjavadoc source isn't available or newer... And while we're talking of versions, I notice xdocletgui and the jedit plugin say they're 0.2.alpha and 0.1.alpha - are they ready for a beta yet? Also, shouldn't XDoclet's version be 1.2.0-beta1 rather than 1.2.0? That's about all I can think of for now. In summary, I vote: [Add samples to xdoclet-1.2.0: +1] [Drop the xdoclet-lib-1.2.0 files: +1] [Include translate zip in beta: -0] [Include translate zip in final: +1] [Remove non-source files from xdoclet-all/src: +1] [Rename xdoclet-all to xdoclet-src: +1 if it does only contain source -0 if it still has the other files] [Rename xdoclet-1.2.0 to xdoclet-bin-1.2.0: +1] [Include xtags bug fix: +1] [Include XDoc.getFirstSentence() fix: +1] [Tag/build xjavadoc separately: +1] [XJavadoc version: 1.0-beta] [Tag/build xdocletgui separately: +1] [Promote xdocletgui & plugin from alpha version no.: +1] [Add "beta" to xdoclet's version no.: +1] Andrew. ------------------------------------------------------- This sf.net email is sponsored by:ThinkGeek Welcome to geek heaven. http://thinkgeek.com/sf _______________________________________________ Xdoclet-devel mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/xdoclet-devel