On May 5, 2006, at 11:54 PM, Allen Gilliland wrote:
Just a little nit pick, but I think we can find a better way to describe the extra downloads than "unshippables". Maybe the Roller "required libraries" and "optional libraries" or something like that. I think that is a little easier to understand to a first time user trying to get the files.

That's good feedback.

If you read the Installation Guide you'll see that I explain how to get the Hibernate and other jars from the original "vendors" and not from the "Roller Support" project. I *do* reference the Roller Support project, but I never say specifically that you can getting all of the missing jars there.

If you read the text on the Roller Support project (a project that is supposed to be separate and independent from Roller) you'll see that there are two "unshippable" downloads:

** Webapp Unshippables for Roller - all of the missing files (Hibernate, JSPWiki, XMLP JavaScript XML parser, etc.) arranged in Roller webapp directory structure, so that you can just unzip them ontop of a Roller install.

** Source Code Unshippables for Roller - all of the missing files (Hibernate, JSPWiki, XMLP JavaScript XML parser, etc.) arranged in Roller source directory structure, so that you can just unzip them ontop of a Roller install.

So "required libraries" isn't correct, since the downloads contain both required and optional files and not just libraries. And "optional libraries" isn't quite right either.

I considered breaking everything up into separate optional and required downloads (listed below), but that defeats the purpose of the unshippables downloads, which is to make installation as easy as possible. Eventually, I'd like to move the optional parts to the Roller Support project entirely with build scripts that package them up as add-ins (and try to make that process easy), but for now, I think two unshippables downloads is the easier route to support Roller users.

- Hibernate jars (required)
- EJB 1.1 jar (required at buildtime)
- JSPWiki plugin and jars (optional)
- text-js editor and associated JavaScript classes (optional)

And one other point, perhaps we should have the "unshippables" discussion on the Roller Support project mailing list, since this is really not Apache business.

- Dave



-- Allen


Dave Johnson wrote:
I've put together a first release candidate (RC1) for Roller 2.3 and updated the user and installation docs. Please take a look. Here's a summary of what's available for 2.3:
*What's new*
I updated the Roller 2.3 what's new page to include the 2.2 features and to mention that the release no longer includes the Hibernate jars, the spell checker and the text-js editor.
http://rollerweblogger.org/wiki/Wiki.jsp?page=Roller_2.3_WhatsNew
*The release files*
Roller is now distributed as two files:
1) the webapp download named apache-roller-X.Y-incubating.tar.gz and
2) the source code download named apache-roller-src-X.Y.tar.gz
You can get those files for Roller 2.3 RC1 here:
http://people.apache.org/~snoopdave/roller-2.3-rc/
*The documentation*
I updated the Roller Installation Guide to explain how to get the missing HIbernate and other jars. The User Guide has also been updated for 2.3. You can get both of these docs here:
http://people.apache.org/~snoopdave/roller-2.3-rc/
*The Roller Support project*
I'm going to re-purpose Roller's former Java.Net home as the "Roller Support" project, which will be devoted to supporting Roller. It will host new plugins, themes and add-ons that we're not ready to support in Roller or cannot distribute in Roller due to licensing issues. It also hosts the "unshippables" -- a couple of downloads helpful when installing Roller.
https://roller.dev.java.net/

Reply via email to