home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / educ / test.zip / DOC.TST < prev    next >
Text File  |  1987-05-11  |  15KB  |  337 lines

  1. This is part of the documentation for the programs TEST1, TRAIN1 and TESTEST1.
  2.  
  3. The evaluation section should be placed at the top of the test file.
  4. As many evaluations as you wish can be present, but only one, the first
  5. that matches the score, will be shown. All others will be ignored.
  6. The first line of the evaluation section starts with :
  7.  
  8.                  this braket    {
  9.                  the lower limit of the evaluation,
  10.                  the upper limit of the evaluation,
  11.                  and this braket }
  12.  
  13. Each element separated from the next by ONE blank space.
  14.  
  15. The rest of the line will be ignored. You can use it for your own notes.
  16.  
  17. All lines following, up to the line with an = (equal) sign as the first
  18. character of the line, will show as the evaluation message.
  19.  
  20.  
  21. NOTE :  If you are using the TRAIN1.COM program, NO EVALUATION WILL SHOW
  22.         since the purpose of that program is to train, not to test.
  23.  
  24.  
  25. { 0 10 }   This line will never show on the screen.
  26.  
  27.         ┌─────────────────────────────────────────────────────────┐
  28.         │                                                         │
  29.         │    YOU WILL SEE THIS IF YOU SCORED BETWEEN 0 AND 10     │
  30.         │                                                         │
  31.         └─────────────────────────────────────────────────────────┘
  32.  
  33.  
  34. == The equal sign as the first sign on a line means this evaluation is over ==
  35.  
  36.  This line will never show on the screen.
  37.  
  38. { 11 50 }
  39.  
  40.     ┌──────────────────────────────────────────────────────────────────┐
  41.     │                                                                  │
  42.     │                                                                  │
  43.     │         Evaluation for a score between 11 and 50 included        │
  44.     │                                                                  │
  45.     │                                                                  │
  46.     │                                                                  │
  47.     └──────────────────────────────────────────────────────────────────┘
  48.  
  49. ==========================================================================
  50. { 51 100 }
  51.  
  52.  
  53.                THIS MESSAGE WILL BE SEEN IF YOUR  SCORE WAS
  54.  
  55.                   ┌────────────────────────────────────┐
  56.                   │                                    │
  57.                   │    Between 51 and 100 inclusive.   │
  58.                   │                                    │
  59.                   └────────────────────────────────────┘
  60.  
  61.     This means you got the question about how to get the update right....
  62.  
  63.                         Go for it, you'll like it !
  64. ===========================================================================
  65.  
  66. Make sure that you have covered all possible scores in your evaluation
  67. section. If not, the program will go in never-never land when searching
  68. for something that is not there.
  69.  
  70. The Question part of the test starts with this braket (
  71. followed by :
  72.                      The question number,
  73.                      The correct answer,
  74.                      The point value for answering correctly,
  75.  
  76.                      And ends with this braket )
  77.  
  78. Elements are separated from each other by ONE blank space.
  79.  
  80. A series of zeroes means that what is to come is not a question, but
  81. a notice that requires only to press < ENTER > to continue.
  82.  
  83. The following is one of such notices.
  84.  
  85. ( 0 0 0 )
  86. This is a documentation test for the TEST series of programs.
  87. It is intended to assist you in preparing your own tests.
  88.  
  89. Print out this file DOC.TST and look at it while you are running either
  90. the TRAIN1, the TEST1 or the TESTEST programs. This will give you an idea
  91. of what the programs are looking for in the test file.
  92.  
  93. For example, this is a NOTICE, not a question. You can see that the prompt
  94. at the bottom of the sceen is asking you to just enter < RETURN >  when
  95. you are trough reading the screen.
  96. ..........................................................................
  97. This message should never show on the screen.
  98. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  99.  
  100. The following is question number 1, the correct answer of which is Y(es),
  101. with a point value of 1 that will be added to your score when you aswer
  102. as expected.
  103.  
  104. The only answers that will be accepted will be Y or N ( and, if you are
  105. using the TEST1.COM program, H(old) to delay answering the question.).
  106.  
  107. Any other will be rejected.
  108.  
  109. ( 1 Y 1 )
  110. Evaluations will be shown when the test is completed, but only for the
  111. TEST1.COM or TESTEST1.COM programs.
  112.  
  113. Since the purpose of the TRAIN1.COM is not to test, but to train, the
  114. evaluations will not be shown, but instead a count of how many times an
  115. incorrect answer was entered will show. 
  116.  
  117.  
  118. As you can see, the prompt at the bottom has changed and now asks you for
  119. an answer, in this case Y(es) or N(o).
  120.  
  121.                              Is that correct ?
  122. ...........................................................................
  123. I assume you have answered No just in jest, otherwise we have problems.
  124. This message will show on the screen in TRAIN mode if you answered No.
  125. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  126.  
  127. ( 2 3 1 )  This line will never show on the screen.
  128.  
  129. The prompt has changed again. This program lests you use many different
  130. question formats freely. This is accomplished by the answer code  written
  131. at the beginning of the question.
  132.  
  133. With this program it is possible to :
  134.  
  135.                    1) Present notices that require no answer,
  136.                    2) Present different type of questions;
  137.                    3) All of the above.
  138. ............................................................................
  139. This message will be seen if you entered either 1 or 2, and you are using
  140. the TRAIN program to run this test file.
  141. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  142. ( 0 0 0 )
  143. It is possible to mix all of the following formats within the same test :
  144.  
  145.            Questions whose answer is either Yes or No;
  146.            Questions whose answer is either True or False;
  147.            Questions that offer three choices, named 1, 2  and 3;
  148.            Multiple choice questions, named A, B, C, D and E.
  149.  
  150. In addition, Notices  can be presented at any point.
  151. .............................................................................
  152. This should never be seen on screen.
  153. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  154. ( 3 E 1 )
  155. The different question formats available are questions whose answers can be :
  156.  
  157.                        A) Yes or No,
  158.  
  159.                        B) True or False;
  160.  
  161.                        C) 1, 2, or 3;      ( three choices );
  162.  
  163.                        D) A, B, C, D or E  ( multiple choice );
  164.  
  165.                        E) All of the above, plus NOTICES.
  166. .............................................................................
  167. All of the formats shown are available, and can be freely mixed within the
  168. same test file.
  169. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  170. ( 4 Y 1 )
  171. To control the prompt and the acceptable answers, you simply indicate at
  172. the beginning of that question what the question number, the correct answer
  173. and the point value for that question are.
  174.  
  175.                   Question :  Does that sound easy enough ?
  176. .............................................................................
  177.        If it does not sound easy now don't worry, it will soon.
  178. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  179. ( 5 T 1 )
  180. The Question part of the test starts with this braket (
  181. followed by :
  182.                      The question number,
  183.                      The correct answer,
  184.                      The point value for answering correctly,
  185.  
  186.                      And ends with this braket )
  187.  
  188. Elements are separated from each other by ONE blank space.
  189.  
  190.            For example, this question starts with  ( 5 T 1 )
  191. Meaning that it is Question # 5, The correct answer is True, and if you
  192. answer correctly you will get 1 point added to your score.
  193.  
  194.                  IT IS BEGINNING TO MAKE SOME SENSE
  195. ...........................................................................
  196. This will show only if you answered False.
  197. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  198. ( 6 3 2 )
  199. The point value can be assigned only to the one correct answer.
  200.  
  201.  
  202. This question starts with    ( 6 3 2 )
  203.  
  204. This means that :
  205.                     1) It is question number 6;
  206.  
  207.                     2) The correct answer is number 3;
  208.  
  209.                     3) All of the above, and you get 2 points for
  210.                        getting it right.
  211. ............................................................................
  212. If you got this wrong, review this test file again.
  213. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  214. ( 7 Y 2 )
  215. How does the program know what the prompt should look like, and what answers
  216. to or not to accept ?
  217. This is made possible because of SETS, meaning that each possible answer
  218. can belong only to a certain group. D has to mean a multiple choice,
  219. Y a yes or no, a number between 1 and 3 a three choice question, and so on.
  220.  
  221.            Question : Y means that it has to be a yes or no question.
  222. ............................................................................
  223. No ? What do you mean no ?
  224. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  225. ( 8 3 1 )
  226. The body of the question and the optional comment COMBINED can be up to
  227. 18 lines long. This means that the two togheter should not exceed that
  228. length, and that you can use all 18 lines for a question only if you
  229. are planning on NOT having any explanation for the trainer program to
  230. show when the answer is incorrect.
  231.  
  232.               1) The combined length ( question + comment )
  233.                  has a maximum of 18 lines;
  234.  
  235.               2) The question can use all the 18 lines, but
  236.                  then there will be no space for a comment;
  237.  
  238.               3) All of the above, and blank lines count.
  239. ...........................................................................
  240. Remember to count your lines....
  241. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  242.  
  243. ( 9 N 10 )
  244. The reserved marks ( at the beginning of a line ) are :
  245.    
  246. This braket    {     Means that the evaluation limits follow;
  247. The equal sign =     Means that the evaluation section is over;
  248. This braket    (     Means that information about the question follows;
  249. The period     .     Means that the question is over;
  250. The plus sign  +     Means that the comment on the question is over;
  251. The minus sign -     Means that all questions and comments are over;
  252. This sign      ~     Is used by the program. Do not use.
  253.  
  254. QUESTION : Can you use any of these signs AS THE FIRST CHARACTER OF A LINE
  255.            except as a mark for the above purposes ?
  256. ............................................................................
  257.                  You would mess up the program royally .....
  258. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  259. ( 0 0 0 )
  260. Print this file DOC.TST and the other demo files included.
  261. Run the demo tests while you are looking at the printouts.
  262. This will give you a better feel for how to prepare a test that any verbose
  263. explanation.
  264.  
  265. If your tests do not work correctly, go back and see what you did differently
  266. from the demos. Details count.
  267.  
  268. For example, REMEMBER BLANK SPACES between the information about the question.
  269.  
  270. These examples all work :  ( 100 a 76 )   ( 3 1 9 )   ( 2 f 3 )
  271. These will not              (100 a 76 )   ( 3 1 9)    ( f 2 3 )
  272.                             ^                    ^      ^ ^
  273.                                spaces missing            wrong sequence
  274. ............................................................................
  275. good bye....  please send some feedback.
  276. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  277.  
  278. ( 0 0 0 )
  279.               The update of the TEST programs allowes you to :
  280.  
  281. Start/Stop a timer from the test file. You can measure the total time spent
  282. on the test, as well as on individual sections.
  283.  
  284. Encode the test file, protecting it from prying eyes. The test file will work
  285. with coded or clear text files, switching automatically.
  286.  
  287. Check if the .RES file already exists, and modify its name if necessary in
  288. order not to overwrite it.
  289.  
  290. Date/time stamp the result file, and provide some protection from tampering.
  291.  
  292. Quite possibly, other features I haven't thought of yet.
  293. ............................................................................
  294.                               GET THE UPDATE !
  295. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  296. ( 10 E 58 )
  297. To receive the update, you should :
  298.  
  299.               A) Pass a test on binary trees handling while
  300.                  blindfolded and working with a chinese keyboard,
  301.  
  302.               B) Come to Juneau, Alaska to get the update in person;
  303.  
  304.               C) Write your own working updated program, send it to me
  305.                  and I will send it back to you;
  306.  
  307.               D) Think hard enough to warp time and space, and the update
  308.                  will appear, etched on your RAM;
  309.  
  310.               E) Send $ 11.88 ( that includes taxes and shipping ) to :
  311.                  Frank Lendaro, P.O.Box 1021, Douglas AK 99824
  312.                                 
  313. .............................................................................
  314. Good luck to you, if you want to try any other way but ... 
  315. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  316.  
  317.  
  318. --------------THIS ( the  -  sign ) MEANS THE TEST IS OVER  ---------------
  319.  
  320. You could put the evaluation section here, but that would increase the time
  321. that the program spends in searching for the correct information, since it
  322. starts lookin from the top of the file.
  323.  
  324.                   ┌─────────────────────────────────┐
  325.                   │                                 │
  326.                   │     All rights reserved         │
  327.                   │     Copyright 1987              │
  328.                   │                                 │
  329.                   │     Frank Lendaro               │
  330.                   │     P.O.Box 1021                │
  331.                   │     Douglas, AK 99824           │
  332.                   │                                 │
  333.                   │                                 │
  334.                   └─────────────────────────────────┘
  335.  
  336.                Your comments and suggestions are welcome.
  337.