
     Quiz Construction Kit                          Users' Guide Page 1

                           Quiz Construction Kit
                   for the Atari ST and STE up to TOS 2.

                    Written in 1989 by Andrew R. Oakley
                        (updated in 1990 and 1991)

                                Users' Guide

     Contents:

     1.   Introduction
     2.   Getting Started
          2.1  Loading
          2.2  Playing the Quiz
          2.3  Using the Menus
     3.   The Info Menu
          3.1  Credits
          3.2  Databank
          3.3  Clock
     4.   The File Menu
          4.1  Load
          4.2  Save
          4.3  Merge
          4.4  Delete
          4.5  Quit
     5.   The Databank Menu
          5.1  Add Question
          5.2  Edit Question
          5.3  Delete Question
          5.4  Default
          5.5  Print Databank
          5.6  Erase Databank
     6.   The Game Menu
          6.1  Questions per Round
          6.2  Repetition
          6.3  Show/Don't Show Answer
          6.4  Music On/Off
          6.5  White on Black/Black on White
          6.6  Highscore On/Off
          6.7  Restart Game
          6.8  Lock/Unlock
     7.   The Records Menu
          7.1  The Highscore Display
          7.2  Open/Close Records
          7.3  View Records
          7.4  Print Records
          7.5  Delete Records
     8.   Appendix
          8.1  Errors
          8.2  Changing the Default Databank
          8.3  And Finally...

                              1. Introduction

      The  Quiz  Construction Kit is designed for adults  and  children
     aged 11 and over. It allows the user to design and  participate in
     multiple  choice quizzes,  giving the user total control over  the
     quiz  and  making it ideal for home or  educational  use.  It  was
     written  using Mandarin Software's STOS Games Creator  Basic,  and
     will  run using any Atari ST (single or double sided  disk  drive)
     linked to a TV set, colour or monochrome monitor. It can handle up
     to  1000  multiple  choice questions with  between  two  and  five


     Quiz Construction Kit                          Users' Guide Page 2

     answers to each question.  It can also keep records of highscores,
     plus every person to play the quiz,  their name and score. You can
     even print out the quizzes in a ready to use form.

                             2. Getting Started

      Many people prefer to take back-up copies of their disks and keep
     the  originals  in a safe place.  I certainly  advise  this.  This
     program  is  public domain,  which means there  are  no  copyright
     restrictions on it,  and you may copy it at will (unlike  previous
     versions, this program may now be used in South Africa). All I ask
     is that you copy the three files (the program file QUIZ.PRG,  this
     manual QUIZ.TXT and the databank DEFAULT.QUZ) together-  otherwise
     the  next person to use the program will have problems-  and  also
     that  if you find this program useful (say,  you use it more  than
     thrice)  that  you become an official registered user  by  sending
     five pounds (that's 10 US dollars or 50 French francs) to me  (I'm
     only  a  poor student at Cheltenham & Gloucester  College  with  a
     social life to support...).  If you enclose a disk and SAE I  will
     also send you some of my other programs (state ram,  disk drive  &
     colour/mono). My address is:-
          Andrew Oakley,
           24, Daddlebrook Road,
            Alveley,
             Bridgnorth,
              Shropshire WV15 6NU UK

     2.1 Loading

      Simply  turn  on your ST and insert the disk.  When  the  desktop
     appears, double-click on QUIZ.PRG. If you can't immediately see it
     then search through some folders (see your Atari ST Owner's Manual
     for details).  Hopefully your disk will be virus free and to  keep
     it  this  way it is best to switch off your computer if  you  have
     been  using  it before loading the  Quiz  Construction  Kit.  Many
     viruses  remain in memory even when the reset button  is  pressed.
     Switching off kills them.

      When  the  program has loaded,  after displaying a  short  credit
     notice  it will attempt to load the default set of questions  from
     the disk- a pack of trivia questions.  It is a simple job to alter
     it  so that a set of your questions becomes the default.  See  8.2
     Changing the Default Databank for more information.

     2.2 Playing the Quiz

      With the default questions loaded, you can start playing straight
     away. A question will be displayed, along with between two to five
     possible answers, plus your score, the current question number and
     the number of questions in a round (eg.  Question number 1 of  5).
     You'll also get some music to help (?) you concentrate!

      Simply use the mouse to point to the answer you think is correct,
     and press the mouse button.  It doesn't matter which mouse  button
     you  press whilst you are playing the quiz.  Once you have  chosen
     your answer you will be informed whether you were correct or  not-
     to the tune of appropriate music.  Clicking the mouse button  will
     return you to the next question,  until,  five questions later  at
     the end of the round,  you are given your final result, which will
     hopefully be a new highscore.  If so,  you will be asked for  your
     name. Simply type it in and press return.



     Quiz Construction Kit                          Users' Guide Page 3

     2.3 Using the Menus

      Because of the use of STOS the pull-down menus may seem different
     to what you are used to. However, they operate in exactly the same
     way.  Simply point to the heading you require,  select the  option
     you  want and click the left mouse button (only the left will  do-
     this is common amongst most computer programs).  You can't  select
     any  options that are shaded- such as the highscore display  under
     the  Records  heading.  If you accidentally pull down a  menu  you
     don't  want,  either select another you do want or click the  left
     mouse button outside the menu box. After accessing any option, the
     current round will be scrapped and a new round will begin. Each of
     the  menus and options will be looked at in detail in the rest  of
     this guide.

      Throughout many of the menu options, you may be asked some yes or
     no questions.  You can either type Y or N,  or point at the Y or N
     displayed next to the question and press the left mouse button.  Y
     and N appear as inverse;  so if you are playing with black text on
     a white background, they will appear as a white Y and N on a black
     background.

                              3. The Info Menu

     3.1 Credits

      This   gives  a  Public  Domain   notice  and  details   of   the
     registration scheme.

     3.2 Databank

      A  databank  is a file containing a set of questions  along  with
     various  details about the quiz settings,  such as the  number  of
     questions per round etc.  This option simply displays  information
     about the current databank and quiz settings.

     3.3 Clock

      This  shows  the date and time.  If you don't have a  clock  card
     installed, or wish to alter the date or time, click on either Date
     or Time and enter it correctly, followed by return. Use dd/mm/yyyy
     format for the date (eg.  20/01/1989 for the 20th of January 1989)
     and 24 hour hh:mm format for the time (eg.  13:55 for 5 minutes to
     2 o'clock in the afternoon, 00:00 for midnight). The clock display
     will not update itself on screen but the computer's clock will, as
     always, continue. When you have finished, click on Exit.

                              4. The File Menu

     4.1 Load

      This  allows you to load in new databanks of questions  that  you
     have  prepared.  Either type in the file name and press return  or
     click twice on the file name (if it is displayed).  If you want to
     re-read the disk's directory click on DIR,  if you want to open  a
     folder  (all folders are prefixed by *) click on the folder  name,
     and  if  you want to close a folder click  on  PREVIOUS.  You  can
     scroll up and down the directory by clicking on UP and  DOWN.  All
     filenames must end with .QUZ as others are not databank files.





     Quiz Construction Kit                          Users' Guide Page 4

     4.2 Save

      Use  this option to save databanks you have prepared so that  you
     can  use them again.  Questions will be saved along with  all  the
     quiz settings. You will be asked whether you wish to save the file
     as  a locked file (see 6.8 Lock/Unlock for details) in which  case
     you  must enter a password.  Basically,  locked files cannot  have
     their  questions  or settings altered without  unlocking  them  by
     entering in the correct password.  It does not stop the whole file
     from  being deleted!  Whether you choose to lock the file or  not,
     next you must choose what to call the file in much the same way as
     you would to load it.  If you choose an already existing file,  it
     will be replaced by your new one.  As with loading,  all filenames
     must end with .QUZ or you may never find them again!

     4.3 Merge

      This  is very similar to load except that is does not  erase  the
     current  questions or settings,  but simply adds new questions  to
     memory.  You  can have up to 1000 questions in memory.  If  you've
     forgotten the password on a locked file (see 6.8 Lock/Unlock) then
     this option will allow you to get back at the questions.

     4.4 Delete

      Again similar to load but this deletes a databank file from disk.
     If you want to delete a records file see 7.5 Delete Records.

     4.5 Quit

      Quitting exits the Quiz Construction Set and puts you back in the
     hands of the Gem Desktop, explained in your Owner's Manual.

                            5. The Databank Menu

     5.1 Add Question

      Use  this  option to create new questions.  Simply  type  in  the
     question and the five answers (after the second answer you can not
     put in any more by just pressing return),  followed by the  number
     of  the  answer which is correct.  The question and  answers  will
     appear  exactly as you have typed them- so don't  forget  capitals
     and punctuation such as question marks. Once you have typed in the
     question or an answer you will be asked to verify it- simply  type
     Y  if it is ok,  or N if it needs changing.  Finally you  will  be
     asked if you wish to keep the question. Press Y to confirm or N if
     you  want  to scrap the whole question.  You can have up  to  1000
     questions in memory, each with a minimum of two answers.

     5.2 Edit Question

      This  allows  you  to alter  questions  already  in  memory.  The
     computer will ask you what it is to search for.  Simply enter in a
     few words that are contained in the question you wish to edit. The
     computer  will  find all the questions which have those  words  in
     the actual question- not the answers. So if you want to search for
     the question "What is baby rabbit called?" you could enter RABBIT.
     The   computer  would  also  present  you  with  other   questions
     containing  the word RABBIT such as "Do rabbits have  longer  ears
     than hares?".  The computer will present you with all the matching
     questions plus their answers and ask you which of them you wish to
     edit. Editing is pretty much the same as adding a new question.


     Quiz Construction Kit                          Users' Guide Page 5

     5.3 Delete Question

      Use this option to delete unwanted questions by identifying  them
     in the same way as for editing.  Again,  the computer will present
     you  with a list of the matching ones and ask you which are to  be
     deleted. If you want to delete all the questions it is far quicker
     to erase the whole databank- see 5.6 Erase Databank.

     5.4 Default

      This will load back the default questions,  or default  questions
     from  another  pre-prepared  disk.  Make sure the  disk  with  the
     default questions is in the disk drive!

     5.5 Print Databank

      You  can print out your quizzes using this option.  If  the  Show
     Answer  option  (see 6.3 Show/Don't Show Answer) is  on  then  the
     answers will be printed after the last question.  If you  restrict
     your  questions  to one line you will find the quizzes  fit  quite
     well  onto  standard 66 line continuous  stationery  (or  "tractor
     paper") without splitting questions and answers over page folds.

     5.6 Erase Databank

      Calling  this option erases all the questions in  memory,  giving
     you  a clear databank to make your own quizzes from  scratch.  The
     game will be halted until more questions are loaded or added.

                              6. The Game Menu

     6.1 Questions per Round

      This lets you specify how many questions to have in a  round.  It
     is possible,  although sometimes pointless, to have more questions
     in a round than you have in the databank.

     6.2 Repetition

      You can choose to have the questions never repeated,  repeated or
     not repeated in the same round,  by yes/no questions.  Should  the
     computer  ask all the questions the user will be informed and  the
     questions will be asked once more.

     6.3 Show/Don't Show Answer

      Clicking  on this selects whether the computer will  display  the
     correct answer should the user get it wrong.  It's all done by the
     one mouse click- you don't need to type or do anything else.  When
     you next access the menu, the option will have changed.

     6.4 Music On/Off

      This turns the music on or off and works just like the Show/Don't
     Show Answer option.

     6.5 White on Black/Black on White

      Allows you to select the colour (?) scheme,  and again works like
     the Show/Don't Show Answer option.




     Quiz Construction Kit                          Users' Guide Page 6

     6.6 Highscore On/Off

      That's right!  This switches the highscore on or off,  and  works
     like the Show/Don't Show Answer option.  Regardless of whether  it
     is  on  or  off,  it is still displayed under  the  Records  menu.
     When you switch it off it resets it,  so switching it off and then
     back on will have the effect of clearing the highscore.

     6.7 Restart Game

      Click  on this option to start a new round.  The old one will  be
     scrapped.

     6.8 Lock/Unlock

      If  you've  left a class of pupils playing your quiz  there's  no
     need  to worry about amateur hackers!  Use this option to lock  up
     the program so that all the menus become unusable.  You will  need
     to enter a password.  To reverse this,  use Unlock and type in the
     password  again.  You only get three chances to get the  password-
     after  that the lock becomes permanent and even the Unlock  option
     will no longer work.  Obviously,  if you've put the lock  on,  you
     can't  get at the File menu to save the databank,  so you'll  find
     the  Save option (see 4.2 Save) asks you if you want to  save  the
     file as a locked one.

                            7. The Records Menu

     7.1 The Highscore Display

      The  highscore is always displayed under the Records  menu.  It's
     shaded,  which  means you can't click on it.  It comprises of  the
     highscore and the name of the person who achieved it. If you get a
     new  highscore  you will be asked for  your  name,  unless  you've
     already  entered  it  as  part of  the  Records  system  (see  7.2
     Open/Close Records).

     7.2 Open/Close Records

      Records  allow you to keep a record (hence the name!) of all  the
     participants in a quiz- ideal for school tests.  Their name, which
     is  asked for at the end of each round,  is kept along with  their
     score.  To open a record, enter in a filename just as you would to
     load a databank (see 4.1 Load) but this time it must end with .REC
     or you may loose it! If you open an existing record, the highscore
     is updated.  If you save a databank with a record still open, this
     is  remembered when you load the databank back- and  the  computer
     will carry on adding names and scores to the list.  Not having the
     databank  and  the  records file on the same  disk  may  therefore
     create problems! Closing a record simply stops the computer adding
     names and scores- it doesn't erase it.

     7.3 View Records

      You can use this option to browse through a records file, whether
     open or closed. The names and scores are displayed one at a time.








     Quiz Construction Kit                          Users' Guide Page 7

     7.4 Print Records

      This prints an entire records file on the printer- yes,  it  does
     help if you've got one all ready and connected!  The computer will
     not leave any spaces between records so if you're using continuous
     stationery (aka "tractor paper") it's up to you to set the printer
     not  to  print  on the folds.  Refer to your  printer  manual  for
     details.

     7.5 Delete Records

      This  deletes  a record file just like Delete on  the  File  menu
     deletes a databank file (see 4.4 Delete).

                                8. Appendix

     8.1 Errors

      Every  effort  has been made to remove all errors from  the  Quiz
     Construction  Kit  by  a couple of very  helpful  playtesters  and
     myself.  To  the best of the playtesters' and  my  knowledge,  the
     program  is free from bugs,  but that doesn't stop the  user  from
     making accidental mistakes- such as putting the wrong disk in  the
     drive,  misspelling filenames and so on.  Any errors the  computer
     can't  cope  with  are  displayed,   together  with  any   helpful
     information to allow you to rectify them.

     8.2 Changing the Default Databank

      You can instruct the Quiz Construction Kit to load up one of your
     databank files as a default rather than the supplied trivia  pack.
     Simply  save your databank under the filename DEFAULT.QUZ  onto  a
     copy of the disk (if you use the original you may loose the trivia
     pack for good).  It will create very few problems to the  computer
     if  you don't have a default file on the disk- all the  menus  and
     functions  will continue to operate until some  questions  arrive,
     either by you adding or loading some.

     8.3 And Finally...

      I  hope you enjoy using my Quiz Construction Kit.  It  was  first
     programmed  in 1989 and was updated in 1990,  and again  in  1991.
     Thanks  to  Stephen Penn (look out for his PD proggies)  and  Tony
     Oakley for playtesting the game. Hello to the FHIST crew (Ash, Al,
     Bell, Malc and Mark) and all at Cheltenham and Gloucester College.
     Thanks to Deadline Comic/Magazine,  Atlantic 252 Long Wave  Radio,
     BBC  Radio Shropshire,  Radio 4 News FM,  Pop Will Eat Itself  and
     various gothic groups for entertaining me.  Thanks to  Sainsbury's
     Red Label Tea for keeping me alive.

                               Andrew Oakley,
     24, Daddlebrook Road, Alveley, Bridgnorth, Shropshire WV15 6NU UK.
