download.wml from gzz at Krugle

Show download.wml syntax highlighted

#include "header.wml" select=download
#use wml::std::tags
<symbol VERSION 0.6.3>
<symbol RELDATE 2002-03-07>

<subject "Downloading Gzz">

<h2>Stable releases</h2>

<p>Currently, the recommended version of Gzz for users is VERSION,
released on RELDATE.  

# It is available from two servers: one is located
# in California, United States, and another in Finland, Europe.  Please
# use a server that is close to you.

It is currently available from only one server.  It is located in the
United States of America.

<p>
The following files are available for download:
</p>

<ul>
<perl>
sub item {
        my $tag = $_[0];
        my $file = $_[1];

        # XXX there is a cleaner way...
        my @servers = ("http://freesoftware.fsf.org/download/gzz/pre-name-change" );
        my @servtags = ("US");

        print "<li>$tag ";
        for (my $i = 0; $i <= $#servers; $i++) {
                print "[<a href=\"$servers[$i]/$file\">$servtags[$i]</a>] ";
        }
        print "</li>\n";
}
item("JAR with modules", "gzigzag-VERSION-with-modules.jar");
item("JAR without modules", "gzigzag-VERSION-without-modules.jar");
item("Documentation (.tar.gz)", "gzigzag-VERSION-doc.tar.gz");
item("Documentation (.zip)", "gzigzag-VERSION-doc.zip");
item("Source (.tar.gz)", "gzigzag-VERSION.tar.gz");
item("Source (.zip)", "gzigzag-VERSION.zip");
item("DSA-signed MD5 fingerprints", "gzigzag-VERSION.md5sums");
</perl>
</ul>

<p>All releases are <a
href="http://freesoftware.fsf.org/download/gzz/">available</a>
(versions released before the project name change are also <a
href="http://freesoftware.fsf.org/download/gzz/">available</a>).

<p>We recommend that new users download the JAR with modules.  If a
smaller download is wanted, the JAR without modules is a good choice.
More experienced users may want to download the sources instead.
Downloading the documentation is also a good idea.

<p>Please note that you should <strong>not</strong> unpack the JAR
files.  The JAR files can and should be used as they are.

<p>Gzz requires Java Runtime Environment, version 1.1 or later, to
run from the JARs.  We recommend <a
href="http://www.kaffe.org/">Kaffe</a>.  If you cannot use Kaffe,
 IBM's Java Runtime Environment, which is available from <a
 href="http://www.ibm.com/java/jdk/download/index.html">IBM's download
 page</a>, is a good choice.

<p>Starting up Gzz depends on your platform and Java
implementation.  For most UNIX or MS-Windows users who downloaded one
of the JARs, the following procedure should work:

<ol>

<li>Start a command shell (Command Prompt or DOS Prompt in MS-Windows,
xterm in UNIX/X)

<li>In the shell, check your Java Runtime Environment version by
typing <kbd>java -version</kbd> and pressing the return key.  If you
see a response whose first line says <samp>Kaffe Virtual
Machine</samp>, you are using Kaffe.  Otherwise you should see a
response of the form <samp>java version "1.1.8"</samp>.  The numbers
will vary, and they are what we are interested in.  The sample
response above indicates that the Java Runtime Environment version is
1.1.

<li>Depending on your Java Runtime Environment (JRE) version and on
which JAR you downloaded, type one of the following to the shell and
then press the return key:

<ul>

<li>For JRE 1.1 (but not Kaffe) and the JAR with modules:
<pre>
jre -cp gzz-VERSION-with-modules.jar org.gzigzag.Main cellscrollfile
</pre>
</li>

<li>For JRE 1.1 (but not Kaffe) and the JAR without modules:
<pre>
jre -cp gzz-VERSION-without-modules.jar org.gzigzag.Main cellscrollfile
</pre>
</li>

<li>For Kaffe, JRE 1.2 and JRE 1.3 and the JAR with modules:
<pre>
java -jar gzz-VERSION-with-modules.jar cellscrollfile
</pre>
</li>

<li>For Kaffe, JRE 1.2 and JRE 1.3 and the JAR without modules:
<pre>
java -jar gzz-VERSION-without-modules.jar cellscrollfile
</pre>
</li>
</ul>

All these commands will cause Gzz to save its data in a directory
called <code>cellscrollfile</code> directly in the current directory.
You can choose another name for the directory, if you wish.

</li>

<li>You can exit Gzz by pressing the <kbd>q</kbd> key.  Do
<strong>not</strong> use Control-C to exit Gzz!
</li>
</ol>

<h2>Development code</h2>

<p>Developers of GZigZag should use <a href="cvs.html">CVS</a>.

</ol>
See more files for this project here