WordMeister Read Me

WordMeister is a Hangman-style Java applet, which you can put on your own Web site.

The WordMeister applet is provided as freeware, subject to the terms and restrictions set forth at the end of this file. By using this applet, you agree to abide by these terms and restrictions. If you use this on your Web page, we ask that you copy the applet to your own server; please do not link to the applet or other data at our site.

If you use this on your Web site, a link to our homepage at <http://www.tolstoy.com> is appreciated. Please also send an email to <samizdat@tolstoy.com> indicating the URL.

This is version 1.20, the first general release. If you have any problems or comments, please let us know as soon as possible.

To put WordMeister on your Web page, you need to copy four items included with this distribution into a directory on your Web site. The four items are the 'COM' directory, and the files 'meister.zip', 'elements.gif', and 'click.au'.

Note that when you unzipped the distribution file, you must preserve the directory structure: the 'COM' directory must contain a 'tolstoy' directory, which contains a 'meister1' directory, which contains the 10 .class files of the applet.

In addition to the files included with this distribution, you must supply two files: an HTML page to hold the applet, and a file which contains the list of words you wish to use. See the description of the 'wordurl' parameter below for the format of a word list file.

Assuming that your domain name is yourdomain, and that you want to run WordMeister from the yourdirectory directory, the minimum amount of HTML required to use this applet is as follows:

<applet archive="meister.zip" code="COM.tolstoy.meister1.WordMeister.class"
  codebase="http://www.yourdomain.com/yourdirectory/"
  width=400 height=220>
  <param name=courtesyof value="Freeware from Samizdat Productions">
  <param name=getyourowncopyat value="http://www.tolstoy.com">
  <param name=disclaimer value="Samizdat Productions is not responsible for user supplied word lists.">
  <param name=wordurl value="http://www.yourdomain.com/yourdirectory/yourwordlist.txt">
</applet>

Using the above as an example, the 'yourdirectory' directory must contain the following four items included with this package:

The 'COM' directory, which contains the unzipped .class files
The 'meister.zip' file, which contains the classes in a .zip file.
The 'elements.gif' file, which contains the artwork for the applet.
The 'click.au' file, which contains a beep sound.

In addition, 'yourdirectory' must contain an html file which contains the html for the applet.

A complete explanation of each parameter follows. All are required.

archive ( from applet tag )
Must be "meister.zip"

code ( from applet tag )
Must be "COM.tolstoy.meister1.WordMeister.class"

codebase ( from applet tag )
The complete URL of the directory which contains meister.zip and the COM directory; this should be followed by a '/', as shown above

width, height ( from applet tag )
Must be 400 and 220, respectively.

courtesyof
Must be "Freeware from Samizdat Productions"

getyourowncopyat
Must be "http://www.tolstoy.com"

disclaimer
Must be "Samizdat Productions is not responsible for user supplied word lists."

wordurl
A full URL pointing to a text file containing the word list to use.
The text file must be located at the same domain as the applet, otherwise you will receive a Java security exception.
This file must contain just one line, which contains each of the words to use, separated by '*' characters. Only lower case letters between 'a' and 'z' are allowed. A sample word list looks like:

wordone*wordtwo*wordthree*

Terms and Restrictions

WordMeister is Copyright © 1996-97 Samizdat Productions. All Rights Reserved.

This software is 'freeware', and is provided on an "as-is" basis; use this software at your own risk. No warranty of fitness for any purpose is claimed, implicitly or otherwise.

You may not link to the applet or other files at our site; you must copy the files to your own Web site or server.

Feel free to duplicate and re-distribute this software. You must distribute all the files of this package together, including this file.

This software may be used for any purpose, provided that it is not sold either directly or indirectly. Any such use is strictly prohibited.