WORDSMITH TOOLS INSTALLATION SECTIONS of this file: 1. Machine Requirements 2. Installation and De-Installation Notes 3. Network Version 4. The Tools -- what they do 5. Manual and Getting Help 6. Text Requirements 7. Defaults (wshell.ini file) 8. Demo versus Full Version 9. Contact Addresses This suite of programs offers lexical analysis tools. The enclosed file WTOOLS.DOC gives examples of what they do. It's in Microsoft Word for Windows 6.0 format. 1. MACHINE REQUIREMENTS IBM-compatible (at least 386) running Windows 3.1 or greater. Hard disk with at least 5 Mb free for the programs alone. During installation you will need about 10MB altogether. The more RAM and hard-disk space, the faster they will run. The suite works with CD-ROM drives as well as ordinary hard disks and floppies. It works with Windows 95, Win95B and OS/2 (WIN-OS/2) too. 2. INSTALLATION and DE-INSTALLATION The files you download, WS_PART1.EXE and WS_PART2.EXE, are self-extracting. That means they contain in compressed form all the component files of the complete WordSmith Tools package. There's no need to keep copies of them unless you have difficulty downloading over the Internet, as you can always download again another day. Double-clicking on these files unpacks them into the directory they're in at the time. Suppose they're in c:\netscape\cache. Use File Manager (Explorer in Win 95) to create a new directory (folder in Win 95), say c:\new. Move WS_PART1.EXE and WS_PART2.EXE into c:\new and then run them. They'll produce about 30 files in the same directory. Then run c:\new\SETUP.EXE to install. The setup program will a) install the software in a directory you specify, b) create an icon for you in Program Manager. You can choose to do only one or none of these. No system files are altered. If all's well, you can now delete all the files in c:\new. To get rid of the lot, just delete all the files in the directory you installed to. Section 8 below explains about upgrading from a demo version. To get rid of the lot, just delete all the files in the directory you installed to. No system files are altered. 3. NETWORK VERSION Use the same procedure to install: the directory can be a read-only one as far as most users are concerned. When these programs run, they will notice that they're running from a network. Users will be able to change their own .ini file defaults, if you specify in the wshell.ini file, the directory to which users do have read-write access. 4. THE TOOLS - WHAT THEY DO WSHELL.EXE -- WordSmith Tools Controller controls the others and contains general routines of use to all of them, for example choosing directories, screen colours CONCORD.EXE concordancer, also does collocation, dispersion plots, word cluster analysis WORDLIST.EXE makes word-lists and compares them KEYWORDS.EXE finds key words, using word-lists from WordList; also identifies "key key-words" and makes key-word databases; identifies "associates" SPLITTER.EXE utility for splitting long text files into numerous texts TRANSFRM.EXE utility for searching & replacing up to 150 strings at once, in up to 16,000 files in one go VIEWER.EXE utility for examining files in ordinary text format, and aligning a source text with a translation of it. 5. MANUAL and GETTING HELP I suggest you print out the enclosed file MANUAL.DOC. It's in Word 7 format. As WordSmith Tools is quite complex, you'll find it easier to consult a printed manual than to use the help system. The manual runs to about 100 sides of A4 paper. The help file will give you some useful advice and tips; much of the help is context-sensitive. There's a section explaining the purpose of each Tool. The help files are in English. The programs will handle most European languages. 6. TEXT REQUIREMENTS You need plain ASCII or ANSI (Windows) text. Preferably lots of it, in your favourite languages. You can get it from corpora which are available, from CD-ROMs, by scanning it in, or by asking people to give you text on disk. Typing it in yourself is too slow and painful. You'll need hard disk space for storage, too: 1 million words is about 6 Mb. The MicroConcord Corpus Collections from Oxford University Press are an excellent start; it is hoped that these will be made freely available shortly. Or at my website (address at end of this file) you will find a link to free texts which you can download. 7. DEFAULTS (WSHELL.INI FILE) The defaults are read in from WSHELL.INI as WSHELL.EXE starts running. They can also be set from within WSHELL with no need to edit the WSHELL.INI files. If you do want to edit them yourself, use any plain text editor to edit them: the easiest way is to double-click on the .INI file in File Manager or Explorer, that will call up Notepad to let you edit. 8. DEMO VERSUS FULL VERSION You get full versions of the whole WordSmith Tools suite of programs, but will not be able to see more than a sample of the results (about 25 lines of output) until you upgrade. Everything you do before upgrading will be fully usable after upgrading. FULL VERSION To upgrade you simply: 1. Send Oxford University Press your name and organization exactly as you wish to see them appear on your software. You must provide at least 10 characters in total. Enclose the current purchase price, listed at the OUP website (address below). Ensure your name is spelled clearly, since this will be used when generating a special key for you. You can send these details by e-mail, fax or post. 2. On receipt of your key, run WordSmith Tools again and choose the menu option "Update from Demo". Type in the key supplied to you by Oxford University Press. See the file OUPORDER.TXT for full ordering information. 9. CONTACT ADDRESSES Visit http://www.oup.co.uk/elt/catalogu/multimed/4589846/4589846.html for information about WordSmith Tools and other software. my website is: http://www.liv.ac.uk/~ms2928/wordsmit.html email ms2928@liv.ac.uk At my website there are links to alternative sites which have copies of WordSmith Tools for downloading. © Mike Scott 1998