Contents

• Introduction
• Install
• Starting a command prompt
• Navigating to the wordsrch folder
• Running the program

Introduction

This is a guide to installing the wordsrch program for windows users unfamiliar with console mode programs. If you know what you are doing then wordsrch -h will tell you all you need to know.

Installing wordsrch.exe

1. You will need to download the latest version of the windows binary from here.
2. Unzip the file you downloaded and extract the files to a folder on your hard drive. From now on we will assume that the files have been extracted to c:\stuff\wordsearch\win32\.

Starting a command prompt

Windows 2000/XP

1. Start...Run...
2. Type cmd.exe
3. Press <ENTER>

Windows 95/98

1. Start...Run...
2. Type command
3. Press <ENTER>

A window should soon appear. It may contain some text but the last line should look something like this:

C:\Documents and Settings\username\>_

The blinking line is often called the cursor.

Navigating to the wordsrch folder

One quirk of windows is that you cannot go directly to a folder which has a different drive letter. If the command prompt start with a different letter than the location you saved it to then you must change the drive letter by typing the letter you want followed by a colon. e.g.

D:\some\path\on\the\wrong\drive\>c:

C:\>_

Now you can change to the folder where you extracted the >wordsrch.exe program. You use the cd command.

C:\>cd c:\stuff\wordsrch\win32

C:\STUFF\WORDSRCH\WIN32>_

The dir command lists the contents of the folder:

C:\STUFF\WORDSRCH\WIN32>dir
 Volume in drive C is mu/drives/c

 Directory of C:\STUFF\WORDSRCH\WIN32

.                    <DIR>  03-13-05  3:59p
..                   <DIR>  03-13-05  3:59p
WORDSRCH EXE        27,786  03-13-05  9:14a
WORDLIST TXT           205  10-13-04  5:21p
LICEN~MZ            14,378  03-13-05  9:29a
LICEN~RD            17,992  07-14-04 11:46p
README                 997  03-13-05  9:53a
         5 file(s)         61,358 bytes
         2 dir(s)   2,147,450,880 bytes free

C:\STUFF\WORDSRCH\WIN32>

Running the program

Typing wordsrch -h will list the options available and suggest some commands to try.

C:\STUFF\WORDSRCH\WIN32>wordsrch -h
Usage: wordsrch [OPTIONS]... [FILE]
Creates a word search puzzle from a list of words.
If no FILE is specified stdin is used until an EOF.
Options:
  -h,  --help   prints this help
  -s            easier grid - no diagonal words
  -S            very easy - S & E only
  -k            suppress answer key
  -w=n          minimun width n letters
  -t TITLE      sets the title to TITLE
  -c=n          number of columns for answer key (XHTML). n in [1..9]
  -f=n          output format. Valid values of n are:
                0: XML   (default - for wordsearch.swf)
                1: XHTML (XHTML 1.0 Strict)
                2: plain (no spaces between letters)
                3: plain (spaces between letters)
                4: plain (tabs between letters)

Example: wordsrch -t "My Wordsearch"-f=1 words.txt
   prints an XHTML file containing the wordsearch.

Hint for DOS/Win users - try
   wordsrch -f=1 words.txt > mypage.html
   to make a web page
C:\STUFF\WORDSRCH\WIN32>_