General Notes
======= =====

These files are for the production of "Word Search" puzzles on your printer.

With the exception of TIDY.COM and WS-UCASE.COM, all you need to do is
start the program, answer a few questions, and you're in business.

For example, to produce a single puzzle, you type WORDSRCH at the MS-DOS
prompt & press the "Enter" key. Then type in the name of a file containing
a list of words. The file WORDS that is included is ideal. Then specify how
wide and how long you want the puzzle when asked. (Note: the program has a
limit of 40 x 40 puzzles.) The program will work its way through the list in
the file, and produce a puzzle. You can stop the program at any time by
pressing the "Esc" key.

When it is ready to print, the program will pause and wait for you to press
the "enter" key. When it is through with printing, the program will update
the file so that the words it used appear later in the file. 

Program WSMULTI2 works pretty much the same way, except that it only asks for
one dimension, so that a reply of "30" will produce a 30x30 puzzle. It also
prepares up to 10 puzzles. As before, pressing the "Esc" key will stop the
programme.

WS-MULTI just asks for a file name, and produces a range of puzzles, beginning
with 10x10, and ending with 40x40.

The file format is simple: it contains a list of words, entered in upper-case,
without punctuation, and one word per line. Program WS-ADD lets you create
a suitable file.

If you get an "Error 16" it probably means you made a typo on the file name.

The command-line syntax for TIDY.COM is:

        TIDY {source file} {destination file}

and results in a partially sorted copy of the source file, with some of the
duplicate words (if any) removed and the lines converted to upper-case

The command-line syntax for WS-UCASE is:

        WS-UCASE <file name>

The entries in the file will be converted to uppercase.

Caution
=======

Running PK-LITE over the EXE files could prevent them from working properly.

Important note
========= ====

Unfortunately the source code is lost somewhere, possibly on a 5.25" disk
somewhere. If I find it then this archive might be updated....

Files included in this archive
===== ======== == ==== =======

README   TXT - this file
TIDY     COM - tidies up a file
WORDS        - a sample list of words
WORDSRCH EXE - produces a single puzzle
WS-ADD   EXE - lets you add words to a file
WS-MULTI EXE - produces puzzles of different sizes
WS-UCASE COM - converts a file to upper-case
WSMULTI2 EXE - produces 10 puzzles

Credits
=======

The programs were prepared with the ApBasic compiler and the A86 assembler.

