Call me stupid…(if you like) but installing Xith at the moment is far too difficult for ordinary people.
EDIT: too late, you can’t call me stupid for misunderstanding the whole “java library path” stuff. I eventually spotted it on the page where it is mentioned. By way of explanation, when I want to “install” somethinig I don’t give a **** about reading lots of “What does X mean?” sections - I just want a one-click download. When I was confronted by these phrases (see below) I scrolled up and down and looked for a section titled anything like “install directories” or “java library path” but there were no headings that suggested to me that they would contain this info, so I didn’t read the paras themselves. Yes, this was stupid of me. But…an install guide should start with a numbered list of steps, and should only start explaining what directories are etc AFTER that, since people often can’t be bothered to read all that until they’ve got the thing working :).
We’re doing a game using it, and I just tried to do an install on a virgin machine, to see what would happen.
Here’s what happens:
-
Go to Xith site, look for install. No. Nothing. Aha! There’s a download link!
-
No install instructions on the download page. All it does is give me a tar.gz. WTF am I supposed to do with this? (Bear with me here, I’m acting like a normal person).
-
WTF is it tar.gz, that lesser-known fileformat that tends to only be openable on unix systems by default - why not ZIP, which tends to be openable by default on both windows AND unix? (not that I’m saying this is a good state of affairs, just that that’s how it is). Is there some reason e.g. that OS X users can open tar’s but not zip’s? If it were bzip I could understand - that’s a compression format that saves a lot of space compared to zip, but it isn’t :(.
-
OK, so that got me nowhere. Try again, this time look for docs. Aha! Found an install tutorial.
-
Which then waffles on about “your Java Library Directory” and “the Native Library Directory”. Now, even as a professional java developer I’m not comfortable with those terms, so what are newbie developers chances of coping with this? At least I know where I can lookup what they mean (assuming these are the names that sun gives to the special directories in the JRE install) and I accept they are something I ought to know, but the thing is I use the terms so rarely I’ve forgotten by the time I next need them :).
-
So I download all the “third party” files. But…the instructions say nothing about whether I need to maintain the hierarchies of sub-directories, or whether I can (or should or even must) flatten them to just one dir.
-
Ahem. And after downloading all of those, I’m back to grabbing that TAR file. I don’t know what’s wrong with this brand-new PC (only recently arrived from a shop with Windows XP on it) but it’s winzip will open gz’s as expected but refuses to open TAR’s (I thought that winzip used to understand TAR?). So…I’m left with a bunch of files that may or may not be in the right place, one of which I apparently have to untar but I’m going to end up FTP’ing to a linux server rather than spend potentially ages searching for a free UNTAR for windows XP.
All of which is just to say: guys, Xith is great. But you’ve really got to fix this install situation. Making a ZIP available (in parallel with the TAR if some unix diehards refuse ZIPs :P) would be a great first step; updating the install guide to explain what directories it’s referring to AND WHERE THEY NORMALLY ARE would also be a great move that probably doesn’t take much time. If someone could do it for windows first, I would happily suss out the linux equivalents and confirm the paths for you.
NB: I do appreciate that Xith is not even at 1.0 yet; but that’s not a good excuse for it to be hard to get to grips with - presumably the more developers that are using it even pre-1.0 the better? Anyway, taken to the extreme, that excuse would also be an excuse for also having 0 documentation, 0 demos, and 0 tutorials.

).