                           L O G O S
                           ~~~~~~~~

     LOGOS is shareware, please see REGISTER.TXT for details of 
how to register.  INTRO.TXT gives details of system requirements, 
and a summary of the funtions that the program performs.  This 
file gives instructions on the installation and use of the program.

     LOGOS performs three primary functions, matching word,
hidden word and anagram searches.  Secondary functions allow the
main dictionary to be augmented by the formation of a supplement
and the output of the searches to be printed or stored to disc.

Installing LOGOS
~~~~~~~~~~~~~~~~
     For optimum performance LOGOS should be place on a hard
disc.  Whether you intend to use a hard disc or not please make
a 'working' copy and keep the original in a safe place.

     The files which are required are:
      LOGOS.EXE - the program itself.
      MAIN.DIC  - the main dictionary.
      LOGOS.DOC - this document.
      README    - Basic instructions.

     All these files should be copied on to the working disc. 
(See you DOS manual for details of the COPY command.)

Running LOGOS
~~~~~~~~~~~~~
     To start LOGOS select the drive and directory containing the
program and at the prompt type LOGOS.  An introductory screen
will be shown giving details of the program and dictionary files
being used.  After a short delay, as the dictionary index is
loaded, a prompt will appear.  Press space and the main menu will
appear.  If this does not happen an error message will be
displayed, consult the section on errors for more details.

Keys
~~~~
     The following keys are available at the menus:

          Up,Down   Move the selection bar up or down.
          Return    Perform the highlighted function.
          0,1,2...  Perform function number 0,1,2 ...
          Alt-X     Rapid exit from LOGOS.

     When a grey entry window appears use:

          Cursor Keys    To edit the text displayed.
          Esc            To leave and restore the old value.
          Return         To leave and accept the new value.

     When a red error window appears:

          Space to accept message and continue with LOGOS.  

     When a search is in progress:

          Esc       To interrupt the search.
          Space     To continue the search when the screen is
                    full.
Colour V Monochrome
~~~~~~~~~~~~~~~~~~~
     If you have a monochrome screen then you may find that the
highlight bar is invisible.  LOGOS can usually detect what sort
of screen you are using and choose a suitable colour scheme, but
it may get it wrong.
     In order to override the detection start LOGOS using the /c
switch:
     LOGOS /cc      will force LOGOS to use colours
     LOGOS /cm      will force LOGOS to use monochrome

These Instructions
~~~~~~~~~~~~~~~~~~
     You should now know enough to use LOGOS.  The best way to
learn how to use LOGOS is to use it.  However in case of
difficulty consult the rest of this document.

Main Menu
~~~~~~~~~
     The options and their functions are:

     Matching word search     Search the dictionary for a word
                              which is the same length and fits
                              the template.
                              I.e. perform a 'crossword' type
                              search.

     Hidden word search       Search the dictionary for any words
                              which are constructible from the
                              letters in the given word.

     Anagram search           Search the dictionary for anagrams
                              (including multi-word) which can
                              be formed from the given word(s)
                              and which fit the template.

     Dictionary maintenance   Search the dictionaries for a
                              particular word and allow its
                              addition to the supplement if it
                              is not present.

     Redirect output          Select the output device to which
                              the search results are directed.

Matching Word Search
~~~~~~~~~~~~~~~~~~~~
     Select the length of the word to be searched for, then edit
into the template any known letters.  Press '3' to start the
search.

Hidden Word Search
~~~~~~~~~~~~~~~~~~
     Enter the letters that are available for constructing words
and press '2' to start the search.

Anagram Search
~~~~~~~~~~~~~~
     Enter the letters to be used in the anagram, change the
length of the desired solution, using commas to separate the
lengths of the words.  Then fill in the template (which will now
show the correct form for the specified lengths) with any known
letters.  Press '4' to start the search.
     Remark:  If you ask LOGOS to perform multi-word anagrams
with some short words (4 or fewer letters) you may find that the
program appears to stop, or that there are very many possible
solutions.  If this happens try some of the following
suggestions:
     i/  LOGOS multi-word anagram searches are normally quicker
if long words are placed first in the template (i.e. 10,3,3 is
usually quicker than 3,3,10)
     ii/ Adding one or two letters to the template can eliminate
many solutions.  Due to the search method this also increases the
speed of the search.
     iii/ Try omitting small words from the search (i.e. instead
of 10,3,6 try 10,6)

Output
~~~~~~
     In the above cases, when the search has started, the words
