home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / educ / quizzer.zip / QUIZ.DOC < prev    next >
Text File  |  1988-04-08  |  32KB  |  992 lines
  1.  
  2.  
  3.  
  4.                            Data Assist
  5.                          P. O. Box 26114
  6.                       Columbus, Ohio 43226
  7.  
  8.  
  9.                        P C - Q U I Z Z E R
  10.                            Version 2.0
  11.                             12-Jun-87
  12.  
  13. Copyright (c) 1987 - Data Assist. PC-QUIZZER is distributed
  14. through Shareware and is licensed for use to registered users.
  15. Non-registered users are entitled to use the product for
  16. evaluation purposes only. Copies of PC-QUIZZER may be distributed
  17. to other users for evaluation purposes.
  18.  
  19. Use of this software by any person or organization for any other
  20. purpose is prohibited. Educational or  Commercial use of this
  21. software and its documentation without a site license agreement
  22. is also prohibited.
  23.  
  24.  
  25.                           INTRODUCTION
  26.  
  27. PC-QUIZZER is Computer Aided Instruction (CAI) package designed
  28. for easy use while retaining many of the features found in
  29. expensive CAI packages. The product permits the user to create
  30. lessons without the requirement to learn a complex CAI
  31. programming language. The lesson is presented to the student
  32. using windows which contain options, questions, the answer
  33. prompt, and help. In addition, PC-QUIZZER permits the use of
  34. color text, color graphics, and music. A VOTRAX speech
  35. synthesizer may also be used to produce speech.
  36.  
  37. Throughout this document we will refer to 'the student' and 'the
  38. author'. The student is the person who is taking the quiz or
  39. lesson. The author is the person who is writting the lesson.
  40.  
  41. From the options menu the student is able to select features such
  42. as Immediate question retry, Repeat missed questions, Almost
  43. correct answer, Select questions based on keywords and others.
  44.  
  45. PC-QUIZZER lessons are text files which contain questions and
  46. commands which control the presentation of the questions. The
  47. questions used in a PC-QUIZZER lesson may be true/false, fill in
  48. the blank, multiple choice, or K-type multiple-choice.
  49.  
  50. The questions on the quiz may be given sequentially or randomly
  51. chosen by the computer. Questions that are missed are flagged for
  52. later retry, or they may be asked again immediately until the
  53. correct answer is given. Each question may contain multiple
  54. correct answers and incorrect answers. Various levels of help and
  55. other information may be included and is displayed when the
  56. student needs help or has entered a right or wrong answer.
  57.  
  58. Quiz files may be created using any standard ASCII text editor or
  59. word processor. The entire quiz file may be loaded into PC-
  60. QUIZZER or certain questions may be selected based on a list of
  61. keywords. Graphics images for use with PC-QUIZZER may be created
  62. with any graphics or painting package or by a BASIC program.
  63.  
  64.  
  65.  
  66.                                 1
  67.  
  68.  
  69.  
  70. Another PC-QUIZZER option permits answers that are "almost
  71. correct." This feature allows minor misspelled words to be
  72. accepted if the response is "similar" to the correct answer. For
  73. example: The response "Georg Washington" may be considered
  74. correct as the answer to "Who was the first President of the
  75. United States?"
  76.  
  77. PC-QUIZZER can be used for instruction in almost any subject
  78. including foreign languages, history, science, math, vocabulary
  79. and word definitions. It may also be used to ask trivia questions
  80. at your next party for hours of fun. PC-QUIZZER is an excellent
  81. educational tool and a must for everyone involved with learning
  82. or teaching.
  83.  
  84.  
  85.                           AVAILABILITY
  86.  
  87. PC-QUIZZER is available for the IBM PC and most compatibles. PC-
  88. QUIZZER requires only one disk drive and either a Monochrome,
  89. Color Graphics Adapter (CGA) or EGA. The system should have at
  90. least 128K of RAM memory. Color Graphics is only supported on a
  91. IBM compatible CGA or EGA.
  92.  
  93. PC-QUIZZER may be obtained through various PC User Groups, Public
  94. Domain software vendors, BBS's or directly from Data Assist.
  95.  
  96.  
  97.                      OPERATING INSTRUCTIONS
  98.  
  99. PC-QUIZZER is executed by typing 'QUIZ' from the MS-DOS '>'
  100. prompt. PC-QUIZZER will begin by displaying the title screen.
  101. Press the Return key to continue to the main menu.
  102.  
  103. The main menu contains several options which are used to load
  104. files and set parameters which control the way PC-QUIZZER
  105. operates. Simply press the key corresponding to the appropriate
  106. menu option.
  107.  
  108. The following section describes in greater detail the main menu
  109. options and how they are used.
  110.  
  111.  
  112.                         MAIN MENU OPTIONS
  113.  
  114.                  Option A - Allow Approx. Match
  115.  
  116. This option may be used to enable or disable PC-QUIZZER from
  117. allowing minor misspelled answers from being accepted as correct.
  118.  
  119. If this parameter is set to NO, the student must enter the answer
  120. exactly as specified in the QUIZ file.  Only an exact match will
  121. be accepted. PC-QUIZZER will always accept answers in either
  122. upper or lower case.
  123.  
  124. When this parameter is set to YES, PC-QUIZZER will determine if
  125. the answer entered by the student is "almost" like one of the
  126. correct answers given in the question entry. This feature may be
  127. used when the student should not be penalized for a minor mis-
  128. spelling of the answer.
  129.  
  130.  
  131.  
  132.                                 2
  133.  
  134.  
  135.  
  136.  
  137.                       Option B - Begin Quiz
  138.  
  139. This option is used to begin a quiz. Before you may begin a quiz
  140. you must load one into the computer by using either Option L or
  141. Option K. After the  quiz has completed you may repeat the quiz
  142. again by selecting Option B a second time without the need to
  143. reload the quiz file. Also see Option M.
  144.  
  145.  
  146.                 Option C - Display Correct Answer
  147.  
  148. This option is used to control if the correct answer is displayed
  149. whenever the student enters an incorrect answer.
  150.  
  151. If this parameter is set to NO, the correct answer will not be
  152. displayed. If this parameter is set to YES, the correct answer
  153. will be shown to the student.  You may choose to set this option
  154. to YES while the student is studying the subject matter or is
  155. taking a practice quiz.
  156.  
  157. Note: Should the question contain multiple correct answers, only
  158. the first correct answer will be displayed. Also see $ANSWER.
  159.  
  160.  
  161.                      Option E - Exit Program
  162.  
  163. This option will cause PC-QUIZZER to exit back to MS-DOS.
  164.  
  165.  
  166.                   Option H - Display Help Lines
  167.  
  168. This option controls whether PC-QUIZZER displays HELP lines
  169. during the quiz.
  170.  
  171. If this parameter is set to YES, the student may request help by
  172. entering a question mark while at the answer prompt. PC-QUIZZER
  173. will display a window containing any HELP lines given in the
  174. question entry. If this parameter is set to NO, then the help
  175. text will not be displayed.
  176.  
  177. If no help is available for a question and the student asks for
  178. help, an error messages will be displayed in the error window.
  179. This parameter should be set to YES during drill and practice
  180. sessions. Also see $HELP under the commands section.
  181.  
  182.  
  183.                    Option I - Immediate Retry
  184.  
  185. This option is used to control whether the student will be given
  186. a second (or third) chance to correctly answer a question.
  187.  
  188. If the Immediate Retry option is set to YES, the student is given
  189. three attempts to supply a correct answer to a question. If the
  190. Immediate Retry option is set to NO, the student will be given
  191. only one try to enter the correct answer. If the student enters
  192. an incorrect answer, the question will be graded as wrong.
  193.  
  194. The student may retry the missed question at a later time by
  195. choosing option M on the main menu. Also see Option M.
  196.  
  197.  
  198.                                 3
  199.  
  200.  
  201.  
  202.  
  203.                      Option K - Keyword Load
  204.  
  205. This option performs the same function as Option L except that
  206. the student may specify a list of keywords. The keywords are used
  207. to select questions from the quiz file.
  208.  
  209. After the student has specified the quiz filename, PC-QUIZZER
  210. will display a keyword window. The keywords are entered into this
  211. window, and the arrow keys may be used to move around the inside
  212. of the window. When all the keywords have been entered the END
  213. key is used to terminate the list. The keywords may be entered in
  214. either upper or lower case.
  215.  
  216. When searching the quiz file, PC-QUIZZER will select only those
  217. question which contain one or more of the keywords within the
  218. text of the question. Also see Option L and $KEY under the
  219. commands section.
  220.  
  221. Example: Use Option K to load the STATES demo file and specify
  222. the name of your state and the name of each of your adjacent
  223. states.
  224.  
  225.                        Option L - Load All
  226.  
  227. This option is used to Load All questions from a quiz file. All
  228. of the questions will be loaded and selected.  After the quiz
  229. file has been loaded, select Option B to begin the quiz. Also see
  230. Option K.
  231.  
  232.  
  233.                     Option M - Repeat Missed
  234.  
  235. After completing a quiz, Option M may be used to repeat any
  236. questions that were missed. Option M may be repeated over and
  237. over again until no more questions are missed. The field 'Wrong:'
  238. on the main menu indicates the number of questions which will be
  239. selected if Option M is specified.
  240.  
  241.  
  242.                      Option R - Random Mode
  243.  
  244. This option tells PC-QUIZZER to randomize the questions before
  245. they are asked.  This is a very useful study technique. Random
  246. mode is the opposite of Sequential Mode. Also see Option S.
  247.  
  248.  
  249.                    Option S - Sequential Mode
  250.  
  251. This option is the opposite of random mode. If sequential mode is
  252. specified, PC-QUIZZER will present the questions in the same
  253. order as they appear in the quiz file. This is the default mode.
  254. Also see Option R.
  255.  
  256.                     Option V - VOTRAX Output
  257.  
  258. If your computer has a VOTRAX Type'n Talk (or Personal Speech
  259. System) you may select option V to tell PC-QUIZZER to use your
  260. VOTRAX. PC-QUIZZER will "speak" the questions and other messages
  261. to the student.
  262.  
  263.  
  264.                                 4
  265.  
  266.  
  267.  
  268.  
  269. Note: PC-QUIZZER requires an initialization file to define the
  270. VOTRAX communications port. Registered user should contact Data
  271. Assist for an Applications Note which describes how to set up the
  272. port before using their VOTRAX device. Registered users with a
  273. speech synthesizer other than a VOTRAX may also contact Data
  274. Assist for possible support.
  275.  
  276.                  CREATING YOUR OWN LESSON FILES
  277.  
  278.  
  279. Lesson files, or quiz files, may be created using any standard
  280. text editor or word processor. If a word processor is used be
  281. sure that the non-document or ASCII mode is used.
  282.  
  283. Questions are organized into question entries. Each entry
  284. contains the text of the question, one or more correct answers,
  285. any anticipated incorrect answers and optional text to be dis-
  286. played for various conditions. The question entry begins with a
  287. '$QUE' command and ends with a '$EOQ' command. Each line of text
  288. between these two commands is part of the question entry. Up to
  289. 100 questions may be contained in a single quiz file.
  290.  
  291.  
  292.                          SIMPLE COMMANDS
  293.  
  294. A question entry must contain at least three PC-QUIZZER
  295. statements.
  296.  
  297. Example:
  298.  
  299. $QUESTION      <-- marks the start of a question
  300. What is 1+1?
  301. $ANSWER 2      <-- indicates a correct answer
  302. $EOQ           <-- marks the end of the question
  303.  
  304.  
  305. Each PC-QUIZZER command begins with a dollar sign which must
  306. start in column one. The command name may be abbreviated to three
  307. character, but no less!
  308.  
  309. Lets take a more detailed look at the three commands that were
  310. just used.
  311.  
  312.  
  313. Command: $QUESTION
  314.  
  315. Syntax:  $QUESTION [name]
  316.  
  317. Description:
  318.  
  319. This command marks the begining of a question. The question may
  320. optionally contain a name from 1 to 8 characters in length.
  321. Although you do not need to name a question,  if a name is  used,
  322. it must be unique.
  323.  
  324. Following the $QUESTION statement is the body of the question.
  325. This text is displayed in the question window when PC-QUIZZER
  326. asks the student this question.
  327.  
  328.  
  329.  
  330.                                 5
  331.  
  332.  
  333.  
  334.  
  335. Command: $ANSWER
  336.  
  337. Syntax:  $ANSWER answer-string
  338.  
  339. Description:
  340.  
  341. The $ANSWER command tells PC-QUIZZER what the correct answer to
  342. a question is. A question may contain multiple correct answers
  343. but each correct answer must be specified on a different
  344. $ANSWER command.
  345.  
  346. After the $ANSWER statement you may have additional lines of
  347. text. These lines will be displayed in the question window if
  348. this answer matches that given by the student. If your question
  349. has multiple correct answers, you may have different responses
  350. for each possible correct answer.
  351.  
  352.  
  353. Command: $EOQ
  354.  
  355. Syntax:  $EOQ
  356.  
  357. Description:
  358.  
  359. This command marks the End of the Question (EOQ). It must be the
  360. last statement is the question entry. Its purpose is to mark the
  361. end of the question and all the additional commands and text
  362. lines which are part of the question entry.
  363.  
  364.  
  365.                   HELP AND INFORMATION COMMANDS
  366.  
  367. Command: $HELP
  368.  
  369. Syntax:  $HELP
  370.  
  371. Description:
  372.  
  373. The $HELP command marks the beginning of a HELP block. The lines
  374. following the $HELP statement (until the next command) will be
  375. displayed if the student enters a '?' to the Answer prompt. If
  376. menu option H is set to OFF then PC-QUIZZER will not provide the
  377. student with help.
  378.  
  379. The HELP text is displayed in the HELP window.
  380.  
  381.  
  382. Command: $RIGHT
  383.  
  384. Syntax: $RIGHT
  385.  
  386. Description:
  387.  
  388. The $RIGHT command begins a block of text which is displayed
  389. whenever the student enters any answer that is correct. This
  390. statement is typically used when the question has multiple cor-
  391. rect answers.
  392.  
  393.  
  394.  
  395.  
  396.                                 6
  397.  
  398.  
  399.  
  400. Command: $WRONG
  401.  
  402. Syntax:  $WRONG
  403.  
  404. Description:
  405.  
  406. The $WRONG command is similar to the $RIGHT command except that
  407. the block of text is displayed only when the student enters a
  408. wrong answer.
  409.  
  410.  
  411. Command: $NOT
  412.  
  413. Syntax:  $NOT incorrect-answer-string
  414.  
  415. Description:
  416.  
  417. The $NOT command is similar to the $ANSWER command except that it
  418. specifies an incorrect answer. The text block following the $NOT
  419. statement will be displayed in the question window if the student
  420. enters an incorrect answer which matches the incorrect-answer-
  421. string. A question entry may contain more than one $NOT command.
  422.  
  423.  
  424.                      COLOR GRAPHICS COMMANDS
  425.  
  426.  
  427. PC-QUIZZER supports color graphics through the use of BASIC BSAVE
  428. files. While there are better ways to store graphic images, the
  429. BSAVE format is already supported by many graphics editors,
  430. utilities, and slide show systems. For this reason it is possible
  431. to create graphic images for PC-QUIZZER using many different
  432. tools which already exist.
  433.  
  434. Registered users may write to Data Assist for an Applications
  435. Note which describe how to use various graphic editors and
  436. utilities to create picture files useable with PC-QUIZZER.
  437.  
  438.  
  439. Command: $CGA
  440.  
  441. Syntax:  $CGA mode picture-file-name
  442.  
  443. Description:
  444.  
  445. The $CGA command is used to display a Color Graphic image.
  446. The mode parameter specifies the video mode needed to display the
  447. graphic image. Currently only modes 4, 5 (medium resolution) and
  448. 6 (high resolution) are supported.
  449.  
  450. Picture-file-name is the name of a disk file which contains the
  451. color graphic image. The complete file path name must be given.
  452. The graphic image must be stored in BSAVE format. If possible you
  453. should store the graphic images on a RAM disk. This greatly
  454. speeds up graphics with PC-QUIZZER. Also see $PCOLOR and demo
  455. file USA.QIZ.
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.                                 7
  463.  
  464.  
  465.  
  466. Command: $PCOLOR
  467.  
  468. Syntax:  $PCOLOR pallet-number
  469.  
  470. Before using the $CGA command you should set the desired pallet-
  471. number by using the $PCOLOR command. The pallet-number may be
  472. either 0 or 1 on a Color Graphics Adapter.
  473.  
  474.  
  475. Command: $PAINT
  476.  
  477. Syntax:  $PAINT x-loc y-loc color-code
  478.  
  479. Description:
  480.  
  481. The $PAINT command is used to paint an area of the screen. The x-
  482. loc and y-loc specify the starting x and y location of the area
  483. to paint. PC-QUIZZER will paint the area using the color-code
  484. specified. The area to be painted must be outlined with a color
  485. different from the present color of the area. See demo file
  486. USA.QIZ.
  487.  
  488. Note: $PAINT should NOT be used to paint complex areas of the
  489. screen. Doing so may cause the stack to overflow and the PC to
  490. lock up!!!
  491.  
  492.  
  493. Command: $ASK
  494.  
  495. Syntax:  $ASK prompt-string
  496.  
  497. Description:
  498.  
  499. The $ASK command may only be used in conjunction with the $CGA
  500. command. The purpose of the $ASK command is to prompt the student
  501. for an answer while the graphic screen is displayed. If the $ASK
  502. command is not used, PC-QUIZZER will return to the text screen
  503. and prompt the student for an answer. If $ASK is used while a
  504. text screen is currently displayed, it will be ignored. See demo
  505. file USA.QIZ.
  506.  
  507.  
  508.                COLOR AND MONOCHROME TEXT COMMANDS
  509.  
  510. When using a color monitor you may wish to display characters of
  511. different colors in your text displays.  This is accomplished  by
  512. using the $TEXT command along with $TCOLOR or $TATTRIB.
  513.  
  514. Command: $TEXT
  515.  
  516. Syntax:  $TEXT text-string
  517.  
  518. Description:
  519.  
  520. The $TEXT command displays the text-string in the question
  521. window. If the text string contains sub-strings enclosed inside
  522. of {} characters, these sub-strings will be colored using the
  523. color codes specified by the $TCOLOR or $TATTRIB commands. Each
  524. group of sub-strings may be colored differently. Up to ten sub-
  525. strings may occur within one text-string.
  526.  
  527.  
  528.                                 8
  529.  
  530.  
  531.  
  532.  
  533. Command: $TCOLOR
  534.  
  535. Syntax:  $TCOLOR index f-color b-color [BLINK]
  536.  
  537. The $TCOLOR command defines a foreground color and background
  538. colors for use with the $TEXT command. The index may range from 1
  539. to 10. You may optionally use the modifier  BLINK to select a
  540. blinking color. The $TCOLOR statement must come before the first
  541. $TEXT statement within a question entry.
  542.  
  543. Up to ten different color groups may be defined and used per
  544. $TEXT command. Once the colors are defined by $TCOLOR, they may
  545. be used by multiple $TEXT commands within the same question
  546. entry. See demo file TCOLOR.QIZ.
  547.  
  548. The color codes which may be specified for f-color and b-color
  549. are: Black, Blue, Green, Cyan, Red, Magenta, Brown, White, Grey,
  550. LBlue, LGreen, LCyan, LRed, LMagenta, Yellow and LWhite.
  551.  
  552. Example:
  553.  
  554. $QUE
  555. $TCOLOR 1 BLACK WHITE
  556. $TCOLOR 2 WHITE BLACK BLINK
  557. $TCOLOR 3 RED BLACK
  558. $TEXT This is {Reversed}. This is {Blinking}. This is {RED}.
  559. And this is a normal line of text...
  560. $TEXT What does {1+1} equal?
  561. $ANS 2
  562. $EOQ
  563.  
  564.  
  565. Command: $TATTRIB
  566.  
  567. Syntax:  $TATTRIB index f-attrib b-attrib
  568.  
  569. Description:
  570.  
  571. The $TATTRIB command provides an alternate, shorthand method to
  572. specify foreground and background colors. This command performs
  573. the same function as $TCOLOR however numeric attribute (color)
  574. codes are used rather that the symbolic codes as used by
  575. $TCOLOR. $TATTRIB also provided the ability to specify attributes
  576. for use with Monochrome monitors and color display adapters which
  577. use non-standard color attributes. See demo file MONO.QIZ.
  578.  
  579.  
  580.                        ADDITIONAL COMMANDS
  581.  
  582. Command: $KEY
  583.  
  584. Syntax:  $KEY keyword-1 keyword-2 ...
  585.  
  586. Description:
  587.  
  588. The $KEY command gives the author the ability to enter additional
  589. keywords into a question entry. The keyword(s) specified on the
  590. $KEY statement are used by menu option K when a Keyword Load is
  591. requested.
  592.  
  593.  
  594.                                 9
  595.  
  596.  
  597.  
  598.  
  599. Command: $PRESS
  600.  
  601. Syntax:  $PRESS
  602.  
  603. Description:
  604.  
  605. The $PRESS command will cause PC-QUIZZER to display 'Press Enter
  606. to continue.' in the answer window. The lesson will pause until
  607. the student presses the Enter key or the Return key. The command
  608. may be used to divide up a large questions into smaller para-
  609. graphs which fit inside of the question window. Another use for
  610. the $PRESS command is just prior to the use of a $CGA command.
  611. This allows the student an opportunity to read a question before
  612. being presented with a graphic image.
  613.  
  614.  
  615. Command: $PLAY
  616.  
  617. Syntax:  $PLAY music-string
  618.  
  619. Description:
  620.  
  621. The $PLAY command is used to play music. The music-string
  622. contains an expression which describes the music to be played.
  623. The music string uses a format similar to the PLAY statement in
  624. BASIC. See demo file MUSIC.QIZ.
  625.  
  626. A-G: plays this note in the current octave.
  627. On: sets n as the current octave. (0..6)
  628. Nn: plays note n. (0..84)
  629. Ln: set the length of the following notes. (1..64)
  630. Pn: set the length of a rest. (1..64)
  631. Tn: sets the number of quarter notes in a minute (32..255)
  632. >n: plays not n in the next higher octave.
  633. <n: plays not n in the next lower octave.
  634. ML: play complete period of Ln value.
  635. MN: play 7/8 time of Ln value.
  636. MS: play 3/4 time of Ln value.
  637.  
  638. Example:
  639.  
  640. $QUE
  641. Name this tune...
  642. $PLAY T120L4MNO4C8C8DCFE2C8C8DCGF2C8C8O5CO4A
  643. $PLAY FED2T90B-8B-8AFGF2
  644. $ANS HAPPY BIRTHDAY
  645. That was an easy one.
  646. $EOQ
  647. ...
  648.  
  649. Command: $SLEEP
  650.  
  651. Syntax:  $SLEEP seconds
  652.  
  653. Description:
  654.  
  655. The $SLEEP command causes PC-QUIZZER to sleep for the specified
  656. number of seconds.
  657.  
  658.  
  659.  
  660.                                10
  661.  
  662.  
  663.  
  664.                         K-TYPE QUESTIONS
  665.  
  666. Command: $KTYPE
  667.  
  668. Syntax:  $KTYPE code
  669.  
  670. Description:
  671.  
  672. PC-QUIZZER provides a facility to accept K-type questions. The K-
  673. type question format is often used on professional examinations.
  674. A K-type question contains 4 items of which 1 or more are true.
  675. The answer is either A, B, C, D, or E and is formed using these
  676. fixed rules:
  677.  
  678. The answer is A if items 1, 2 and 3 are true.
  679. The answer is B if items 1 and 3 are true.
  680. The answer is C if items 2 and 4 are true.
  681. The answer is D if only item 4 is true.
  682. The answer is E if items 1, 2, 3 and 4 are true.
  683.  
  684. Example:
  685.  
  686. $QUE
  687. Which of the following Presidents were in office before 1850?
  688.  
  689.      1. George Washington
  690.      2. Ronald Reagan
  691.      3. Andrew Jackson
  692.      4. Abraham Lincoln
  693. $ANS B
  694. $! B means that 1 and 3 are true.
  695. $KTYPE 1
  696. George Washington's term began in 1789.
  697. $KTYPE 2
  698. Ronald Reagan's term began in 1981.
  699. $KTYPE 3
  700. Andrew Jackson's term began in 1829.
  701. $KTYPE 4
  702. Abraham Lincoln's term began in 1861.
  703. $EOQ
  704.  
  705. The correct answer in this example is B, which means that (1)
  706. George Washington and (3) Andrew Jackson were both in office
  707. before 1850 and the others were not.
  708.  
  709. Should the student incorrectly answer this question, PC-QUIZZER
  710. will use the text following the corresponding $KTYPE statement to
  711. display why the specified answer was wrong.
  712.  
  713. Note: In order for PC-QUIZZER to properly ask a K-type question,
  714. the above format must be used. For more insight into using K-type
  715. questions experiment using the sample file KTYPE.QIZ on the
  716. distribution disk.
  717.  
  718. Note: KTYPE questions may not be used in conjunction with Graphic
  719. Screens.
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.                                11
  727.  
  728.  
  729.  
  730.                      ADDITIONAL INFORMATION
  731.  
  732. PC-QUIZZER may be used on a Monochrome Monitor or a Color
  733. Graphics Monitor. The program defines 6 windows which are used
  734. for all screen displays. They are numbered as follows:
  735.  
  736.      1 - Main Menu Window
  737.      2 - Question & File Load Window
  738.      3 - Answer Window
  739.      4 - Help & Keyword Load Window
  740.      5 - Error Window
  741.      6 - Grade Window
  742.  
  743. On a Monochrome system each window appears the same color.  On a
  744. color system PC-QUIZZER defines each window using just black and
  745. white. Currently these colors are not changeable through a PC-
  746. QUIZZER command  or menu option. Registered users who wish to
  747. change the default window colors may request an Application Note
  748. from Data Assist which describes how to set the foreground and
  749. background color of each window.
  750.                                ---
  751.  
  752. PC-QUIZZER uses direct memory I/O to the video screen. While this
  753. technique is very fast, it is also prone to not work correctly on
  754. some not-so-compatible computers. Should PC-QUIZZER not work
  755. correctly on your system, you may request a version which uses
  756. MS-DOS I/O; a slow but sure method of doing I/O. You must be a
  757. registered user in order to purchase the MS-DOS I/O version.
  758.                                ---
  759.  
  760. PC-QUIZZER permits all responses to be entered in upper or lower
  761. case. This includes menu options as well as keywords and question
  762. answers.
  763.                                ---
  764.  
  765. When entering True/False questions into the quiz file, the author
  766. should enter "$ANSWER T" or "$ANSWER F" as the correct answer.
  767. This will enable the student to enter "T", "F", "TRUE" or "FALSE"
  768. as their answer.
  769.  
  770.                           RESTRICTIONS
  771.  
  772. A maximum of 100 questions may be entered into a question file.
  773. Depending on the size of the questions and amount of memory in
  774. your computer, It is possible to exceed memory before 100
  775. questions have been loaded.
  776.  
  777. The length of each quiz text line should not exceed 100
  778. characters.
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.                                12
  793.  
  794.  
  795.  
  796.                          ERROR MESSAGES
  797.  
  798. Can't open the quiz file. Please try again -- The quiz file
  799. specified does not exist or the filename was entered incorrectly.
  800.  
  801. Illegal CGA mode -- Only CGA modes 4, 5 and 6 are supported in
  802. this version of PC-QUIZZER. See section on $CGA command.
  803.  
  804. Illegal command or parameter -- A command was read from the quiz
  805. file which is either an unknown command or is a legal command
  806. which contains an illegal parameter. Correct the statement and
  807. try again.
  808.  
  809. Maximum of 100 questions loaded -- A maximum of 100 questions
  810. were loaded from the quiz file. PC-QUIZZER will only use the
  811. first 100 questions on the quiz. 300 questions for site licensed
  812. copies.
  813.  
  814. No questions are currently selected -- Before entering option B
  815. to begin a quiz, you must load a quiz file using either option K
  816. (Keyword Load) or option L (Load All).
  817.  
  818. No questions were missed -- An attempt has been made to use
  819. option M when there are no questions marked as being missed. See
  820. discussion of option M.
  821.  
  822. Not enough memory -- PC-QUIZZER was unable to allocate enough
  823. memory to work correctly. For most quiz files, 128K of memory
  824. should be sufficient.
  825.  
  826. Question entry is missing an answer -- A question does not
  827. contain an $ANSWER statement. PC-QUIZZER will skip this question.
  828.  
  829. Quiz file is empty. Please try another file -- The file you are
  830. trying to load into PC-QUIZZER does not contain any questions.
  831. Are you sure that you specified the correct name of a quiz file?
  832.  
  833. This question does not have an answer. Skipping on  -- PC-QUIZZER
  834. is trying to ask you a question which does not have an answer.
  835. Edit the quiz file and be sure that each question entry has at
  836. least one $ANSWER command with the correct answer specified. See
  837. also $ANSWER.
  838.  
  839. Too many lines read -- The quiz file you are loading is too big
  840. for  the version of PC-QUIZZER that you have.  (3000 lines)  Make
  841. the quiz smaller and try again.
  842.  
  843. Unable to load picture -- While executing a $CGA command, PC-
  844. QUIZZER was unable to locate the file which contains the graphic
  845. image. Make sure that the picture file exists in the path you
  846. specified on the $CGA command.
  847.  
  848. Unable to open VOTRAX port -- PC-QUIZZER could not open the port
  849. which drives the VOTRAX unit. Make sure that the port is
  850. configured into your system.
  851.  
  852. VOTRAX port is unknown to PC-QUIZZER -- Prior to using the VOTRAX
  853. device with PC-QUIZZER you must create an initialize file which
  854. sets up the port. Contact Data Assist for support.
  855.  
  856.  
  857.  
  858.                                13
  859.  
  860.  
  861.  
  862.                           SAMPLE FILES
  863.  
  864. Several sample quiz files have been included on the distribution
  865. diskette. These files are intended to show examples of the format
  866. used to build your own lesson files. We suggest that you
  867. experiment with these files to help you better understand how to
  868. use PC-QUIZZER.
  869.  
  870.                             REQUESTS
  871.  
  872. Data Assist has designed PC-QUIZZER to be both flexible and easy
  873. to  use. Like any software package there are numerous improve-
  874. ments and additions which could be made.  We have received
  875. several requests and invite you to submit written requests at any
  876. time.
  877.  
  878. Registered users are also permitted to "vote" for the requests
  879. they would like to see implemented. To vote, simply mail us a
  880. letter indicating which requests from the list below you would
  881. like to see implemented. Those items which get the most votes
  882. will get the most attention in future releases. Be sure to
  883. include your own requests or comments if you have any.
  884.  
  885. We believe that registered users should have a voice in future
  886. enhancements to PC-QUIZZER  and we invite your input.
  887.  
  888.  
  889. REQ001: Add EGA graphics support.
  890.  
  891. REQ002: Add an $INCLUDE command to include files.
  892.  
  893. REQ003: Save scores on disk with student names.  Also a list of
  894. which questions they missed would be nice.
  895.  
  896. REQ004: Allow colors to be used in help messages.
  897.  
  898. REQ005: Would like to save a quiz in the middle and resume at a
  899. later time.
  900.  
  901. REQ006: Need to have multiple part questions. i.e. here is some
  902. text, and these five questions are about this text. The GMAT has
  903. questions like this.
  904.  
  905. REQ007: Would like to be able to change menu options like
  906. A,C,H,R,S and I in the middle of the quiz.
  907.  
  908. REQ008: Would like to 'preview' a lesson. i.e. have the computer
  909. ask the questions and show  me the answer. Then I can practice
  910. typing in the answers. Later on I will take the quiz and enter
  911. the answers the normal way. Many times I just want to learn how
  912. to spell the answers and this would sure help.
  913.  
  914. REQ009: Provide an option to scan a quiz and mark the questions
  915. to be selected. It would be nice if the selected questions could
  916. be written back to disk as another quiz. COMMENT: You should be
  917. able to do this with a good text editor. Will consider.
  918.  
  919. REQ010: Sometimes I find typo errors in my questions.  I'd like
  920. to be able to call up an editor while in PC-QUIZZER and fix it.
  921.  
  922.  
  923.  
  924.                                14
  925.  
  926.  
  927.  
  928. REQ011: For very large questions, I'd like to be able to scroll
  929. back and forth in the window. Need this capability on the HELP
  930. window too.
  931.  
  932. REQ012: I would like to say "Skip question M if I got question N
  933. right." Or "Skip question M if I got question N wrong..."
  934.  
  935. REQ013: Need to have numeric answer ranges. Example: the square
  936. root of 2 is?  1.41 --> 1.414213
  937.  
  938. REQ014: The ability to load selected questions from multiple quiz
  939. files using keywords. (or Load All from multiple files).
  940.  
  941.  
  942.                         ACKNOWLEDGEMENTS
  943.  
  944. PC-QUIZZER was written in Turbo C from Borland International. The
  945. source is over 3,100 lines of C code. About 10% of the code is
  946. in-line assembler.  We have found the Turbo C compiler to be very
  947. fast and highly recommend it.
  948.  
  949.                           REGISTRATION
  950.  
  951. PC-QUIZZER is licensed for use to registered users only. The cost
  952. of the registration is $25.  If you wish to receive the next
  953. release when it becomes available, add an additional $10 to your
  954. order and specify the version number of the release you are
  955. currently using.
  956.  
  957.  Registered users receive:
  958.  
  959.    * Limited telephone support
  960.    * Notice of future releases
  961.    * Access to Public Domain lesson files
  962.    * Access to Application Notes
  963.    * The right to request new features
  964.    * Voting rights for new features
  965.  
  966. Some PC-QUIZZER users have asked about the availability of
  967. existing quiz files. In the interest of our users, Data Assist is
  968. collecting quiz and picture files with the intent of releasing a
  969. PC-QUIZZER library. All REGISTERED users will receive a notice
  970. when this library is available.
  971.  
  972. Should you develop a QUIZ file that you believe other people
  973. could use, please send it to Data Assist. Any user who submits a
  974. quiz file which we include in the library will receive a free
  975. update to PC-QUIZZER and a copy of the library.
  976.  
  977. Thank you for your support and we hope you enjoy using
  978. PC-QUIZZER.
  979.  
  980.                            TRADEMARKS
  981.  
  982. MS-DOS is a registered trademark of Microsoft.
  983. IBM-PC is a registered trademark of IBM Corporation.
  984. PC-QUIZZER is a trademark of Data Assist.
  985. Turbo C is a registered trademark of Borland International.
  986. VOTRAX  and  Type'n  Talk are trademarks of  VOTRAX Corporation.
  987.  
  988.  
  989.  
  990.                                15
  991.  
  992.