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

  1.  
  2.  
  3.            DOCUMENTATION FOR TEST1.COM, TRAIN1.COM, TESTEST1.COM
  4.  
  5. _____________________________________________________________________________
  6.                                                                          
  7.     The described programs, the program names and their documentation are
  8.  
  9.     Copyright 1987  Frank Lendaro          P.O.Box 1021, Douglas AK 99824
  10. _____________________________________________________________________________
  11.  
  12.                  
  13.                    This software product and manual are being
  14.                    distributed under the USER SUPPORTED SOFT-
  15.                    WARE concept.  The software and manual are
  16.                    copyrighted material; they are NOT in the
  17.                    public domain.  However, you are encouraged
  18.                    to help distribute this product by sharing
  19.                    it with friends and associates, subject to
  20.                    the following rules:
  21.                    1)  You may not SELL copies of the diskette
  22.                        containing the software and manual for
  23.                        more than your cost of reproduction.
  24.                    2)  Copies of the PRINTED manual may not be
  25.                        distributed.
  26.                    3)  The software and documentation may not
  27.                        be altered.
  28.                    4)  The entire contents of the distribution
  29.                        diskette must be included on any copies.
  30.                        This includes: TRAIN1.COM,TEST1.COM,
  31.                        TESTEST1.COM,TEST.DOC,DOC.TST,DEMO.TST.
  32.  
  33.                    If you like this product, you can receive an
  34.                    updated and enhanced version of it by sending
  35.                    $9.50 + 4% local taxes + $2.00 shipping for
  36.                    a total of $11.88 to the adress above.
  37. ___________________________________________________________________________
  38.  
  39.          THIS SOFTWARE AND MANUAL ARE SOLD "AS IS" AND WITHOUT WAR-
  40.          RANTIES AS TO PERFORMANCE OR MERCHANTABILITY. THE SELLER'S
  41.          SALESPERSONS MAY HAVE MADE STATEMENTS ABOUT THIS SOFTWARE.
  42.          ANY SUCH STATEMENTS DO NOT CONSTITUTE WARRANTIES AND SHALL
  43.          NOT BE RELIED ON BY THE BUYER IN DECIDING WHETHER TO PUR-
  44.          CHASE THIS PROGRAM
  45.  
  46.          THIS PROGRAM IS SOLD WITHOUT ANY EXPRESS OR IMPLIED WARRAN-
  47.          TIES WHATSOEVER. BECAUSE OF THE DIVERSITY OF CONDITIONS AND
  48.          HARDWARE UNDER WHICH THIS PROGRAM MAY BE USED, NO WARRANTY
  49.          OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. THE USER IS
  50.          ADVISED TO TEST THE PROGRAM THOROUGHLY BEFORE RELYING ON IT.
  51.          THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.
  52.          ANY LIABILITY OF SELLER OR MANUFACTURER WILL BE LIMITED EX-
  53.          CLUSEVELY TO PRODUCT REPLACEMENT OR REFUND OF THE PURCHASE
  54.          PRICE.
  55.  
  56. 
  57.  
  58. GENERAL DESCRIPTION
  59.  
  60. The three companion programs :
  61.  
  62.                         TEST1.COM     ( testing program )
  63.                         TRAIN1.COM    ( training program )
  64.                         TESTEST1.COM  ( debugger, an aid in designing tests )
  65.  
  66. Have a common purpose : to facilitate learning and keep score of 
  67. the progress.      
  68.  
  69.  
  70.                                TRAIN1.COM
  71.  
  72. This training engine "runs" training material that you can easily prepare
  73. with any word processor.
  74.  
  75. The program will display your questions, accept valid answers and reject
  76. inappropriate ones, show the correct answer with an optional comment when
  77. the answer is incorrect, put incorrectly answered questions on hold and
  78. present them again until the correct answer is givern, keep score of points
  79. associated with correct answers as well as the number of times that an
  80. incorrect answer was entered.
  81.  
  82.  
  83.                                TEST1.COM
  84.  
  85. This testing engine "runs" testing material that you can easily prepare
  86. with any word processor.
  87.  
  88. Questions can have different formats ( Yes/No, True/False, 1/2/3, A/B/C/D/E 
  89. and Notices ) that can be freely mixed within the test file.
  90.  
  91. All questions can be put on hold an indefinite number of times, and will be
  92. presented again in the same order as they were encountered.
  93.  
  94. At the end of the test the program will display an optional evaluation,
  95. and store the results in a permanent file on your disk.
  96.  
  97.  
  98.                              TESTEST1.COM
  99.  
  100. This program is a "debugger" to assist you in preparing correct files for
  101. the other programs.
  102.  
  103. 
  104.  
  105.  
  106. HOW TO GET STARTED
  107.  
  108.       
  109. On your printer, print out the files :
  110.                         doc.tst
  111.                         demo.tst
  112.                         sample.tst
  113.  
  114. And then call up the TRAIN1.COM program by entering :
  115.                         TRAIN1
  116.  
  117. When asked for a file name, enter either DOC  ( Try this one first )
  118.                                      or  DEMO
  119.                                      or  SAMPLE
  120. ( do not enter the .TST extension. )
  121.  
  122. In answering questions give also incorrect answers, to see what happens.
  123. A permanent record of the session will remain on your current disk,
  124. in the form of a file whose name is composed by:
  125.  
  126.                     The first 6 letters of your last name,
  127.                     the initial of your first name,
  128.                     your middle initial,
  129.                     plus the extension .RES   ( for RESults )
  130.  For example,
  131.  
  132.                     last name => Lendaro
  133.                     middle in.=> G
  134.                     first     => Frank
  135.  
  136. will create a file named  LENDARFG.RES  in which the results will be stored.
  137.  
  138. If you last name is shorther than six letters, part of your first name
  139. will be used. If no name is given, the file will be named NONAME.RES.
  140.  
  141. To see that the file is there,     type DIR to see all the files in that 
  142. directory, or better yet           type DIR *.RES to see only result files.
  143. To see what is in it, you would type :
  144.  
  145.                           TYPE LENDARFG.RES
  146.  
  147. Note : The program will overwrite a file by the same name, so if you wish to
  148. take more than one test and keep a record of each, change something in your
  149. name. For example, instead of entering your middle initial, enter 1 the 
  150. first time, 2 the second, etc..( The updated version does this automatically.)
  151. 
  152. HOW TO PREPARE A TEST
  153.  
  154. Use any editor or word processor;
  155. Name the file with an extension of .tst ( Example math.tst or hist_01.tst ); 
  156. Store the file as an ASCII file. ( That means no printer control characters ). 
  157.  
  158. RESERVED CHARACTERS
  159.  
  160. The following characters cannot be used as the first character of a line
  161. in a test file, except for control purposes :
  162.  
  163. {   This  bracket means that two numbers follow : the limits for the 
  164.     evaluation. For example, if you want the evaluation to show when the 
  165.     score is between 10 and 30 (included) than it would look like : 
  166.  
  167.                               { 10 30 }
  168.       
  169.     You can have as many evaluation sections as you want, but only one
  170.     will show : the first one that matches the score. All others will
  171.     be ignored.
  172.  
  173. =   The equal sign means that the evaluation message is over. Use a series
  174.     of them to visually separate evaluations.
  175.     The evaluation section should be at the very top of the test file.
  176.     ===================================================================
  177.  
  178. (   Means that the question number, the correct answer and the point value 
  179.     follow, each separated from the other by a blank space and at the end
  180.     by ) . For example, to indicate question 2, a yes or no question whose
  181.     correct answer is Yes and that has a point value of 1 when answered
  182.     correctly, we would start the line as follows :
  183.                      
  184.                             ( 2 Y 1 )
  185.  
  186.     and the body of the question will begin one line below.
  187.  
  188.     Notice that the blank spaces ( delimiters ) are essential.
  189.  
  190. .  The period as the first character on a line means that the question 
  191.    is over. A series of periods can make the test file more readeable.
  192.    .....................................................................
  193.  
  194. +  The plus sign means that the optional comment section ( that would show 
  195.    only if you are using the TRAIN1 program and the answer is incorrect; )
  196.    is over. You can use a series of them.
  197.    ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  198.  
  199. -  The minus sign means that the test is over with. It has to be present.
  200.    ----------------------------------------------------------------------
  201.  
  202. ~  This character is used by the program to mark files that contain hold 
  203.    questions. Do not use as the first character of a line.
  204.  
  205. 
  206.  
  207. TYPES OF QUESTION SUPPORTED
  208.  
  209. The following types of question are supported, and can be freely mixed
  210. within the same test :
  211.  
  212.                        Y(es) or N(o)
  213.                        T(rue) or F(alse)
  214.                        1, 2 or 3
  215.                        A, B, C, D or E
  216.  
  217.                        Notices, no score.
  218.  
  219. The prompt will automatically adjust to accept only the valid answers.
  220.  
  221. Only ONE ANSWER can be assigned a point value.
  222.  
  223.  
  224.  
  225. HOW TO STOP A PROGRAM
  226.  
  227. If you are running TRAIN1.COM or TESTEST1.COM you can stop the program
  228. with control-C or Break at any time.
  229.  
  230. If you are running TEST1, you CANNOT STOP before the test is over,
  231. short of turning off the machine.
  232. This is a security feature to prevent the test taker from stopping the 
  233. testing process, calling up and reading the test file, and then resuming
  234. the testing.
  235. The updated version of the program includes  much better security, by
  236. encoding the test file to make it unreadeable, and then decoding it at
  237. testing time.                      
  238.  
  239. IF YOU HAVE PROBLEMS
  240.  
  241. If your test does not ran as it should, first run TESTEST1 on them.
  242. Make note of what question is causing the malfunction.
  243. Print out your test, and look at the offending question as well
  244. as the preceeding one.
  245. Compare them with the ones that work..... and you will have found 
  246. the problem.  If not, please LET ME KNOW.
  247.  
  248. Again : all reserved characters can be used anywhere EXCEPT
  249.         as the first character of a line.
  250.  
  251.         If the program does not seem to work properly, the cause is 
  252.         very likely to be a unintended reserved character somewhere. 
  253.  
  254. 
  255.  
  256.  
  257.  
  258.  
  259. _____________________________________________________________________________
  260.  
  261.                               UPDATE NOTICE
  262. _____________________________________________________________________________
  263.  
  264.  
  265.  
  266.  
  267. The updated version of these programs include :
  268.  
  269. - Automatic date/time stamp of results;
  270. - Timer that can be optionally enabled/disabled by the test file;
  271. - Check for duplication of the .REC file name and automatic modification;
  272. - A coding facility, that will encode the test file and make it 
  273.   unreadeable. The test program will decode it at run time.
  274.   This will prevent a test taker calling up the test file and reading it,
  275.   therefore gaining knowledge of the correct answers.
  276. - A security lock on the result file, to prevent tampering. 
  277.                                               
  278. And any other modifications based on your suggestions.
  279.  
  280. For the latest version on 5¼ disk, please send $ 9.50 + 4% local sales tax
  281. and $ 2.00 for shipping, for a total of $ 11.88 to the following adress :
  282.                            
  283.                     Frank Lendaro
  284.                     P.O.Box 1021
  285.                     Douglas, 99824
  286.                     
  287. Your comments and suggestions are appreciated.
  288.  
  289. Copyright 1987 Frank Lendaro all rights reserved.
  290. 
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.