home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / teaching / pc_quiz.zip / QUIZ.DOC < prev    next >
Text File  |  1987-06-15  |  33KB  |  993 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.  
  993.