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

Reply via email to