which fit the specified conditions will be shown on the screen
(or sent to the current output device, see below).  When the
screen full LOGOS will pause to allow you to digest the
information.  Press space to continue with the search, or Esc to
return to the menu.  At the end of the search press space to
return to the menu.
     If the printer or a disc file has been selected as the
output device, output will be sent directly to it.  An indicator
at the top of the screen shows the progress of the search.  If
the program detects an error it will report it and then terminate
the search.

Dictionary Maintenance
~~~~~~~~~~~~~~~~~~~~~~
     To check the location of a word select '1' then enter the
word.  The location will be displayed, press space to return to
the menu.  If you wish to add a word to the dictionary then use
option '2', if the word is already known an error message will
be displayed.  Otherwise the word will be added to the supplement
(which will be created if it does not exist).
     The supplement file SUPP.WRD can be edited using a text
editor,  please ensure that each word is on its own line and in
uppercase.  Words that do not conform to this will not be matched
in searches!
     Note: LOGOS looks for the file DICT.WRD in both the
currently selected directory (CSD) and the directory containing
LOGOS.EXE, however it only looks for SUPP.WRD in the CSD.

Redirecting Output
~~~~~~~~~~~~~~~~~~
     Pressing '1' on this menu will allow selection (by cursor
keys or by keys '1' to '4') of the output device for the results
of the searches.  'Screen' is the default setting.  'Default
Printer' will cause output to be sent to the PRN: device, the
output is in columns, <80 characters wide and no control
characters are sent.  The 'Disc' options use the filename
specified in option '2' of the Redirect Output menu to store the
data to.  Again the output is formatted into columns with line
width <80.  The two disc options allow for either the creation
of a new file or appending to an existing file.
     Note:  'Create a new file' will create a new file on the
first search after its selection and on subsequent searches
append to that file.  'Append to file' will create a new file if
none exist with the output file name.

Error Messages
~~~~~~~~~~~~~~
     The following errors (which appear in red error windows) do
not cause termination of LOGOS:

File Access Error : Unable to open SUPP.WRD
~~~~~~~~~~~~~~~~~
          This error occurs when you have asked to add a word to
     the supplementary dictionary and  LOGOS could not create or
     update the file SUPP.WRD.
          Check that there is free space on the current drive and
     if the file SUPP.WRD already exists that it is not 'read
     only'.

File Access Error : Unable to open ...
~~~~~~~~~~~~~~~~~
          This error occurs when attempting to redirect the
     output of a search to a disc file and LOGOS was unable to
     create or update the file.
          Check that
                i) the filename that you specified is a valid DOS
               filename.
                ii) if the file exists that it is not 'read
               only'.
                iii) There is free space on the disc.

Value Out of Range : The value you specified was outside the
~~~~~~~~~~~~~~~~~~   allowed range.

          When entering the number of letters it must be in the
     range 1-30.

Too Few Letters : There must be enough letters to fill the
~~~~~~~~~~~~~~~   template.

          This means that you have specified that the anagram
     must consist of more letters than you have given in the
     'letters' section.  e.g. you entered LEMON in the letters
     section and then asked LOGOS to find a 3,3 anagram from it!



     These errors are fatal errors (i.e. cause LOGOS to stop
running).

Insufficient Memory to load index
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
          This occurs when LOGOS attempts to load a dictionary
     index, but is unable to do so because of the lack of memory.
          Since the index is about 200k long (Main dictionary 
     Version 1.2) this should not happen unless you are trying
     to run LOGOS from inside another program or you have lots
     of memory resident programs loaded.  The only solution is
     to try to free some memory.

Out of Memory
~~~~~~~~~~~~~
& 
Insufficient Memory
~~~~~~~~~~~~~~~~~~~
          These occur when LOGOS finds that it cannot continue
     a search, or perform some other function because there is
     not enough memory available to it.
          Solution : try to make more memory available, or don't
     ask LOGOS to perform such large word searches (anagrams
     especially).

Note: For anagram searches the program is restricted in its
searching ability by the available memory.

Error Accessing File
~~~~~~~~~~~~~~~~~~~~
          LOGOS was unable to access the dictionary file.  Since
     not much can be done without this it decided that it might
     as well terminate.
          Solution : Ensure that the dictionary file is always
     available.



     Critical error messages.  Messages in this class should
never happen.  They can easily be recognised because they include
either:

Abnormal Program Termination

or:
(MALLOC)

     If you get an error message like this and can reproduce it,
then please send me details of how it occurs.


     DOS errors (of the Abort, Cancel, Fail, Retry? type) should
be handle in the usual manner. 
