ANAGRM - Anagram dictionary - V90.337 Page 1 1 USAGE NOTES All you have to do to use the anagram dictionary is to set your default to the directory containing the software, and RUN ANAGRM. At the prompt, enter the anagram you want decoded; you will be presented with all known words having the anagram you gave. When done, enter an end-of-file (control/Z) to the FORTRAN version, or a null anagram (ie - just a return) to the BASIC version. 2 INSTALLATION NOTES 2.1 Under RSX If you load the anagram dictionary from a DOS-11 tape, you must execute CNVRSX.CMD to make the task files contiguous and the dictionary files fixed-length. If you just copy or BRU from a pre-loaded kit, it's ready to use without further action on your part. 2.2 Under VMS If you load the anagram dictionary from a DOS-11 tape, you must execute CNVVMS.COM to make the dictionary files fixed-length. If you just copy or BACKUP from a pre-loaded kit it's ready to use without further action on your part. 2.3 Under PRODOS-8 The only components you really need are ANAGRM.BAS and the *.DIC files. Get them on your system by hook or crook (KERMIT is fine), and then EXEC ANAGRM.BAS. This will leave a BASIC file named ANAGRM behind. Unless you're pretty slick on the KERMIT setups for the .DIC files, they'll arrive as non-direct-access files, and you'll have to write a little BASIC to convert them. Beware of the leading linefeed that at least some versions of KERMIT will stick on the first record of the first file transferred. 3 REBUILDING THE EXECUTABLES 3.1 Under RSX Execute ANARSX.CMD. You may want to edit ANARSX.BLD first to link your tasks to resident FCS, RMS, or FORTRAN libraries. ANAGRM - Anagram dictionary - V90.337 Page 2 3.2 Under VMS Execute ANAVMS.COM 3.3 Under PRODOS-8 Does not apply. 4 REBUILDING THE DICTIONARY FILES The only way to add words is to completely rebuild the dictionary files. Basicly, you create your own ANAxxx.DIC with whatever new words you want (at one word per line), and fire up the rebuild procedure, which will merge it with the existing dictionary. The "xxx" in "ANAxxx.DIC" can be whatever you want; you can even have multiple files; the procedure will find them. Rebuilding the dictionary is a time- and resource- consuming operation, so don't say you weren't warned. 4.1 Under RSX Execute DICRSX.CMD. You WILL see error messages at several points. If the error is one you're supposed to ignore, you'll get a message saying so. 4.2 Under VMS Execute DICVMS.COM. 4.3 Under PRODOS-8 Not supported; there's no known sort facility shipped with the thing, and I for blame sure wasn't going to write one. 5 COMPONENTS OF THE ANAGRAM DICTIONARY * ANA%%.DIC - The anagram dictionary. The '%%' is the length of the words in any particular dictionary file. These will have to be converted to fixed-length records after pulling them off tape; see the CNVxxx files below for more information. ANAGRM - Anagram dictionary - V90.337 Page 3 * ANAGRM.BAS - The source for the anagram lookup program, in Applesoft BASIC, executable under PRODOS-8. EXEC the file to create the program. * ANAGRM.FTN - The source for the anagram lookup program, compilable in PDP-11 FORTRAN-77 or VAX FORTRAN. * ANAMAK.FTN - Used in ordering the dictionary files. Slurps up any list of words, and writes them one word per line, with the anagram coming first, followed by a space and the 'plaintext'. Any non-alphabetic character serves as a delimiter. NOT capable of making a dictionary file all by itself; it is used by the DICxxx command procedures. * MAKANA.FTN - Forms the 'canonical' anagram of any string; anagram formation stops at the first non-alphabetic character. The anagram is returned in lowercase. * ANARSX.CMD - Builds ANAGRM and ANAMAK under RSX. * ANAVMS.COM - Builds ANAGRM and ANAMAK under VMS. * CNVRSX.CMD - Converts dictionaries to fixed-length under RSX. * CNVVMS.COM - Converts dictionaries to fixed-length under VMS. * DICRSX.COM - Rebuild dictionary files under RSX. This takes all the ANA*.DIC files in its directory, combines them, and makes a new set of ANA%%.DIC files out of them. Be warned that this is a "brute force" implementation, that requires substantial amount of disk space (about 3-4x the combined size of all the ANA*.DIC files). * DICVMS.COM - Rebuild dictionary files under VMS. This takes all the ANA*.DIC files in its directory, combines them, and makes a new set of ANA%%.DIC files out of them. Be warned that this is a "brute force" implementation, that requires substantial disk quota (about 3-4x the combined size of all the ANA*.DIC files).