home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / EDUCATE / EDUCAT21.ZIP / EDUCATER.DOC < prev    next >
Text File  |  1993-11-06  |  40KB  |  856 lines
  1.  
  2.  
  3.                               Educatabase v1.2
  4.                               ~~~~~~~~~~~~~~~~                                      Copyright (c) 1992,1993 S.Griffiths
  5.  
  6.               Copyright 1992,1993 S.Griffiths, All Rights Reserved
  7.  
  8.  
  9.  
  10.  
  11.               Contents
  12.               ~~~~~~~~
  13.  
  14.  
  15.               Introduction
  16.                  Disclaimer Of Warranty
  17.                  License
  18.                  Terms Of Distribution
  19.  
  20.               The Designer
  21.                  Files
  22.                  Editing
  23.                  Options
  24.                  Verify Errors
  25.                  Running Tests
  26.                  Printing
  27.                  Printing Errors
  28.                  Setup
  29.  
  30.               The Examiner
  31.                  Files
  32.                  Running Tests
  33.                  Printing
  34.                  Setup
  35.  
  36.               Configuration
  37.                  Installation
  38.                  Error Messages
  39.                  Files
  40.  
  41.   
  42.   Introduction
  43.   ~~~~~~~~~~~~
  44.  
  45.   Educatabase is a multichoice question and answer program. It allows  you  to
  46.   create,  print, and run multichoice tests. Educatabase consists of two  main
  47.   programs,  firstly the designing program which is used to  create  and  edit
  48.   questions  and  run  tests,  secondly  the  program  which  just  runs   the
  49.   multichoice  tests that have already been designed. Various reports  may  be
  50.   printed from both parts of the program.
  51.  
  52.   The  shareware version is not restricted in anyway, except for  the  reports
  53.   printed  will always have a header line saying 'Shareware'. This is  removed
  54.   in  the registered version. If you find Educatabase useful and would like to
  55.   continue using it you can register it for only $40 (N.Z.) by filling in  the
  56.   form at the end of the README.DOC file.
  57.   
  58.   DISCLAIMER OF WARRANTY
  59.   ~~~~~~~~~~~~~~~~~~~~~~
  60.   
  61.   THIS  SOFTWARE AND MANUAL ARE SUPPLIED "AS IS". THE AUTHOR HEREBY  DISCLAIMS
  62.   ALL WARRANTIES RELATING TO THIS SOFTWARE AND ITS DOCUMENTATION FILE, EXPRESS
  63.   OR IMPLIED, INCLUDING BUT NOT LIMITED TO DAMAGE TO HARDWARE, SOFTWARE AND/OR
  64.   DATA  FROM USE OF THIS PRODUCT. IN NO EVENT WILL THE AUTHOR OF THIS SOFTWARE
  65.   BE  LIABLE  TO  YOU  OR ANY OTHER PARTY FOR ANY DAMAGES. YOUR  USE  OF  THIS
  66.   SOFTWARE  INDICATES THAT YOU HAVE READ AND AGREE TO THESE  AND  OTHER  TERMS
  67.   INCLUDED IN THIS DOCUMENTATION FILE.
  68.   
  69.   DUE  TO  THE  NATURE  OF EVOLVING PROGRAMMING AND THE VARIOUS  HARDWARE  AND
  70.   SOFTWARE  ENVIRONMENTS IN WHICH THIS SOFTWARE MAY BE USED, IT IS  UNDERSTOOD
  71.   THAT  OCCASIONAL "BUGS" OR UNFITNESS MAY ARISE. THE USER SHOULD ALWAYS  TEST
  72.   THIS SOFTWARE THOROUGHLY WITH NON-CRITICAL DATA BEFORE RELYING ON IT.
  73.   
  74.   LICENSE
  75.   ~~~~~~~
  76.   
  77.   EDUCATABASE is distributed as shareware. This means that you are  granted  a
  78.   limited license to use it for a period of 30 days. If you find it useful and
  79.   decide  to  continue  using  it  after the  trial  period,  registration  is
  80.   required.  EDUCATABASE is neither free software nor  is  it  in  the  public
  81.   domain. The software and its documentation, this file, are property  of  the
  82.   author and may not be sold without written permission from the author.
  83.   
  84.   Registered  users will be granted a just-like-a-book license which  means  a
  85.   registered  version of the software can be used by more than one person  and
  86.   can be moved from one computer to another so long as there is NO POSSIBILITY
  87.   of  it being used by two different persons on two different computers at the
  88.   same time, just like a book can not be read by two different persons in  two
  89.   different places at the same time.
  90.   
  91.   A  dealer license allows you distribute as many copies of EDUCATABASE as you
  92.   like,  to  whomever you please, provided no charge is made and the following
  93.   distribution terms are met.
  94.   
  95.   TERMS OF DISTRIBUTION
  96.   ~~~~~~~~~~~~~~~~~~~~~
  97.   
  98.   Redistribution  of EDUCATABASE must include the software, its  documentation
  99.   file,  and  all supplemental files as a single unit without any modification
  100.   AND subject to the following conditions:
  101.   
  102.   1.Any  individual  is  welcome  to make copies for  his/her  friends  and/or
  103.     colleagues if NO FEE is charged.
  104.   
  105.   2.Electronic  bulletin boards, whether they charge or do  not  charge  their
  106.     users  subscription fee, are welcome to post the program for down  loading
  107.     as  long  as they do not charge any fee in particular for the distribution
  108.     of EDUCATABASE.
  109.   
  110.   3.Non-commercial user groups and computer clubs may distribute  the  program
  111.     to their members if only a small distribution fee charged.
  112.   
  113.   4.Disk  vendors  approved by the Association of Shareware  Professionals  or
  114.     disk  vendors who explain the concept of shareware in their ads that quote
  115.     a price may distribute the shareware version of EDUCATABASE.
  116.   
  117.   5.Other  commercial  enterprises  wishing to distribute  EDUCATABASE  either
  118.     alone  or in combination with other hardware, software, books or materials
  119.     must obtain permission in writing from the author.
  120.   
  121.   HOW TO REGISTER
  122.   ~~~~~~~~~~~~~~~
  123.   
  124.   Please read this section before filling out the order form at the end of
  125.   this document.
  126.   
  127.   1.   Read the License information (above)
  128.   
  129.   2.   Foreign order. Payment in the following forms is accepted:
  130.   
  131.             A.   Cash (Please note that the author cannot be responsible
  132.                  for any loss in the mail)
  133.             B.   Bank check.
  134.             C.   International money order issued by banks, etc...
  135.   
  136.   To  compensate  the  inconvenience of currency exchange, foreign  users  are
  137.   charged the same amount for shipping and handling as N.Z. users.
  138.   
  139.   
  140.   The Designer
  141.   ~~~~~~~~~~~~
  142.  
  143.   Once loaded a window displaying the program title, in this case - 'Educater'
  144.   and  the  version number. Once a key is pressed this disappears the  program
  145.   continues. There are two main parts to this program, the pull down menus  at
  146.   the  top  of the screen and the editor, which is the majority of the screen.
  147.   The pull down menus control the settings and allow loading, saving etc... of
  148.   questions.  The  editor screen is where the questions are actually  entered,
  149.   and edited. Questions can be inserted and deleted when in the editor screen.
  150.   
  151.   When  the program is first loaded the option bar is placed of the file menu.
  152.   To  navigate the menus the arrow keys are used to move about. The left/right
  153.   keys move from one menu topic to the other, while the up/down keys move  the
  154.   highlite  selection bar to the desired option. The <Enter> key  will  select
  155.   the  current option. To select a menu item from the editor screen, hold down
  156.   the  <ALT> key and press the highlighted option of the menu you want.ie  for
  157.   the  file menu you would hold down the <ALT> key and press < F > .  When  in
  158.   the  Designer you are either using the pull down menus/options or are in the
  159.   editor screen.
  160.   
  161.   
  162.   
  163.   File Menu
  164.   ~~~~~~~~~
  165.   
  166.   These options deal mainly with the storage of disk files etc...
  167.   
  168.   Load: This loads questions previously saved to disk. Firstly a entry box  is
  169.   displayed prompting the user for the file type to load, a default  of  'EDU'
  170.   extension is assumed, as this is the extension used by Educatabase.  However
  171.   this  can  be  changed if need be. When <Enter> is pressed the  file  window
  172.   appears showing the files in the current
  173.   
  174.   directory  that match the filespec specified (eg. '*.EDU').  Use  the  arrow
  175.   keys  to  select the file that you wish to load. Pressing <Space> while  the
  176.   file  window  is  displayed will toggle the layout of the files  from  three
  177.   columns,  to  one  column,  when  in one column  mode  more  information  is
  178.   displayed about each file. Once a file has been selected a check is made  to
  179.   ensure you wish to load the file. The load option can also be selected  from
  180.   the editing screen by pressing < F3 > .
  181.   
  182.   New:  This  erases  any questions currently in memory,  clearing  the  total
  183.   questions  back to one. Warning: Any questions in memory that  haven't  been
  184.   saved to disk will be lost.
  185.   
  186.   Save: This saves the current questions to disk. If the questions are new and
  187.   have not been saved before a query is made to prompt you for the filename, a
  188.   default of 'NONAME' appears. Once you enter the filename you wish to use the
  189.   file is saved to disk. If no extension is specified the default of 'EDU'  is
  190.   used.  Once the question have been saved subsequent save's to disk will  not
  191.   result  in the prompt for the filename and the questions will just be saved.
  192.   This option can also be selected from the editor screen by pressing < F2 > .
  193.   
  194.   Write  to: This option allows questions to be saved to disk with a different
  195.   name.  Once questions have been saved to disk they have a specific  filename
  196.   for  those  questions,  however  if you wish  to  create  a  different  file
  197.   containing  the  same questions, this option will again  prompt  you  for  a
  198.   filename and create a new file on disk.
  199.   
  200.   Directory:  This displays all the files in the current directory,  which  by
  201.   default  will be the data directory. As in the load option <Space >  can  be
  202.   used to toggle the output style of the files.
  203.   
  204.   Change  Dir:  This  allows a different directory to  be  used  as  the  data
  205.   directory.
  206.   
  207.   See  your  DOS  manual  for  more information  on  file  names,  file  specs
  208.   (wildcards), extensions, and directories.
  209.   
  210.   
  211.   
  212.   Edit Menu
  213.   ~~~~~~~~~
  214.   
  215.   The edit option does not have any submenu options. Selecting the edit option
  216.   puts  the cursor into the main editor screen where most of the work is done.
  217.   The  arrow  keys are used to move the cursor up, down, left and right.  Each
  218.   question has five lines for the question, and five answer with up two  lines
  219.   for each answer.
  220.   
  221.   The  prompts within the editor screen indicate several things. The  question
  222.   status  firstly displays the current question number, followed by the  total
  223.   number  of  questions.  ie: 'Question 4/25' indicates  that  question  4  is
  224.   currently being edited, and there are currently a total of 25 questions. The
  225.   top  right of the edit window will inform you of whether the insert mode  is
  226.   on  or off. If the insert mode is one 'Insert' is displayed, when the insert
  227.   mode is off nothing is displayed. When insert mode is on old characters  are
  228.   pushed along and not overwritten. The current file name is also displayed on
  229.   the  top  line,  if  the file has not yet been saved  then  this  will  have
  230.   'NONAME'  displayed  otherwise it will have the name of  the  file  that  is
  231.   currently being edited. Finally the correct answer to the question  is  also
  232.   displayed on the top line.
  233.   
  234.   Questions  can contain information on any lines in any order. Also  not  all
  235.   the  answers need to have an entry. For example you might only want to  have
  236.   two  options  for  a  particular question.  Any  gaps  in  the  answers  are
  237.   automatically removed when the test is run, however they remain visible when
  238.   editing  the  test.  For example say a question contains  answers  for  only
  239.   options  A,  C, and E, when the test is run this question will be  displayed
  240.   with  only  three answers but they will be displayed as A, B,  and  C.  Each
  241.   question must at least contain two options to choose from.
  242.   
  243.   Entering hints can be done with the <ALT-H> keystroke. A single line pops up
  244.   allowing  a simple one line hint to be entered for that particular question.
  245.   As  many hints as you want can be entered (ie. one for every question is  so
  246.   desired). However the user can set a limit (which is on the options menu) to
  247.   only  allow  a  person doing the test to use a set amount of hints.  If  the
  248.   number of hints is set to zero (ie. turned off) then <ALT-H> will not  allow
  249.   any hints to be entered.
  250.   
  251.   Inserting and deleting questions is done with <ALT-I> and <ALT-D>. Inserting
  252.   a  question will move all the current questions up one and the editor screen
  253.   will  have  a  empty  question.  Deleting a question  will  remove  the  one
  254.   currently being edited and all other questions are moved down one,  and  the
  255.   next question will be displayed.
  256.   
  257.   To  blank out all the entries for the current question use <ALT-C> this will
  258.   confirm you wish to do this (It only erases the current question that is  on
  259.   the screen). <ALT-L> will erase the current line that the cursor is on.
  260.   
  261.   Moving  around questions is done with the <CTRL> key and the left and  right
  262.   arrow  keys.  This moves in either direction one question  at  a  time,  the
  263.   current  question status at the top of the screen will change each  time  to
  264.   move  to  a  new question. In addition to the arrow keys the <Page  Up>  and
  265.   <Page  Down>  keys with <CTRL> allow jumping to the start  and  end  of  the
  266.   questions quickly.
  267.   
  268.  
  269.   
  270.   
  271.   The following is a summary of the editor commands:
  272.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  273.   
  274.   Cursor Movement Commands:
  275.   
  276.              Character left - Left arrow
  277.             Character right - Right arrow
  278.                     Line up - Up arrow
  279.                   Line down - Enter or Down arrow
  280.   
  281.               Next Question - Ctrl+Right arrow
  282.           Previous Question - Ctrl+Left arrow
  283.              First Question - Ctrl+PgUp
  284.               Last Question - Ctrl+PgDn
  285.   
  286.             Insert Question - Alt+I
  287.             Delete Question - Alt+D
  288.          Erase current line - Alt+L
  289.             Erase all lines - Alt+C
  290.          Insert mode on/off - Insert
  291.              Edit hint line - Alt+H
  292.   
  293.          Display Helpscreen - Fl
  294.              Save Questions - F2
  295.              Load Questions - F3
  296.            Run current test - F9
  297.                 Go to menus - F10
  298.   
  299.   
  300.   
  301.   Options Menu
  302.   ~~~~~~~~~~~~
  303.   
  304.   The  options allow different settings to be made regarding how the  test  is
  305.   run etc... All these options are stored with the questions on disk when they
  306.   are  saved,  and  hence all still apply when the test is  run  through  'The
  307.   Examiner'  program, except they can not be viewed or changed  when  in  'The
  308.   Examiner' program.
  309.   
  310.   Time Limit: Selecting this will prompt you for a value in seconds to act  as
  311.   the  time limit. If this is set to zero then no time limit is set, any value
  312.   greater  than  zero  limits the person doing a test to  that  long  on  each
  313.   question.  Once  the time limit expires when doing a test a  'Pass'  message
  314.   appears  on the screen and the user is forced to go on to the next question.
  315.   When ever the time limit expires for a particular question it is classed  as
  316.   a pass, and can be seen on the final results screen.
  317.   
  318.   Questions  Randomised:  When  this item is selected  a  query  box  pops  up
  319.   allowing you to select either yes or no for this current option. If 'yes' is
  320.   selected  then whenever the test is run, firstly the questions be randomised
  321.   so  they  will  be  presented in an unfamiliar order. The questions  however
  322.   remain  in  the  order that they were entered while you are on  the  editing
  323.   screen,  the  randomization's only takes place when the test is  run.  There
  324.   maybe  a  small  delay while this is done depending on  the  number  of  the
  325.   question.
  326.   
  327.   Choices Randomised: Again selecting this item pops up another 'yes' or  'no'
  328.   query boxing allow this feature to be turned on or off. When yes is selected
  329.   then  the  different  answer  for  each  question  will  be  shuffled  among
  330.   themselves  for  each question. This only randomises the  answers  for  each
  331.   question  individually  and  does  not change  the  answers  with  different
  332.   questions.  As with the previous option the answers remain in the  order  in
  333.   that which they were entered and only appear mixed up when the test is being
  334.   run.
  335.   
  336.   Number of Hints: The number of hints determines how many hints the user  can
  337.   use  while  a test is being run. A popup box prompts you for the  number  of
  338.   hints  you wish to make available. A value of zero indicates that  no  hints
  339.   are  to  be allowed. This option is independent of the number of hints  that
  340.   you  may  wish  to enter from the editor screen. When a test is  being  done
  341.   during the test the user may elect to 'use' up a hint and view the hint  for
  342.   that question.
  343.   
  344.   Inform Right/Wrong: This options again presents you with a yes/no query  box
  345.   allowing the user to select either yes or no. Selecting 'yes' to this  means
  346.   that  for every answer the user does during a test, the user will receive  a
  347.   message  informing them of whether they were right or wrong in there answer.
  348.   Setting  this option 'no' means that no information at all is giving  during
  349.   the  test of which questions have been answered correctly and which  wrongly
  350.   until the end of the test, where the total result is displayed.
  351.   
  352.   Display  Correct: This option lets you decide whether you want  the  correct
  353.   answer  to  be  given out if the user selects an wrong answer. This  options
  354.   makes  no  difference to questions that are answered correctly how ever  for
  355.   ones  that are answered incorrectly a message will be displayed telling  the
  356.   user what the correct answer is if this option is set to 'yes'.
  357.   
  358.   Verify  Test:  This function allows the person setting up the  questions  to
  359.   check the test for errors in the questions, this is automatically done  each
  360.   time  the test is run to prevent silly mistakes. Also 'The Examiner' program
  361.   also  verifies  the test each time the test is run. The  test  can  also  be
  362.   verified from the editor screen by pressing <F9>. The following is a list of
  363.   possible error messages and reasons.
  364.   
  365.   Error                     Cause
  366.   -----------------------   ----------------------------------
  367.   Blank Question            No data was entered in the
  368.                             question field of the screen
  369.                             (5 lines)
  370.   
  371.   No Choices                No choices were entered for the
  372.                             question (A to E)
  373.  
  374.   Only one choice           Only one answer was entered for
  375.                             the answers to a question. Must
  376.                             be at least two options to choose
  377.                             from.
  378.   
  379.   Invalid Answer            The answer specified for a
  380.                             question was not within the range
  381.                             of A to E, or is still blank.
  382.   
  383.   Selected Answer is Blank  The answer specified for a
  384.                             question contains a empty option.
  385.   
  386.   Run Test
  387.   ~~~~~~~~
  388.   
  389.   This  options does not have any submenu options, and allows you to  run  the
  390.   test  as  it  would  appear  in 'The Examiner' program.  Any  settings  like
  391.   randomising or time limits still have an effect here. The test is  displayed
  392.   on the screen and the user selects the answer they think is correct by using
  393.   the up/down arrow keys to move the highlite box to their selection. Pressing
  394.   <Enter>  selects  the  chosen  question and  any  right/wrong  messages  are
  395.   displayed (;f they are set - see the options menu for more details).
  396.   
  397.   Two  new pieces of information appear in the test window. One is the current
  398.   status.  The  first  number  indicates  the  number  of  questions  answered
  399.   correctly followed by the total number of questions so far answered. If  the
  400.   Inform  Right/Wrong option is turned off then this status message  will  not
  401.   appear,  otherwise it would allow the user to see which questions have  been
  402.   answered correctly.
  403.   
  404.   The second message is the number of hints. The first digit is the number  of
  405.   hints  that have been used so far in the test, followed by the total  number
  406.   of  hints allowed. If the hints are turned off from the options (ie. set  to
  407.   zero)  then  the  hints  status does not appear. If there  are  is  no  hint
  408.   available for the current question or if there are no more hints allowed for
  409.   the  test  then a beep will be issued when a hint is asked for  by  pressing
  410.   <F5> .
  411.   
  412.   Key command summary:
  413.   ~~~~~~~~~~~~~~~~~~~~
  414.   
  415.      Fl - Display Help screen.
  416.      F5 - Display hint, if available and if hints are allowed.
  417.      F8 - Pass question, same as when time expires.
  418.     F10 - Abort Test, and return to the editor screen.
  419.   Up/Dn - Move highlite box to selected answer.
  420.   
  421.   
  422.   Printing
  423.   ~~~~~~~~
  424.   
  425.   The  printing  menu allows questions to be printed. Several  selections  are
  426.   available  from this menu, these options allow different information  to  be
  427.   printed out.
  428.   
  429.   Current:  This  will print the current question you have  displayed  on  the
  430.   editor screen, including the answer and the hint (if there is one).
  431.   
  432.   Test:  This prints all the questions that are currently in memory, excluding
  433.   the  answers for each question. No hints are printed. Any blank lines in the
  434.   questions  are  also not printed as well as any answers which don't  contain
  435.   any  data.  The answers are printed after each question. Also if a  complete
  436.   question  will not fit on the bottom of a page without being split  up  then
  437.   the printer is advanced to the beginning of the next page.
  438.   
  439.   Questions  &  Answer: This prints all the questions that  are  currently  in
  440.   memory,  including the answers for each question. No hints are printed.  Any
  441.   blank  lines  in the questions are also not printed as well as  any  answers
  442.   which  don't contain any data. The answers are printed after each  question.
  443.   Also  if  a  complete question will not fit on the bottom of a page  without
  444.   being  split  up then the printer is advanced to the beginning of  the  next
  445.   page.
  446.   
  447.   Answers:  This just prints the answers for all the questions in a  tabulated
  448.   form.  No  other information is included, just the question number and  that
  449.   questions answer, like an answer sheet.
  450.   
  451.   Hints: This also like the answers option just prints the hints for questions
  452.   that have hints, questions without hints are automatically not printed.
  453.   
  454.   Answer  Sheet: This prints out a sheet with the correct number of  questions
  455.   and correct number of options for each question on, in a form so that it can
  456.   be filled in with the correct answer.
  457.  
  458.   Report  Heading:  This  prompts you for a title you may  wish  to  give  any
  459.   reports  printed.  This heading is printing at the top  of  the  pages  when
  460.   printing any of the above reports. This setting is saved with the questions,
  461.   so it only needs to be entered once.
  462.   
  463.   Several error messages are possible when printing, these are as follows:
  464.   
  465.   Printer  Out of Paper: The program detects that there is no paper loaded  in
  466.   the printer, to correct load paper into the printer.
  467.   
  468.   Printer  Off line: The printer is not on-line and can not receive any  data,
  469.   press the on-line button so the printer is ready to operate.
  470.   
  471.   Printer Busy: The printer is already printing, and more printing can not yet
  472.   be started.
  473.   
  474.   Printer  Problem: Some other problem other than the ones mention  above  has
  475.   occurred.
  476.   
  477.   For  more  information on how to load paper, and select on-line, etc  please
  478.   consult your
  479.   
  480.   Setup
  481.   ~~~~~
  482.   
  483.   These  menu  options deal with some of the main configuration settings.  All
  484.   the  settings  can  be set and saved to disk through the main  configuration
  485.   program,  'EDINST'. However these options allow certain settings to  changed
  486.   quickly and easily without having to load the setup program. Any changes  to
  487.   the  setup  options  here are not made permanent on  the  disk,  unless  the
  488.   'Update Config' on the menu is used.
  489.   
  490.   Test  Colours:  This  allows the colours used in the  testing  part  of  the
  491.   program to be changed. See the configuration section for more information.
  492.   
  493.   Sound: Sound can either be on or off. Turning off the sound prevents all the
  494.   beeps that can occur from the editor and test screens.
  495.   
  496.   Data  Dir:  This  lets  a  specific directory be used  for  the  storage  of
  497.   Educatabase  files This directory will be the default when  either  programs
  498.   are first loaded.
  499.  
  500.   Form  Length:  This allows the number of lines per page to be specified  for
  501.   the  size of paper that is being used in your printer. Once this many  lines
  502.   have  been printed the printer advances to the top of the next page by means
  503.   of a form feed.
  504.   
  505.   Form  Feed:  This  just advances the printer to the top of  the  next  page,
  506.   enabling the paper to be aligning ready for a print out.
  507.   
  508.   Printer  Output: This allows you to choose where you would like the  reports
  509.   printed  The  options are printer, screen, and file. The printer  being  the
  510.   most  common option The printer is port is set from within the setup program
  511.   (EDINST).  Selecting to print to the screen means that the questions  etc...
  512.   will  be  displayed  on the screen instead of being printed  on  a  printer.
  513.   Printing  to  a  file  further prompts you for a file name,  which  will  be
  514.   created  when  you print the data. The file will then just contain  all  the
  515.   data  that would have normally been printed, this allows the data to be used
  516.   in other programs that accept standard text files.
  517.   
  518.   Update  Config  This saves any changes made in this setup menu to  make  the
  519.   settings permanent on disk, for both the educater and examiner programs.
  520.  
  521.   
  522.   
  523.   The Examiner
  524.   ~~~~~~~~~~~~
  525.   
  526.   Once loaded a window displaying the program title, in this case - 'Examiner'
  527.   and  the  version number. Once a key is pressed this disappears the  program
  528.   continues. There are two main parts to this program, the pull down menus  at
  529.   the  top  of  the screen and the test screen, which is the majority  of  the
  530.   screen.  The pull down menus control the settings and allows the loading  of
  531.   questions  etc...  The  test  screen is where  the  questions  are  actually
  532.   displayed in the test, this remains blank until a test is actually run.
  533.   
  534.   When  the program is first loaded the option bar is placed of the file menu.
  535.   To  navigate the menus the arrow keys are used to move about. The left/right
  536.   keys move from one menu topic to the other, while the up/down keys move  the
  537.   highlite  selection bar to the desired option. The <Enter> key  will  select
  538.   the  current option. To select a menu item from the editor screen, hold down
  539.   the  <ALT> key and press the highlighted option of the menu you want.ie  for
  540.   the file menu you would hold down the <ALT> key and press <F> .
  541.  
  542.   The  Status  line at the bottom of the screen displays the filename  of  any
  543.   questions loaded and the total number of questions.
  544.   
  545.   
  546.   
  547.   File Menu
  548.   ~~~~~~~~~
  549.   
  550.   These  options  deal  mainly with the storage of disk files  etc...  However
  551.   unlike the 'Educater' program questions can only be loaded and not saved  to
  552.   disk,  as the 'The Examiner' does not allow any editing of the questions  to
  553.   be done.
  554.   
  555.   Load: This loads questions previously saved to disk. Firstly a entry box  is
  556.   displayed prompting the user for the file type to load, a default  of  'EDU'
  557.   extension is assumed, as this is the extension used by Educatabase.  However
  558.   this  can  be  changed if need be. When <Enter> is pressed the  file  window
  559.   appears  showing the files in the current directory that match the  filespec
  560.   specified (eg. '*.EDU'). Use the arrow keys to select the file that you wish
  561.   to load. Pressing <Space> while the file window is displayed will toggle the
  562.   layout  of  the files from three columns, to one column, when in one  column
  563.   mode  more  information is displayed about each file. Once a file  has  been
  564.   selected  a  check  is made to ensure you wish to load the  file.  The  load
  565.   option can also be selected from the editing screen by pressing < F3 > .
  566.   
  567.   Directory:  This displays all the files in the current directory,  which  by
  568.   default will be the data directory. As in the load option < Space >  can  be
  569.   used to toggle the output style of the files.
  570.   
  571.   Change  Dir:  This  allows a different directory to  be  used  as  the  data
  572.   directory.
  573.   
  574.   Quit: This just exists the program and returns you to DOS.
  575.   
  576.   See  your  DOS  manual  for  more information  on  file  names,  file  specs
  577.   (wildcards), extensions, and directories.
  578.   
  579.   
  580.   Run Test
  581.   ~~~~~~~~
  582.   
  583.   This  options does not have any submenu options, and allows you to  run  the
  584.   test.  Any  settings like randomising or time limits must be  set  when  the
  585.   questions are saved from 'The Educater'. The test is displayed on the screen
  586.   and  the  user selects the answer they think is correct by using the up/down
  587.   arrow  keys  to  move the highlite box to their selection. Pressing  <Enter>
  588.   selects  the chosen question and any right/wrong messages are displayed  (if
  589.   they are set - see the options menu in 'The Educater' for more details).
  590.   
  591.   Two  pieces  of  information appear in the test window. One is  the  current
  592.   status.  The  first  number  indicates  the  number  of  questions  answered
  593.   correctly followed by the total number of questions so far answered. If  the
  594.   Inform  Right/Wrong option is turned off then this status message  will  not
  595.   appear,  otherwise it would allow the user to see which questions have  been
  596.   answered correctly.
  597.   
  598.   The second message is the number of hints. The first digit is the number  of
  599.   hints  that have been used so far in the test, followed by the total  number
  600.   of  hints allowed. If the hints are turned off from the options (ie. set  to
  601.   zero)  then  the  hints  status does not appear. If there  are  is  no  hint
  602.   available for the current question or if there are no more hints allowed for
  603.   the test then a beep will be issued when a hint is asked for by pressing
  604.  
  605.   Pressing  <  F7 > will print the current question displayed on  the  screen,
  606.   excluding  the  correct  answer and any hints. <F10>  aborts  the  test  and
  607.   returns to the menus.
  608.   
  609.   
  610.   
  611.   Key command summary:
  612.   ~~~~~~~~~~~~~~~~~~~~
  613.   
  614.      F1 - Display Help screen
  615.      F5 - Display hint, if available and if hints are allowed
  616.      F7 - Prints the current question
  617.      F8 - Pass question, same as when time expires
  618.     F10 - Abort Test, and return to the menu screens
  619.   Up/Dn - Move highlite box to selected answer
  620.   
  621.   
  622.   Printing
  623.   ~~~~~~~~
  624.   
  625.   The  printing  menu allows questions to be printed. Several  selections  are
  626.   available  from this menu, these options allow different information  to  be
  627.   printed out.
  628.   
  629.   Test:  This prints all the questions that are currently in memory, excluding
  630.   the  answers for each question. No hints are printed. Any blank lines in the
  631.   questions  are  also not printed as well as any answers which don't  contain
  632.   any  data.  The answers are printed after each question. Also if a  complete
  633.   question  will not fit on the bottom of a page without being split  up  then
  634.   the printer is advanced to the beginning of the next page.
  635.   
  636.   Hints:  This  just print the hints for questions that have hints,  questions
  637.   without hint are automatically not printed.
  638.   
  639.   Answer  Sheet: This prints out a sheet with the correct number of  questions
  640.   and options for that question on, in a form so that it can be filled in with
  641.   the correct answer.
  642.   
  643.   Results: This option is only available once a test has been completed.  This
  644.   prints the statistics from the test. ie. the results that are displayed once
  645.   a test is finished.
  646.  
  647.   Several  error  messages are possible when printing,  please  refer  to  the
  648.   'Educater' section for a description of these.
  649.   
  650.   
  651.   
  652.   Setup
  653.   ~~~~~
  654.   
  655.   These  menu  options deal with some of the main configuration settings.  All
  656.   the  settings  Will be set and saved to disk through the main  configuration
  657.   program,  'EDINST'. However these options allow certain settings to  changed
  658.   quickly and easily without having to load the setup program. Any changes  to
  659.   the setup options here are not made permanent on the disk.
  660.   
  661.   Sound: Sound can either be on or off. Turning off the sound prevents all the
  662.   beeps that can occur from the editor and test screens.
  663.   
  664.   Data  Dir:  This  lets  a  specific directory be used  for  the  storage  of
  665.   Educatabase files.
  666.   
  667.   Form  Length:  This allows the number of lines per page to be specified  for
  668.   the  size of paper that is being used in your printer. Once this many  lines
  669.   have  been printed the printer advances to the top of the next page by means
  670.   of a form feed.
  671.   
  672.   Form  Feed:  This  just advances the printer to the top of  the  next  page,
  673.   enabling the paper to be aligning ready for a print out.
  674.   
  675.   Printer  Output: This allows you to choose where you would like the  reports
  676.   printed  The  options are printer, screen, and file. The printer  being  the
  677.   most  common option The printer is port is set from within the setup program
  678.   (EDINST).  Selecting to print to the screen means that the questions  etc...
  679.   will  be  displayed  on the screen instead of being printed  on  a  printer.
  680.   Printing  to  a  file  further prompts you for a file name,  which  will  be
  681.   created  when  you print the data. The file will then just contain  all  the
  682.   data  that would have normally been printed, this allows the data to be used
  683.   in other programs that accept standard text files.
  684.   
  685.   
  686.   Configuration
  687.   ~~~~~~~~~~~~~
  688.  
  689.   This  program lets you view and change any of Educatabase's settings.  These
  690.   options  can  be  saved  back to disk to make the  settings  apply  for  the
  691.   'Educater' and 'The Examiner' programs.
  692.   
  693.   Change Defaults: This option will pop up another menu with contains all  the
  694.   items  that  are  available on the options menu in 'The Educater'.  Each  of
  695.   these  options  lets  input  a  value like  you  normally  would  from  'The
  696.   Educater'.  However the options that are set here will become  the  defaults
  697.   when 'The Educater' is loaded.
  698.   
  699.   
  700.   Test  Colours:  This  allows the colours used in the  testing  part  of  the
  701.   program to be changed. A window is displayed showing all the different items
  702.   that can have different colours. Most items have a foreground and background
  703.   colour.  In some cases the background colour is already determined  from  an
  704.   overall background setting. Where the background option is not available  is
  705.   value  is  replaced with N/A for not applicable. The foreground entries  can
  706.   range  from 0 to 15 and the background entries can range from 0  to  7.  The
  707.   test  pattern  shows what the current colour selection looks like,  and  the
  708.   colour range at the bottom of the colour windows is purely for reference  to
  709.   see  what the range of colours look like. Pressing < Enter > moves from  the
  710.   colour item to the prompt allowing the colour value to be entered. The arrow
  711.   keys allow the colour to be modified to be selected.
  712.   
  713.   Editor  Colours: This firstly displays another menu, allowing the  item  you
  714.   wish to change to be selected. Once you have selected an item (eg. Pull down
  715.   menus)  another  window  similar to the one used for  the  Test  colours  is
  716.   displayed,  however the topics to change colours for will be  different  and
  717.   the sample windows will be different.
  718.   
  719.   Printer  Port: The selects the port the data will be send to  when  you  are
  720.   printing  to  a printer. Three choices are displayed on the screen  allowing
  721.   the  printer  to be selected. The normal and default will be LPT1  which  is
  722.   just  the  parallel port. Printing to serial ports can be achieved by  using
  723.   the  DOS MODE command to redirect printing. Please refer to your DOS  manual
  724.   for information regarding this.
  725.   
  726.   Form  Length:  This allows the number of lines per page to be specified  for
  727.   the  size of paper that is being used in your printer. Once this many  lines
  728.   have  been printed the printer advances to the top of the next page by means
  729.   of a form feed.
  730.  
  731.   Data  Dir:  This  lets  a  specific directory be used  for  the  storage  of
  732.   Educatabase  files. This directory will be the default when either  programs
  733.   are first loaded.
  734.   
  735.   Sound: Sound can either be on or off. Turning off the sound prevents all the
  736.   beeps that can occur from the editor and test screens.
  737.   
  738.   Save Setup: This records the settings to disk, so they will be used whenever
  739.   'The  Educater'  or  'The  Examiner' are used.  Note:  Both  'Educater'  and
  740.   'Examiner' programs use the same config file which is 'EDUCATER.CFG' on  the
  741.   disk.  If this file cannot be found then the programs own defaults  will  be
  742.   used.
  743.   
  744.   
  745.   
  746.   Installation
  747.   ~~~~~~~~~~~~
  748.   
  749.   Educatabase is best run from a hard disk however it is possible to use  twin
  750.   floppy drives. The installation procedure copies the files from the original
  751.   disk to the disk where the program will be used, and sets up the colours and
  752.   directories etc...
  753.   
  754.   If  the  Educatabase  files  are archived then it  is  simple  to  create  a
  755.   directory for the program, and a data directory, and extract the files  into
  756.   this  directory, and place the .EDU files into the data directory. Then  all
  757.   that  has  to be done is the EDINST program needs to run to create a  config
  758.   file,  you  need to specify the location of the data files. The  first  time
  759.   EDINST is run (with no CFG file) the default colours and settings are  used.
  760.   If  the  data directory is not specified then the current directory will  be
  761.   used.
  762.   
  763.   Error Messages
  764.   ~~~~~~~~~~~~~~
  765.   
  766.   File  not  found: An invalid file name was specified or the  file  does  not
  767.   exist on the disk.
  768.   
  769.   Path  not  found: An invalid path or filename was specified or the directory
  770.   could not be found.
  771.   
  772.   Access  denied: Access rights to particular files has been denied,  possibly
  773.   if the file is locked, or another user could be accessing the file.
  774.   
  775.   Not  enough memory: Insufficient computer memory was available to carry  out
  776.   the task.
  777.   
  778.   Disk  Read Error: A disk error preventing the correct operation of the  disk
  779.   files  has  occurred, probably due to bad sectors on the disk or a corrupted
  780.   hard disk.
  781.   
  782.   Disk Write Error: See 'Disk Read Error' above.
  783.   
  784.   Disk  is  write-protected: The disk you choose to save a file  to  is  write
  785.   protected preventing any files being saved on the disk.
  786.   
  787.   Drive not ready: A error when accessing the specified drive. Usually this is
  788.   when the diskette is not in the drive, or the drive door is not closed.
  789.   
  790.   Incorrect  File:  The  file  that  was  tried  to  be  loaded  was  not   an
  791.   'Educatabase' type file.
  792.   
  793.   File  exists,  Overwrite ?: A file by the name you  tried  to  save  already
  794.   exists on the disk, overwriting this file means that the contents of the old
  795.   file will be lost.
  796.   
  797.   Invalid  File Name: The characters specified in the file name were  invalid,
  798.   DOS filenames must contain only letters and or numbers.
  799.   
  800.   
  801.   
  802.   
  803.                                 EDUCATABASE
  804.   
  805.   
  806.                              REGISTRATION FORM
  807.   
  808.   
  809.   
  810.   
  811.   
  812.   Please fill out the following information:
  813.   
  814.  
  815.   Name:      _______________________________      Today's Date: _________
  816.   
  817.   
  818.   Title:     _______________________________
  819.   
  820.   
  821.   Company:   _______________________________
  822.   
  823.   
  824.   Address:   _______________________________
  825.   
  826.   
  827.              _______________________________
  828.   
  829.   
  830.   City:      _______________________________    Phone: (___) ____________
  831.   
  832.   
  833.   Country:   _______________________________    Fax:   (___) ____________
  834.   
  835.  
  836.   
  837.   Diskette Size:      __ 5 1/4 (1.2Mb)         __ 3 1/2 (720Kb)
  838.   
  839.   
  840.   Payment Type:       __ Money Order __ Check  __ Cash
  841.   
  842.   
  843.   Where did you get Educatabase:__________________________________________
  844.   
  845.   
  846.   Please mail this form with your cheque or money order for $40 (N.Z.) to:
  847.   
  848.   
  849.             Simon Griffiths
  850.             9 Raglan Street
  851.             Masterton
  852.             NEW ZEALAND
  853.   
  854.   
  855.   
  856.